{"id":34774908,"url":"https://github.com/cloudtruth/terraform-provider-cloudtruth","last_synced_at":"2025-12-25T08:13:57.474Z","repository":{"id":37246227,"uuid":"491146014","full_name":"cloudtruth/terraform-provider-cloudtruth","owner":"cloudtruth","description":"A terraform provider for CloudTruth","archived":false,"fork":false,"pushed_at":"2025-10-23T03:19:17.000Z","size":1971,"stargazers_count":3,"open_issues_count":5,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-10-23T03:24:54.716Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudtruth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-05-11T14:27:01.000Z","updated_at":"2025-10-22T19:45:46.000Z","dependencies_parsed_at":"2023-10-17T00:01:14.509Z","dependency_job_id":"64fae1f2-06c1-40db-bb55-246d1a1d4973","html_url":"https://github.com/cloudtruth/terraform-provider-cloudtruth","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/cloudtruth/terraform-provider-cloudtruth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudtruth%2Fterraform-provider-cloudtruth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudtruth%2Fterraform-provider-cloudtruth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudtruth%2Fterraform-provider-cloudtruth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudtruth%2Fterraform-provider-cloudtruth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudtruth","download_url":"https://codeload.github.com/cloudtruth/terraform-provider-cloudtruth/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudtruth%2Fterraform-provider-cloudtruth/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28024398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-25T08:13:55.661Z","updated_at":"2025-12-25T08:13:57.469Z","avatar_url":"https://github.com/cloudtruth.png","language":"Go","readme":"# CloudTruth by Sigma-Automate Terraform Provider\n\n[![Tests](https://github.com/cloudtruth/terraform-provider-cloudtruth/actions/workflows/test.yml/badge.svg)](https://github.com/cloudtruth/terraform-provider-cloudtruth/actions/workflows/test.yml)\n[![Release](https://img.shields.io/github/v/release/cloudtruth/terraform-provider-cloudtruth)](https://github.com/cloudtruth/terraform-provider-cloudtruth/releases)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\nThe official [Terraform](https://www.terraform.io/) provider for [CloudTruth by Sigma-Automate](https://cloudtruth.com/). Manage your CloudTruth configuration as code, enabling infrastructure as code practices for your application configuration and secrets management.\n\n## Features\n\n- **Projects \u0026 Environments**: Organize configuration with hierarchical projects and environments\n- **Parameters \u0026 Values**: Manage configuration parameters with environment-specific values\n- **Templates**: Create dynamic configuration templates using CloudTruth parameters\n- **Type Validation**: Define custom parameter types with validation rules\n- **Access Control**: Manage user groups and access grants\n- **Integrations**: Configure AWS and Azure Key Vault integrations for secrets sync\n- **Tags**: Version your configuration with environment tags\n\n## Requirements\n\n- [Terraform](https://www.terraform.io/downloads.html) \u003e= 1.3\n- [Go](https://golang.org/doc/install) \u003e= 1.21 (for development)\n- [CloudTruth Account](https://app.cloudtruth.com/) and API key\n\n## Installation\n\n### Terraform Registry (Recommended)\n\nThe provider is available on the [Terraform Registry](https://registry.terraform.io/providers/cloudtruth/cloudtruth/latest). Add it to your Terraform configuration:\n\n```hcl\nterraform {\n  required_providers {\n    cloudtruth = {\n      source  = \"cloudtruth/cloudtruth\"\n      version = \"~\u003e 0.9.0\"  # Check for latest version\n    }\n  }\n}\n\nprovider \"cloudtruth\" {\n  api_key = var.cloudtruth_api_key  # Or use CLOUDTRUTH_API_KEY env var\n}\n```\n\n### Local Installation (Development)\n\n```bash\ngit clone https://github.com/cloudtruth/terraform-provider-cloudtruth.git\ncd terraform-provider-cloudtruth\nmake build\n```\n\n## Quick Start\n\n### 1. Get Your API Key\n\nGenerate an API key from the [CloudTruth dashboard](https://app.cloudtruth.com/).\n\n### 2. Configure the Provider\n\n```hcl\n# Set via environment variable (recommended):\n# export CLOUDTRUTH_API_KEY=your-api-key-here\n\nprovider \"cloudtruth\" {\n  # api_key is optional if CLOUDTRUTH_API_KEY is set\n}\n```\n\n### 3. Create Resources\n\n```hcl\n# Create a project\nresource \"cloudtruth_project\" \"app\" {\n  name        = \"my-application\"\n  description = \"Application configuration\"\n}\n\n# Create a parameter\nresource \"cloudtruth_parameter\" \"database_url\" {\n  name    = \"DATABASE_URL\"\n  project = cloudtruth_project.app.name\n  secret  = true\n}\n\n# Set environment-specific values\nresource \"cloudtruth_parameter_value\" \"db_url_dev\" {\n  parameter_name = cloudtruth_parameter.database_url.name\n  project        = cloudtruth_project.app.name\n  environment    = \"development\"\n  value          = \"postgresql://localhost:5432/myapp_dev\"\n}\n\nresource \"cloudtruth_parameter_value\" \"db_url_prod\" {\n  parameter_name = cloudtruth_parameter.database_url.name\n  project        = cloudtruth_project.app.name\n  environment    = \"production\"\n  value          = \"postgresql://prod.example.com:5432/myapp\"\n}\n```\n\n## Documentation\n\n- **[Provider Documentation](https://registry.terraform.io/providers/cloudtruth/cloudtruth/latest/docs)** - Complete reference for all resources and data sources\n- **[CloudTruth Documentation](https://docs.cloudtruth.com/)** - Learn about CloudTruth concepts and features\n- **[Examples](./examples/)** - Example configurations for common use cases\n\n### Available Resources\n\n- `cloudtruth_project` - Configuration projects with inheritance\n- `cloudtruth_environment` - Deployment environments\n- `cloudtruth_parameter` - Configuration parameters\n- `cloudtruth_parameter_value` - Environment-specific parameter values\n- `cloudtruth_template` - Dynamic configuration templates\n- `cloudtruth_type` - Custom parameter types with validation\n- `cloudtruth_tag` - Environment tags for versioning\n- `cloudtruth_group` - User groups\n- `cloudtruth_access_grant` - Access control grants\n- `cloudtruth_aws_integration` - AWS integrations\n- `cloudtruth_aws_import_action` - AWS import actions\n- `cloudtruth_aws_push_action` - AWS push actions\n- `cloudtruth_azure_integration` - Azure Key Vault integrations\n- `cloudtruth_azure_import_action` - Azure import actions\n- `cloudtruth_azure_push_action` - Azure push actions\n\n### Available Data Sources\n\n- `cloudtruth_parameter_value` - Read parameter values\n- `cloudtruth_parameter_values` - Read multiple parameter values\n- `cloudtruth_template` - Read template content\n- `cloudtruth_templates` - List templates\n- `cloudtruth_tag` - Read tag information\n- `cloudtruth_user` - Read user information\n- `cloudtruth_users` - List users\n\n## Development\n\n### Building the Provider\n\n```bash\nmake build\n```\n\n### Running Tests\n\n```bash\n# Unit tests\nmake test\n\n# Acceptance tests (requires CloudTruth credentials)\nexport CLOUDTRUTH_API_KEY=your-test-api-key\nexport CLOUDTRUTH_PROJECT=AcceptanceTest\nmake testacc\n```\n\n### Code Quality\n\n```bash\nmake fmt       # Format code\nmake fmtcheck  # Check formatting\nmake lint      # Run linters\nmake vet       # Run go vet\n```\n\n### Generating Documentation\n\n```bash\ngo run github.com/hashicorp/terraform-plugin-docs/cmd/tfplugindocs\n```\n\n### Regenerating API Client\n\nThe OpenAPI client is auto-generated. To regenerate from the latest API spec:\n\n```bash\nmake client\n```\n\n## Contributing\n\nWe welcome contributions! Please see our contributing guidelines for details on:\n\n- Reporting bugs\n- Suggesting enhancements\n- Submitting pull requests\n\n### Pull Request Process\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run tests and linters (`make test`, `make lint`)\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to your branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n### Development Setup\n\n```bash\n# Clone your fork\ngit clone https://github.com/YOUR-USERNAME/terraform-provider-cloudtruth.git\ncd terraform-provider-cloudtruth\n\n# Install dependencies\ngo mod download\n\n# Run tests\nmake test\n```\n\n## Support\n\n- **Documentation**: [docs.cloudtruth.com](https://docs.cloudtruth.com/)\n- **Issues**: [GitHub Issues](https://github.com/cloudtruth/terraform-provider-cloudtruth/issues)\n- **Email**: support@cloudtruth.com\n\n## Security\n\nFor security concerns, please email security@cloudtruth.com instead of using the public issue tracker.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## About CloudTruth by Sigma-Automate\n\n[CloudTruth by Sigma-Automate](https://cloudtruth.com/) is a universal configuration and secrets management platform that helps teams:\n\n- Centralize configuration across all environments\n- Eliminate configuration drift and errors\n- Integrate with existing tools and workflows\n- Maintain audit trails and access controls\n- Sync secrets with AWS, Azure, and other platforms\n\nCloudTruth is now part of [Sigma-Automate](https://sigma-automate.com/), bringing together best-in-class configuration management with enterprise automation solutions.\n\nLearn more at [cloudtruth.com](https://cloudtruth.com/) or try it free at [app.cloudtruth.com](https://app.cloudtruth.com/).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudtruth%2Fterraform-provider-cloudtruth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudtruth%2Fterraform-provider-cloudtruth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudtruth%2Fterraform-provider-cloudtruth/lists"}