Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zenika-open-source/terraform-azure-cli
Minimal & lightweight docker image including Azure and Terraform CLI
https://github.com/zenika-open-source/terraform-azure-cli
azure azure-cli azurecli docker docker-image dockerfile hacktoberfest terraform terraform-cli
Last synced: 4 days ago
JSON representation
Minimal & lightweight docker image including Azure and Terraform CLI
- Host: GitHub
- URL: https://github.com/zenika-open-source/terraform-azure-cli
- Owner: zenika-open-source
- License: apache-2.0
- Created: 2019-05-15T13:37:43.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-02T08:59:32.000Z (9 months ago)
- Last Synced: 2024-04-17T01:34:37.895Z (7 months ago)
- Topics: azure, azure-cli, azurecli, docker, docker-image, dockerfile, hacktoberfest, terraform, terraform-cli
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/zenika/terraform-azure-cli
- Size: 139 KB
- Stars: 33
- Watchers: 8
- Forks: 34
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Support: supported_versions.json
Awesome Lists containing this project
README
[](https://github.com/zenika-open-source/terraform-azure-cli/actions/workflows/lint-dockerfile.yml)
[](https://github.com/zenika-open-source/terraform-azure-cli/actions/workflows/build-test.yml)
[](https://github.com/zenika-open-source/terraform-azure-cli/actions/workflows/push-latest.yml)
[](https://github.com/zenika-open-source/terraform-azure-cli/actions/workflows/release.yml)
[](https://github.com/zenika-open-source/terraform-azure-cli/actions/workflows/dockerhub-description.yml)
[](https://opensource.org/licenses/Apache-2.0)
[](https://hub.docker.com/r/zenika/terraform-azure-cli/)
# Terraform and Azure CLI Docker image
## 📦 Supported tags and respective Dockerfile links
Available image tags can be found on the Docker Hub registry: [zenika/terraform-azure-cli](https://hub.docker.com/r/zenika/terraform-azure-cli/tags)
Supported versions are listed in the [`supported_versions.json` ](https://github.com/zenika-open-source/terraform-azure-cli/blob/master/supported_versions.json) file in project root folder.
The following image tag strategy is applied:
* `zenika/terraform-azure-cli:latest` - build from master
* Included CLI versions are the newest in the [`supported_versions.json` ](https://github.com/zenika-open-source/terraform-azure-cli/blob/master/supported_versions.json) file.
* `zenika/terraform-azure-cli:release-S.T_terraform-UU.VV.WW_azcli-XX.YY.ZZ` - build from releases
* `release-S.T` is the release tag
* `terraform-UU.VV.WWW` is the included **Terraform CLI** version
* `azcli-XX.YY.ZZ` is the included **Azure CLI** version
Please report to the [releases page](https://github.com/zenika-open-source/terraform-azure-cli/releases) for the changelogs.
> Any other tags are not supported even if available.
## 💡 Motivation
The goal is to create a **minimalist** and **lightweight** image with these tools in order to reduce network and storage impact.
This image gives you the flexibility to be used either for development or as a base image as you see fits.
## 🔧 What's inside ?
* [Azure CLI](https://docs.microsoft.com/cli/azure/?view=azure-cli-latest):
* [Terraform CLI](https://www.terraform.io/docs/commands/index.html):
* [Git](https://git-scm.com/)
* [Python 3](https://www.python.org/)
* This image use a non root user with a GID and UID of 1001 to conform with docker security best practices.
## 🚀 Usage
### 🐚 Launch the CLI
Simply launch the container and use the CLI as you would on any other platform, for instance using the latest image:
```bash
docker container run -it --rm --mount type=bind,source="$(pwd)",target=/workspace zenika/terraform-azure-cli:latest
```
> The `--rm` flag will completely destroy the container and its data on exit.
### ⚙️ Build the image
You can build the image locally directly from the Dockerfile, using the build script.
It will :
* Lint the Dockerfile with [Hadolint](https://github.com/hadolint/hadolint);
* Build and tag the image `zenika/terraform-azure-cli:dev`;
* Execute [container structure tests](https://github.com/GoogleContainerTools/container-structure-test) on the image.
```bash
# launch dev script using latest supported versions for both Azure and Terraform CLI
./dev.sh
```
Optionally, it is possible to choose the tools desired versions:
```bash
# Set desired tool versions
AZURE_CLI_VERSION=2.24.2
TERRAFORM_VERSION=0.15.5
# launch dev script with parameters
./dev.sh $AZURE_CLI_VERSION $TERRAFORM_VERSION
```
## 🙏 Roadmap & Contributions
Please refer to the [github project](https://github.com/zenika-open-source/terraform-azure-cli/projects/1) to track new features.
Do not hesitate to contribute by [filling an issue](https://github.com/zenika-open-source/terraform-azure-cli/issues/new) or [opening a PR](https://github.com/zenika-open-source/terraform-azure-cli/pulls) !
## ⬆️ Dependencies upgrades checklist
* Supported versions:
* check **Azure CLI** version on the [project release page](https://github.com/Azure/azure-cli/releases)
* check **Terraform CLI** version (keep all minor versions from 0.11) available on the [project release page](https://github.com/hashicorp/terraform/releases)
* Dockerfile:
* check **base image** version [on DockerHub](https://hub.docker.com/_/debian?tab=tags&page=1&name=bookworm)
* check **OS package** versions on Debian package repository
* Available **Git** versions on the [Debian Packages repository](https://packages.debian.org/search?suite=bookworm&arch=any&searchon=names&keywords=git)
* Available **Python** versions on the [Debian packages repository](https://packages.debian.org/search?suite=bookworm&arch=any&searchon=names&keywords=python3)
* same process for **all other packages**
* check **Pip package** versions on [pypi](https://pypi.org/)
* Github actions:
* check [runner version](https://github.com/actions/virtual-environments#available-environments)
* check **each action release** versions
* Build scripts:
* check **container tags**:
* [Hadolint releases](https://github.com/hadolint/hadolint/releases)
* [Container-structure-test](https://github.com/GoogleContainerTools/container-structure-test/releases)
* Readme:
* update version in code exemples
## 🚩 Similar repositories
* For AWS: [zenika-open-source/terraform-aws-cli](https://github.com/zenika-open-source/terraform-aws-cli)
## 📖 License
This project is under the [Apache License 2.0](https://github.com/zenika-open-source/terraform-azure-cli/blob/master/LICENSE)
[](https://oss.zenika.com)