{"id":49339775,"url":"https://github.com/citadel-cloud-management/terraform-aws-amazon-q-developer","last_synced_at":"2026-04-27T03:04:33.094Z","repository":{"id":344654049,"uuid":"1175667451","full_name":"Citadel-Cloud-Management/terraform-aws-amazon-q-developer","owner":"Citadel-Cloud-Management","description":"Terraform module for Amazon Q Developer with CodeBuild integration and code review automation","archived":false,"fork":false,"pushed_at":"2026-04-11T22:20:39.000Z","size":24,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-12T00:34:32.902Z","etag":null,"topics":["amazon-q","aws","ci-cd","code-review","codebuild","codepipeline","devops","iac","infrastructure-as-code","production-ready","security-scanning","terraform","terraform-module"],"latest_commit_sha":null,"homepage":"https://citadel-cloud-management.github.io/terraform-aws-amazon-q-developer/","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Citadel-Cloud-Management.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","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":"2026-03-08T02:16:51.000Z","updated_at":"2026-04-11T22:39:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Citadel-Cloud-Management/terraform-aws-amazon-q-developer","commit_stats":null,"previous_names":["kogunlowo123/terraform-aws-amazon-q-developer","citadel-cloud-management/terraform-aws-amazon-q-developer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Citadel-Cloud-Management/terraform-aws-amazon-q-developer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fterraform-aws-amazon-q-developer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fterraform-aws-amazon-q-developer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fterraform-aws-amazon-q-developer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fterraform-aws-amazon-q-developer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Citadel-Cloud-Management","download_url":"https://codeload.github.com/Citadel-Cloud-Management/terraform-aws-amazon-q-developer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fterraform-aws-amazon-q-developer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32320688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"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":["amazon-q","aws","ci-cd","code-review","codebuild","codepipeline","devops","iac","infrastructure-as-code","production-ready","security-scanning","terraform","terraform-module"],"created_at":"2026-04-27T03:04:15.569Z","updated_at":"2026-04-27T03:04:33.080Z","avatar_url":"https://github.com/Citadel-Cloud-Management.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# terraform-aws-amazon-q-developer\n\nAWS Amazon Q Developer infrastructure module providing an AI-powered code assistant platform with CI/CD pipeline integration, automated code reviews via CodeGuru Reviewer, security scanning, and package management through CodeArtifact. This module provisions a complete developer productivity platform on AWS.\n\n## Architecture\n\n```mermaid\ngraph TB\n    subgraph Source[\"Source Control\"]\n        style Source fill:#24292e,stroke:#1b1f23,color:#ffffff\n        Repo[\"Repository\"]\n        Connection[\"CodeStar Connection\"]\n    end\n\n    subgraph Pipeline[\"CI/CD Pipeline\"]\n        style Pipeline fill:#1a73e8,stroke:#0d47a1,color:#ffffff\n        CP[\"CodePipeline\"]\n        SourceStage[\"Source Stage\"]\n        BuildStage[\"Build Stage\"]\n        CustomStages[\"Custom Stages\"]\n    end\n\n    subgraph Build[\"Build \u0026 Test\"]\n        style Build fill:#34a853,stroke:#1b5e20,color:#ffffff\n        CB[\"CodeBuild Project\"]\n        BuildSpec[\"BuildSpec\"]\n        Tests[\"Test Reports\"]\n        SecScan[\"Security Scanning\"]\n    end\n\n    subgraph CodeReview[\"Code Quality\"]\n        style CodeReview fill:#9c27b0,stroke:#4a148c,color:#ffffff\n        CGR[\"CodeGuru Reviewer\"]\n        SecFindings[\"Security Findings\"]\n    end\n\n    subgraph Packages[\"Package Management\"]\n        style Packages fill:#ff6d00,stroke:#e65100,color:#ffffff\n        CADomain[\"CodeArtifact Domain\"]\n        CARepo[\"CodeArtifact Repository\"]\n        Upstream[\"npm Upstream Proxy\"]\n    end\n\n    subgraph Storage[\"Artifacts \u0026 Encryption\"]\n        style Storage fill:#607d8b,stroke:#37474f,color:#ffffff\n        S3[\"S3 Artifact Bucket\"]\n        KMS[\"KMS Encryption Key\"]\n    end\n\n    subgraph Notifications[\"Notifications \u0026 Logging\"]\n        style Notifications fill:#d32f2f,stroke:#b71c1c,color:#ffffff\n        SNS[\"SNS Topic\"]\n        Email[\"Email Subscriptions\"]\n        CWLogs[\"CloudWatch Logs\"]\n        NotifRule[\"Notification Rules\"]\n    end\n\n    subgraph IAM[\"Security \u0026 Access\"]\n        style IAM fill:#f9a825,stroke:#f57f17,color:#000000\n        CBRole[\"CodeBuild Role\"]\n        CPRole[\"CodePipeline Role\"]\n    end\n\n    Repo --\u003e Connection\n    Connection --\u003e SourceStage\n    SourceStage --\u003e CP\n    CP --\u003e BuildStage\n    BuildStage --\u003e CB\n    CB --\u003e BuildSpec\n    BuildSpec --\u003e Tests\n    BuildSpec --\u003e SecScan\n    CP --\u003e CustomStages\n    CGR --\u003e Repo\n    CB --\u003e CARepo\n    CADomain --\u003e CARepo\n    Upstream --\u003e CARepo\n    CB --\u003e S3\n    CP --\u003e S3\n    KMS --\u003e S3\n    CP --\u003e NotifRule\n    CB --\u003e NotifRule\n    NotifRule --\u003e SNS\n    SNS --\u003e Email\n    CB --\u003e CWLogs\n    CBRole --\u003e CB\n    CPRole --\u003e CP\n```\n\n## Documentation\n\n- [Amazon Q Developer User Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/what-is.html)\n- [Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/welcome.html)\n- [Terraform aws_codebuild_project Resource](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/codebuild_project)\n- [AWS CodePipeline User Guide](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)\n- [AWS CodeArtifact User Guide](https://docs.aws.amazon.com/codeartifact/latest/ug/welcome.html)\n- [AWS CodeStar Connections](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections.html)\n\n## Prerequisites\n\n- Terraform \u003e= 1.5.0\n- AWS Provider \u003e= 5.40.0\n- AWS CLI configured with appropriate credentials\n- A source code repository on GitHub, GitLab, or Bitbucket\n- IAM permissions to create CodeBuild, CodePipeline, S3, KMS, SNS, IAM roles, and related resources\n- After deployment, the CodeStar Connection must be manually confirmed in the AWS Console (Settings \u003e Connections)\n\n## Deployment Guide\n\n### Step 1: Configure Backend (Optional)\n\n```hcl\nterraform {\n  backend \"s3\" {\n    bucket         = \"my-terraform-state\"\n    key            = \"amazon-q-developer/terraform.tfstate\"\n    region         = \"us-east-1\"\n    dynamodb_table = \"terraform-locks\"\n    encrypt        = true\n  }\n}\n```\n\n### Step 2: Create Variable Definitions\n\nCreate a `terraform.tfvars` file:\n\n```hcl\nproject_name     = \"my-app\"\nrepository_url   = \"my-org/my-repo\"\nsource_provider  = \"GitHub\"\nbranch_name      = \"main\"\nbuild_compute_type = \"BUILD_GENERAL1_MEDIUM\"\n\nenable_code_review       = true\nenable_security_scanning = true\n\ncodeartifact_domain = \"my-org-packages\"\n\nnotification_emails = [\n  \"dev-team@company.com\",\n  \"security@company.com\"\n]\n\ntags = {\n  Environment = \"production\"\n  Team        = \"engineering\"\n  ManagedBy   = \"terraform\"\n}\n```\n\n### Step 3: Initialize and Apply\n\n```bash\nterraform init\nterraform plan -out=tfplan\nterraform apply tfplan\n```\n\n### Step 4: Complete the CodeStar Connection\n\nAfter applying, the CodeStar Connection will be in `PENDING` status. Complete the handshake:\n\n```bash\n# Open the AWS Console and navigate to:\n# Developer Tools \u003e Settings \u003e Connections\n# Click on the pending connection and complete the authorization with your source provider\n```\n\nAlternatively, use the AWS CLI:\n\n```bash\naws codestar-connections list-connections --provider-type GitHub\n# Note the ConnectionArn, then complete in the Console\n```\n\n### Step 5: Trigger the Pipeline\n\n```bash\n# The pipeline will trigger automatically on the next push to the configured branch\n# To trigger manually:\naws codepipeline start-pipeline-execution --name my-app\n```\n\n### Step 6: Verify Build and Review\n\n```bash\n# Check pipeline status\naws codepipeline get-pipeline-state --name my-app\n\n# Check build logs\naws logs tail /aws/codebuild/my-app --follow\n\n# Check CodeGuru findings (if enabled)\naws codeguru-reviewer list-recommendations --repository-name my-app\n```\n\n## Inputs\n\n| Name | Description | Type | Default | Required |\n|------|-------------|------|---------|----------|\n| `project_name` | Name of the project, used as prefix for all resources | `string` | n/a | yes |\n| `repository_url` | URL/ID of the source code repository (e.g., org/repo) | `string` | n/a | yes |\n| `source_provider` | Source code provider (GitHub, GitLab, Bitbucket) | `string` | `\"GitHub\"` | no |\n| `branch_name` | Branch name to build from | `string` | `\"main\"` | no |\n| `build_compute_type` | CodeBuild compute type | `string` | `\"BUILD_GENERAL1_MEDIUM\"` | no |\n| `build_image` | Docker image for CodeBuild environment | `string` | `\"aws/codebuild/amazonlinux2-x86_64-standard:5.0\"` | no |\n| `enable_code_review` | Enable CodeGuru Reviewer for automated code reviews | `bool` | `true` | no |\n| `enable_security_scanning` | Enable security scanning in the build pipeline | `bool` | `true` | no |\n| `codeartifact_domain` | CodeArtifact domain name for package management | `string` | `\"\"` | no |\n| `pipeline_stages` | Additional pipeline stages beyond Source and Build | `list(object)` | `[]` | no |\n| `notification_emails` | Email addresses for pipeline notifications | `list(string)` | `[]` | no |\n| `encryption_key_arn` | ARN of existing KMS key (creates new if empty) | `string` | `\"\"` | no |\n| `tags` | Tags to apply to all resources | `map(string)` | `{}` | no |\n\n## Outputs\n\n| Name | Description |\n|------|-------------|\n| `codebuild_project_arn` | ARN of the CodeBuild project |\n| `codepipeline_arn` | ARN of the CodePipeline |\n| `codeartifact_domain_arn` | ARN of the CodeArtifact domain |\n| `codeartifact_repository_arn` | ARN of the CodeArtifact repository |\n| `codeguru_association_arn` | ARN of the CodeGuru Reviewer repository association |\n| `s3_artifact_bucket` | Name of the S3 artifact bucket |\n| `sns_topic_arn` | ARN of the SNS notification topic |\n| `connection_arn` | ARN of the CodeStar source connection |\n\n## Usage Example\n\n```hcl\nmodule \"q_developer\" {\n  source = \"github.com/kogunlowo123/terraform-aws-amazon-q-developer\"\n\n  project_name     = \"backend-api\"\n  repository_url   = \"my-org/backend-api\"\n  source_provider  = \"GitHub\"\n  branch_name      = \"main\"\n  build_compute_type = \"BUILD_GENERAL1_MEDIUM\"\n\n  enable_code_review       = true\n  enable_security_scanning = true\n  codeartifact_domain      = \"my-org\"\n\n  notification_emails = [\"engineering@company.com\"]\n\n  pipeline_stages = [\n    {\n      name = \"Deploy-Staging\"\n      actions = [\n        {\n          name             = \"DeployToStaging\"\n          category         = \"Deploy\"\n          provider         = \"CodeDeploy\"\n          input_artifacts  = [\"build_output\"]\n          configuration = {\n            ApplicationName     = \"backend-api\"\n            DeploymentGroupName = \"staging\"\n          }\n        }\n      ]\n    }\n  ]\n\n  tags = {\n    Environment = \"production\"\n    Service     = \"backend-api\"\n  }\n}\n\noutput \"pipeline_url\" {\n  value = \"https://console.aws.amazon.com/codesuite/codepipeline/pipelines/${module.q_developer.codepipeline_arn}/view\"\n}\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitadel-cloud-management%2Fterraform-aws-amazon-q-developer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcitadel-cloud-management%2Fterraform-aws-amazon-q-developer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitadel-cloud-management%2Fterraform-aws-amazon-q-developer/lists"}