Skip to main content
Version: 0.8

Publishing Acorn Images

Once the application is in a state where it is ready to move to test and production you will need to build an Acorn image and publish it to a registry. Acorn images are only accessible to the Acorn namespace they were built in. In order to use them in other namespaces or on other Kubernetes clusters, the images need to be tagged and published to a registry.

Building and tagging an Acorn image

To publish your image run the familiar build command with a -t option to tag the image. A tag will include the FQDN of the registry and the URI path for the image. Commonly, the URI path is a variation of /<organization>/<app-name>:<version>

An example would be:

acorn build -t .

This is very similar to the Docker build workflow:

docker build -t<org>/<image>:<version> .

You can use the tag to reference the built Acorn image to run, push, and update it.

Tagging existing Acorn images

If you want to push a local Acorn image to another registry, or move from a SHA to a friendly name, you can tag the image. The command is:

acorn tag <current_image> <new_image>

To tag and prepare to push to Dockerhub run:

acorn tag [MY-IMAGE] /myorg/image:latest

Pushing Acorn image to production

Once the image is tagged, it is ready to be pushed to the remote registry.

Logging in

First you will need to login with credentials that have push access to the remote registry.

# Docker hub
acorn login

# - or -

#GitHub container registry
acorn login

You will be prompted for your username and password to login. If your company has an internal registry you can login substituting for your organizations registry domain.

Push the image

Pushing to a registry requires 2 things:

  1. User is logged in and authorized.
  2. Image is tagged for the remote registry.
acorn push

Pulling / Running the Acorn image

Once the image has been published to a registry, it can be run on other clusters that have access to that registry. You can run the acorn and the Acorn image will automatically be pulled.

acorn run

You can manually pull the Acorn image:

acorn pull

Additional Information

  • See Credentials docs for details on how registry credentials are scoped and stored.