forked from kreuzwerker/terraform-provider-docker
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
56cad47
commit c139056
Showing
7 changed files
with
211 additions
and
286 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,117 +1,17 @@ | ||
| <a href="https://docker.com"> | ||
| <img src="https://raw.githubusercontent.com/kreuzwerker/terraform-provider-docker/master/assets/docker-logo.png" alt="Docker logo" title="Docker" align="right" height="100" /> | ||
| </a> | ||
| <a href="https://terraform.io"> | ||
| <img src="https://raw.githubusercontent.com/kreuzwerker/terraform-provider-docker/master/assets/terraform-logo.png" alt="Terraform logo" title="Terraform" align="right" height="100" /> | ||
| </a> | ||
| <a href="https://kreuzwerker.de"> | ||
| <img src="https://raw.githubusercontent.com/kreuzwerker/terraform-provider-docker/master/assets/xw-logo.png" alt="Kreuzwerker logo" title="Kreuzwerker" align="right" height="100" /> | ||
| </a> | ||
| # SeatGeek Fork of kreuzwerker/docker | ||
|
|
||
| # Terraform Provider for Docker | ||
| This repo is a SeatGeek fork of the [kreuzwerker/docker](https://github.com/kreuzwerker/terraform-provider-docker), | ||
| the Terraform Docker Provider. It contains a [single PR](https://github.com/seatgeek/terraform-provider-docker/pull/1) | ||
| that has been [submitted](https://github.com/kreuzwerker/terraform-provider-docker/pull/565) to the source repo but has | ||
| not been looked at. | ||
|
|
||
| [](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) | ||
| The PR adds a `docker_registry_multiarch_image` data source to expose details about | ||
| [Docker multi-arch images](https://docs.docker.com/build/building/multi-platform/). When you build a multi-arch image, the | ||
| underlying images are not tagged so it is useful to be able to look up details about them. There is a usage example | ||
| available [here](examples/data-sources/docker_registry_multiarch_image/data-source.tf). | ||
|
|
||
| ## 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) | ||
| The long term goal is to have this change accepted into the upstream and deprecate this repo. | ||
|
|
||
| ## 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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,5 @@ | ||
| provider "docker" { | ||
| version = "~> 3.0.2" | ||
| version = "~> 3.1.0" | ||
| host = "unix:///var/run/docker.sock" | ||
| } | ||
|
|
||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters