{"id":19228579,"url":"https://github.com/zenika-open-source/terraform-aws-cli","last_synced_at":"2025-09-06T23:32:07.370Z","repository":{"id":42366597,"uuid":"189038175","full_name":"zenika-open-source/terraform-aws-cli","owner":"zenika-open-source","description":"Minimal \u0026 lightweight docker image including AWS and Terraform CLI","archived":false,"fork":false,"pushed_at":"2024-06-30T06:23:36.000Z","size":134,"stargazers_count":61,"open_issues_count":17,"forks_count":49,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-12-26T03:06:26.282Z","etag":null,"topics":["aws","aws-cli","awscli","docker","docker-image","dockerfiles","hacktoberfest","terraform","terraform-cli"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/zenika/terraform-aws-cli","language":"Roff","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/zenika-open-source.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security/awscli-exe-linux-x86_64-2.14.5.zip.sig","support":"supported_versions.json","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-28T13:52:49.000Z","updated_at":"2024-03-04T14:20:59.000Z","dependencies_parsed_at":"2024-11-09T15:30:35.744Z","dependency_job_id":"8b2f94bd-1a02-4ae2-adda-d1548675e8a4","html_url":"https://github.com/zenika-open-source/terraform-aws-cli","commit_stats":{"total_commits":57,"total_committers":13,"mean_commits":4.384615384615385,"dds":"0.45614035087719296","last_synced_commit":"bf62dd1c6bdf1bae2983d7efa5bad4d9c9268af5"},"previous_names":["zenika/terraform-aws-cli"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenika-open-source%2Fterraform-aws-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenika-open-source%2Fterraform-aws-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenika-open-source%2Fterraform-aws-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenika-open-source%2Fterraform-aws-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zenika-open-source","download_url":"https://codeload.github.com/zenika-open-source/terraform-aws-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232150013,"owners_count":18479565,"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","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":["aws","aws-cli","awscli","docker","docker-image","dockerfiles","hacktoberfest","terraform","terraform-cli"],"created_at":"2024-11-09T15:29:07.463Z","updated_at":"2025-01-02T04:07:36.900Z","avatar_url":"https://github.com/zenika-open-source.png","language":"Roff","readme":"[![lint-dockerfile](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/lint-dockerfile.yml/badge.svg)](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/lint-dockerfile.yml)\n[![build-test](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/build-test.yml/badge.svg)](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/build-test.yml)\n[![push-latest](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/push-latest.yml/badge.svg)](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/push-latest.yml)\n[![release](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/release.yml/badge.svg)](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/release.yml)\n\n[![dockerhub-description-update](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/dockerhub-description-update.yml/badge.svg)](https://github.com/zenika-open-source/terraform-aws-cli/actions/workflows/dockerhub-description-update.yml)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Docker Pulls](https://img.shields.io/docker/pulls/zenika/terraform-aws-cli.svg)](https://hub.docker.com/r/zenika/terraform-aws-cli/)\n\n# Terraform and AWS CLI Docker image\n\n## 📦 Supported tags and respective Dockerfile links\n\nAvailable image tags can be found on the Docker Hub registry: [zenika/terraform-aws-cli](https://hub.docker.com/r/zenika/terraform-aws-cli/tags)\n\nSupported versions are listed in the [`supported_versions.json`](https://github.com/Zenika/terraform-aws-cli/blob/master/supported_versions.json) file.\n\nThe following image tag strategy is applied:\n\n* `zenika/terraform-aws-cli:latest` - build from master\n  * Included CLI versions are the latest in [`supported_versions.json`](https://github.com/Zenika/terraform-aws-cli/blob/master/supported_versions.json) file.\n* `zenika/terraform-aws-cli:release-S.T_terraform-UU.VV.WW_awscli-XX.YY.ZZ` - build from releases\n  * `release-S.T` is the release tag\n  * `terraform-UU.VV.WWW` is the **Terraform** version included in the image\n  * `awscli-XX.YY.ZZ` is the **AWS CLI** version included in the image\n\nPlease report to the [releases page](https://github.com/Zenika/terraform-aws-cli/releases) for the changelogs.\n\n\u003e Any other tags are not supported even if available.\n\n## 💡 Motivation\n\nThe goal is to create a **minimalist** and **lightweight** image with these tools in order to reduce network and storage impact.\n\nThis image gives you the flexibility to be used for development or as a base image as you see fits.\n\n## 🔧 What's inside ?\n\nTools included:\n\n* [Terraform CLI](https://www.terraform.io/docs/commands/index.html)\n* [AWS CLI](https://aws.amazon.com/fr/cli/)\n* [Git](https://git-scm.com/) for Terraform remote module usage\n* [jq](https://stedolan.github.io/jq/) to process JSON returned by AWS\n* [OpenSSH Client](https://www.openssh.com/) to handle Terraform module clone over SSH\n* This image uses a non-root user with a UID and GID of 1001 to conform with docker security best practices.\n\n## 🚀 Usage\n\n### 🐚 Launch the CLI\n\nSet your AWS credentials (optional) and use the CLI as you would on any other platform, for instance using the latest image:\n\n```bash\necho AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY\necho AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY\necho AWS_DEFAULT_REGION=YOUR_DEFAULT_REGION\n\ndocker container run -it --rm -e \"AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}\" -e \"AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}\" -e \"AWS_DEFAULT_REGION=${AWS_DEFAULT_REGION}\" -v ${PWD}:/workspace zenika/terraform-aws-cli:latest\n```\n\n\u003e The `--rm` flag will completely destroy the container and its data on exit.\n\n### ⚙️ Build the image\n\nThe image can be built locally directly from the Dockerfiles, using the build script.\n\nIt will :\n\n* Lint the Dockerfile with [Hadolint](https://github.com/hadolint/hadolint);\n* Build and tag the image `zenika/terraform-aws-cli:dev`;\n* Execute [container structure tests](https://github.com/GoogleContainerTools/container-structure-test) on the image.\n\n```bash\n# launch build script\n./dev.sh\n```\n\nOptionally, it is possible to choose the tools desired versions :\n\n```bash\n# Set tools desired versions\nAWS_CLI_VERSION=2.12.6\nTERRAFORM_VERSION=1.5.2\n\n# launch the build script with parameters\n./dev.sh $AWS_CLI_VERSION $TERRAFORM_VERSION\n```\n\n## 🙏 Contributions\nDo not hesitate to contribute by [filling an issue](https://github.com/Zenika/terraform-aws-cli/issues) or [a PR](https://github.com/Zenika/terraform-aws-cli/pulls) !\n\n## 📚 Documentations\n\n* [Dependencies upgrades checklist](https://github.com/zenika-open-source/terraform-aws-cli/tree/master/docs/dependencies-upgrades.md)\n* [Binaries verifications](https://github.com/zenika-open-source/terraform-aws-cli/tree/master/docs/binaries-verifications.md)\n\n## 🚩 Similar repositories\n\n* For Azure: [zenika-open-source/terraform-azure-cli](https://github.com/zenika-open-source/terraform-azure-cli)\n\n## 📖 License\nThis project is under the [Apache License 2.0](https://raw.githubusercontent.com/Zenika/terraform-aws-cli/master/LICENSE)\n\n[![with love by zenika](https://img.shields.io/badge/With%20%E2%9D%A4%EF%B8%8F%20by-Zenika-b51432.svg)](https://oss.zenika.com)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenika-open-source%2Fterraform-aws-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzenika-open-source%2Fterraform-aws-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenika-open-source%2Fterraform-aws-cli/lists"}