Documentation for version v0.5.0 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
While the README pulls from the Heptio image registry, you can also build your own Heptio Ark container with the following steps:
In addition to the handling the prerequisites mentioned in the Quickstart, you should have Go installed (minimum version 1.8).
Install with go:
go get github.com/heptio/ark
The files are installed in
You can build your Ark image locally on the machine where you run your cluster, or you can push it to a private registry. This section covers both workflows.
$REGISTRY environment variable (used in the
Makefile) if you want to push the Heptio Ark images to your own registry. This allows any node in your cluster to pull your locally built image.
$VERSION environment variables are also specified in the
Makefile, and can be similarly modified as desired.
Run the following in the Ark root directory to build your container with the tag
To push your image to a registry, use
There are several files that are automatically generated based on the source code in the repository. These include:
If you make any of the following changes, you will need to run
make update to regenerate
automatically generated files:
make will build an
ark binary that runs on your host operating system and
architecture. If you want to build for another platform, you can do so with
make build-<GOOS>-<GOARCH - for example, to build for the Mac, you would do
All binaries are placed in
Makefile has a convenience target,
all-build, that builds the following platforms:
To run unit tests, use
make test. You can also run
make verify to ensure that all generated
files (clientset, listers, shared informers, docs) are up to date.
When running Heptio Ark, you will need to account for the following (all of which are handled in the
See Cloud Provider Specifics for a more detailed guide.
Once your Ark deployment is up and running, you need to replace the Heptio-provided Ark image with the specific one that you built. You can do so with the following command:
kubectl set image deployment/ark ark=$REGISTRY/$PROJECT:$VERSION
$VERSION match what you used in the
If you need to add or update the vendored dependencies, please see Vendoring dependencies.