Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kreuzwerker/terraform-provider-docker
Terraform Docker provider
https://github.com/kreuzwerker/terraform-provider-docker
docker golang hacktoberfest terraform-provider
Last synced: 7 days ago
JSON representation
Terraform Docker provider
- Host: GitHub
- URL: https://github.com/kreuzwerker/terraform-provider-docker
- Owner: kreuzwerker
- License: mpl-2.0
- Created: 2020-11-06T12:50:09.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T20:34:21.000Z (8 days ago)
- Last Synced: 2024-10-30T21:27:20.853Z (8 days ago)
- Topics: docker, golang, hacktoberfest, terraform-provider
- Language: Go
- Homepage:
- Size: 9.78 MB
- Stars: 620
- Watchers: 11
- Forks: 188
- Open Issues: 150
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
- awesome-tf - terraform-provider-docker - Terraform Docker provider. (Providers / Community providers)
README
# Terraform Provider for Docker
[](https://github.com/kreuzwerker/terraform-provider-docker/releases)
[](https://registry.terraform.io/providers/kreuzwerker/docker)
[](https://registry.terraform.io/providers/kreuzwerker/docker/latest/docs)
[](https://github.com/kreuzwerker/terraform-provider-docker/blob/main/LICENSE)
[](https://github.com/kreuzwerker/terraform-provider-docker/actions)
[](https://github.com/kreuzwerker/terraform-provider-docker/actions)
[](https://goreportcard.com/report/github.com/kreuzwerker/terraform-provider-docker)
## Documentation
The documentation for the provider is available on the [Terraform Registry](https://registry.terraform.io/providers/kreuzwerker/docker/latest/docs).
Do you want to migrate from `v2.x` to `v3.x`? Please read the [migration guide](docs/v2_v3_migration.md)
## Example usage
Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/3.0.2/docs) of the registry
or use the following example:
```hcl
# Set the required provider and versions
terraform {
required_providers {
# We recommend pinning to the specific version of the Docker Provider you're using
# since new versions are released frequently
docker = {
source = "kreuzwerker/docker"
version = "3.0.2"
}
}
}
# Configure the docker provider
provider "docker" {
}
# Create a docker image resource
# -> docker pull nginx:latest
resource "docker_image" "nginx" {
name = "nginx:latest"
keep_locally = true
}
# Create a docker container resource
# -> same as 'docker run --name nginx -p8080:80 -d nginx:latest'
resource "docker_container" "nginx" {
name = "nginx"
image = docker_image.nginx.image_id
ports {
external = 8080
internal = 80
}
}
# Or create a service resource
# -> same as 'docker service create -d -p 8081:80 --name nginx-service --replicas 2 nginx:latest'
resource "docker_service" "nginx_service" {
name = "nginx-service"
task_spec {
container_spec {
image = docker_image.nginx.repo_digest
}
}
mode {
replicated {
replicas = 2
}
}
endpoint_spec {
ports {
published_port = 8081
target_port = 80
}
}
}
```
## Building The Provider
[Go](https://golang.org/doc/install) 1.18.x (to build the provider plugin)
```sh
$ git clone [email protected]:kreuzwerker/terraform-provider-docker
$ make build
```
## Contributing
The Terraform Docker Provider is the work of many of contributors. We appreciate your help!
To contribute, please read the contribution guidelines: [Contributing to Terraform - Docker Provider](CONTRIBUTING.md)
## License
The Terraform Provider Docker is available to everyone under the terms of the Mozilla Public License Version 2.0. [Take a look the LICENSE file](LICENSE).
## Stargazers over time
[](https://starchart.cc/kreuzwerker/terraform-provider-docker)