Docker Registries

Configuring Docker Registries with Halyard

This is a quick walkthrough of how to configure your Spinnaker to access a Docker registry. Many of the commands below have additional options that may be useful (or possibly required). If you need more detailed help, take a look at the Halyard command reference

Enable Docker Registries

If you haven’t done this yet (for example, if you’ve just installed Armory Spinnaker fresh), you’ll need to enable Docker registry providers:

hal config provider docker-registry enable

Add a Registry (and Repositories)

To add a new registry, you’ll use some variation of the following command. This example uses a public Docker Hub registry (armory/demoapp) and actually would not use the --username or --password options, since the registry is public. In most cases, you’ll be configuring a private registry and the authentication credentials will be required, so the options are shown here as an example.

hal config provider docker-registry account add my-docker-registry \
  --address index.docker.io
  --repositories armory/demoapp
  --username yourusername
  --password # you'll be prompted for this interactively

Detailed information on all command line options can be found here

Note: Some registries, like Docker Hub, require you to identify the repositories explicitly, like above. Some do not (such as the Google Container Registry). Further details can be found here.

Amazon’s ECR requires additional configuration to work properly with Spinnaker. We’ve documented this separately.