|
| 1 | +## [Smurf Terraform Checks Workflow](https://github.com/clouddrove/github-shared-workflows/blob/master/.github/workflows/tf-checks.yml) |
| 2 | + |
| 3 | +This workflow automates smurf terraform checks including format, init, validate, and optionally plan and version compatibility testing. It utilizes the workflows defined in `.github/workflows/stf-checks.yml` |
| 4 | + |
| 5 | +### Features |
| 6 | + |
| 7 | +- ✅ Format checking |
| 8 | +- ✅ Terraform init and validate |
| 9 | +- ✅ Optional terraform plan |
| 10 | +- ✅ Optional min/max version compatibility testing |
| 11 | +- ✅ Support for AWS, Azure, GCP, and DigitalOcean |
| 12 | +- ✅ Configurable working directory and terraform version |
| 13 | + |
| 14 | +### Usage |
| 15 | + |
| 16 | +#### Basic Usage (Format, Init, Validate) |
| 17 | + |
| 18 | +```yaml |
| 19 | +name: Terraform Checks |
| 20 | +on: |
| 21 | + push: |
| 22 | + branches: [ master ] |
| 23 | + pull_request: |
| 24 | + |
| 25 | +jobs: |
| 26 | + terraform-checks: |
| 27 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 28 | + with: |
| 29 | + working_directory: './examples/complete/' |
| 30 | + provider: 'azurerm' |
| 31 | + secrets: |
| 32 | + AZURE_CREDENTIALS: ${{ secrets.AZURE_CREDENTIALS }} |
| 33 | +``` |
| 34 | +
|
| 35 | +#### With smurf stf Plan |
| 36 | +
|
| 37 | +```yaml |
| 38 | +name: Smurf Terraform Checks with Plan |
| 39 | +on: |
| 40 | + push: |
| 41 | + branches: [ master ] |
| 42 | + |
| 43 | +jobs: |
| 44 | + terraform-checks: |
| 45 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 46 | + with: |
| 47 | + working_directory: './examples/complete/' |
| 48 | + provider: 'aws' |
| 49 | + enable_plan: true |
| 50 | + var_file: 'vars/dev.tfvars' |
| 51 | + aws_region: 'us-east-1' |
| 52 | + secrets: |
| 53 | + AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }} |
| 54 | + AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }} |
| 55 | + GITHUB: ${{ secrets.GITHUB }} |
| 56 | + TF_API_TOKEN: ${{ secrets.TF_API_TOKEN }} |
| 57 | +``` |
| 58 | +
|
| 59 | +#### With Version Compatibility Testing |
| 60 | +
|
| 61 | +```yaml |
| 62 | +name: Terraform Version Checks |
| 63 | +on: |
| 64 | + push: |
| 65 | + branches: [ master ] |
| 66 | + |
| 67 | +jobs: |
| 68 | + terraform-checks: |
| 69 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 70 | + with: |
| 71 | + working_directory: './examples/complete/' |
| 72 | + provider: 'aws' |
| 73 | + enable_version_check: true |
| 74 | + aws_region: 'us-east-1' |
| 75 | + secrets: |
| 76 | + AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }} |
| 77 | + AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }} |
| 78 | + BUILD_ROLE: ${{ secrets.BUILD_ROLE }} |
| 79 | +``` |
| 80 | +
|
| 81 | +### Example for smurf terraform checks with azure cloud |
| 82 | +
|
| 83 | +```yaml |
| 84 | +name: Terraform Checks Azure |
| 85 | +on: |
| 86 | + push: |
| 87 | + branches: [ master ] |
| 88 | + |
| 89 | +jobs: |
| 90 | + terraform-checks: |
| 91 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 92 | + with: |
| 93 | + working_directory: './examples/complete/' |
| 94 | + provider: 'azurerm' |
| 95 | + enable_plan: true |
| 96 | + secrets: |
| 97 | + AZURE_CREDENTIALS: ${{ secrets.AZURE_CREDENTIALS }} |
| 98 | + GITHUB: ${{ secrets.GITHUB }} |
| 99 | +``` |
| 100 | +
|
| 101 | +### Example for smurf terraform checks with aws cloud |
| 102 | +
|
| 103 | +```yaml |
| 104 | +name: Smurf Terraform Checks AWS |
| 105 | +on: |
| 106 | + push: |
| 107 | + branches: [ master ] |
| 108 | + |
| 109 | +jobs: |
| 110 | + terraform-checks: |
| 111 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 112 | + with: |
| 113 | + working_directory: './examples/complete/' |
| 114 | + provider: 'aws' |
| 115 | + enable_plan: true |
| 116 | + aws_region: 'us-east-1' |
| 117 | + secrets: |
| 118 | + AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }} |
| 119 | + AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }} |
| 120 | + BUILD_ROLE: ${{ secrets.BUILD_ROLE }} |
| 121 | + GITHUB: ${{ secrets.GITHUB }} |
| 122 | +``` |
| 123 | +
|
| 124 | +### Example for smurf terraform checks with digitalocean cloud |
| 125 | +
|
| 126 | +```yaml |
| 127 | +name: Terraform Checks DigitalOcean |
| 128 | +on: |
| 129 | + push: |
| 130 | + branches: [ master ] |
| 131 | + |
| 132 | +jobs: |
| 133 | + terraform-checks: |
| 134 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 135 | + with: |
| 136 | + working_directory: './examples/complete/' |
| 137 | + provider: 'digitalocean' |
| 138 | + secrets: |
| 139 | + DIGITALOCEAN_ACCESS_TOKEN: ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }} |
| 140 | + GITHUB: ${{ secrets.GITHUB }} |
| 141 | +``` |
| 142 | +
|
| 143 | +### Example for smurf terraform checks with GCP cloud |
| 144 | +
|
| 145 | +```yaml |
| 146 | +name: Terraform Checks GCP |
| 147 | +on: |
| 148 | + push: |
| 149 | + branches: [ master ] |
| 150 | + |
| 151 | +jobs: |
| 152 | + terraform-checks: |
| 153 | + uses: clouddrove/github-shared-workflows/.github/workflows/stf-checks.yml@master |
| 154 | + with: |
| 155 | + working_directory: './examples/complete/' |
| 156 | + provider: 'gcp' |
| 157 | + enable_version_check: true |
| 158 | + project_id: 'my-gcp-project' |
| 159 | + secrets: |
| 160 | + GCP_CREDENTIALS: ${{ secrets.GCP_CREDENTIALS }} |
| 161 | + WORKLOAD_IDENTITY_PROVIDER: ${{ secrets.WORKLOAD_IDENTITY_PROVIDER }} |
| 162 | + SERVICE_ACCOUNT: ${{ secrets.SERVICE_ACCOUNT }} |
| 163 | +``` |
| 164 | +
|
| 165 | +### Input Parameters |
| 166 | +
|
| 167 | +| Parameter | Required | Default | Description | |
| 168 | +|-----------|----------|---------|-------------| |
| 169 | +| `working_directory` | No | `'./examples/complete/'` | Directory where terraform code exists | |
| 170 | +| `provider` | No | `azurerm` | Cloud provider: `azurerm`, `aws`, `gcp`, or `digitalocean` | |
| 171 | +| `aws_region` | No | `us-east-1` | AWS region for deployment | |
| 172 | +| `var_file` | No | `""` | Terraform var file directory (e.g., `vars/dev.tfvars`) | |
| 173 | +| `terraform_version` | No | Latest | Specific Terraform version to use | |
| 174 | +| `enable_version_check` | No | `false` | Enable min/max version compatibility testing | |
| 175 | +| `enable_plan` | No | `false` | Enable terraform plan step | |
| 176 | +| `role_duration_seconds` | No | `3600` | AWS role duration in seconds (900-43200) | |
| 177 | +| `project_id` | No | - | GCP project ID | |
| 178 | +| `token_format` | No | `access_token` | GCP token format (`access_token` or `id_token`) | |
| 179 | +| `access_token_lifetime` | No | `300s` | GCP access token lifetime | |
| 180 | +| `create_credentials_file` | No | `true` | Create GCP credentials file | |
| 181 | + |
| 182 | +### Secrets |
| 183 | + |
| 184 | +| Secret | Required | Description | |
| 185 | +|--------|----------|-------------| |
| 186 | +| `AZURE_CREDENTIALS` | No | Azure credentials JSON | |
| 187 | +| `AWS_ACCESS_KEY_ID` | No | AWS access key ID | |
| 188 | +| `AWS_SECRET_ACCESS_KEY` | No | AWS secret access key | |
| 189 | +| `AWS_SESSION_TOKEN` | No | AWS session token | |
| 190 | +| `BUILD_ROLE` | No | AWS OIDC role ARN | |
| 191 | +| `DIGITALOCEAN_ACCESS_TOKEN` | No | DigitalOcean access token | |
| 192 | +| `GITHUB` | No | GitHub PAT token | |
| 193 | +| `TF_API_TOKEN` | No | Terraform Cloud API token | |
| 194 | +| `GCP_CREDENTIALS` | No | GCP service account key JSON | |
| 195 | +| `WORKLOAD_IDENTITY_PROVIDER` | No | GCP Workload Identity Provider | |
| 196 | +| `SERVICE_ACCOUNT` | No | GCP service account email | |
0 commit comments