Argo Workflow Template: Dockerfile Build Deployment

This module will only run inside of clusters that have the kube_buildkit addon deployed.

This module creates an Argo WorkflowTemplate that will use BuildKit to build a Dockerfile from an indicated code repository and push it to the account's ECR registry.

In particular, generated Workflows will perform the following actions:

Check out the source code indicated by code_repo using our standard checkout process.
Automatically configure authentication with the ECR registry for the account where the Workflow runs.
Scale-up the cluster's BuildKit instances if needed.
Submit both arm64 and amd64 builds to BuildKit using the indicated dockerfile_path and build_context (paths relative to the root of code_repo) with the build-time arguments and secrets provided by secrets and args, respectively.
Merge the generated images into a multi-platform image and push the result to the ECR repository indicated by image_repo with the image tag set to the git commit hash of the code that was checked out from code_repo.

Arguments for Generated Workflows

Parameter	Default	Order	Description
`git_ref`	`var.git_ref`	0	The git reference to use when checking out the `var.code_repo` for the build.

Usage

We provide an example of using this module here.

The critical configuration values are:

code_repo: The repository containing your Dockerfile and code to build.
dockerfile_path: (Optional) A relative path from the root of the repo to your Dockerfile (or Containerfile).
build_context: (Optional) The build context to submit to BuildKit.
args: (Optional) The build arguments to set.
secrets: (Optional) The build secrets to set.

Make sure you review our guide on how to optimize your Dockerfiles and build processes.

Authenticating with Private Repositories

git_username and git_password can be used for authenticating with a private code_repo. See our documentation for what values to provide. The only permissions needed by this Workflow is read access to the source code.

Build Instance Sizing

The containers running in this workflow only perform very basic orchestration operations. The build processes actually occur directly in the BuildKit instances.

If you are finding you need to increase the resource requests or limits for your build processes, you will need to adjust the parameters of the kube_buildkit module.