Where is the source code for the offical terraform docker image?

aronggile · October 26, 2022, 2:14am

New to Terraform,

I see Terraform has an official docker image. But can’t seem to be able to locate its source (Dockerfile). Github searching
Hashicorp for docker-terraform and terraform-docker yields nothing. Is there a link I can follow?

Update
It turns out its closed source? The main Terraform repo contains a Dockefile and it states:

This produces a docker image that contains a working Terraform binary along
with all of its source code. This is not what produces the official releases
in the “terraform” namespace on Dockerhub; those images include only
the officially-released binary from releases.hashicorp.com and are
built by the (closed-source) official release process.

apparentlymart · October 26, 2022, 3:21pm

Hi @aronggile,

The Dockerfile which produces the official images is indeed not available in an open source repository. This is not because there’s anything secret in it but just because the overall release process (of which the Docker image build is just one small part) lives in a private repository so it can have access to secrets such as the release signing private key that our developers don’t have direct access to.

We are in the process of reworking this process so that the build steps will happen in the open source repository while the signing and publication steps will happen in a more controlled location. That work in progress means that there is an open source Dockerfile that is effectively the same as the one from the private repository; it started as an exact copy of it and has only been lightly modified to suit the new build process:

github.com

hashicorp/terraform/blob/main/.github/workflows/build-Dockerfile

# This Dockerfile is not intended for general use, but is rather used to
# produce our "light" release packages as part of our official release
# pipeline.
#
# If you want to test this locally you'll need to set the three arguments
# to values realistic for what the hashicorp/actions-docker-build GitHub
# action would set, and ensure that there's a suitable "terraform" executable
# in the dist/linux/${TARGETARCH} directory.

FROM docker.mirror.hashicorp.services/alpine:latest AS default

# This is intended to be run from the hashicorp/actions-docker-build GitHub
# action, which sets these appropriately based on context.
ARG PRODUCT_VERSION=UNSPECIFIED
ARG PRODUCT_REVISION=UNSPECIFIED
ARG BIN_NAME=terraform

# This argument is set by the Docker toolchain itself, to the name
# of the CPU architecture we're building an image for.
# Our caller should've extracted the corresponding "terraform" executable

This file has been truncated. show original

In the future we expect to begin making real releases from this Dockerfile instead (following the steps you can see in the build.yml GitHub Actions workflow); we’re making incremental progress towards that but are prioritizing real feature and bug fix work so can’t promise when we’ll be ready to switch over. But that doesn’t mean you can’t use this other Dockerfile as a reference for how to build similar images yourself in the meantime.

aronggile · October 26, 2022, 4:18pm

Thank you for the response and got it. I just wanted to see how to configure it
as the official doc does not say much. Not sure how I can mark this question as
answered so I will leave it a that for now. Thank you again.

roshaniftkhar1 · November 7, 2022, 11:02am

Hi Everyone,

Docker is used to create, run and deploy applications in containers. A Docker image contains application code , libraries, tools, dependencies and other files needed to make an application run.

I have a little bit of question from you guys. Is docker still use source code for editing images? If yes then how it will proceed it?