Domino provides bundles of offline installation media for use when
fleetcommand-agent without Internet access to upstream
sources of images and charts.
To serve these resources, you must have a Docker registry accessible to
your cluster, and an application registry. Domino includes a Docker image for
running an application registry in each bundle.
URLs of available offline installation bundles are in the
release notes. You can download
these bundles using the curl command with basic authentication. If there are network connectivity issues you can use the
wget command with the
-c option. Contact your domino account team for credentials.
curl -u username:password -#SfLOJ https://mirrors.domino.tech/s3/domino-artifacts/offline/fleetcommand-agent-v24/docker-images-5.x.x.tar
wget -c --user domino-registry --password xxxxxxx https://mirrors.domino.tech/s3/domino-artifacts/offline/fleetcommand-agent-v24/docker-images-5.x.x.tar
The images bundle is a
.tar archive that must be extracted before
tar -xvf docker-images-5.x.x.tar
docker-images bundle there will be:
a collection of individual Docker image
domino-load-images.py is a script to ingest the
file and load the associated Docker images for a specific Domino version
into the given remote Docker registry.
To load images into your private registry, run
and pass in the URL of your registry as an argument. The script expects
to run in the same directory as the
images.json metadata file and the
.tar image files.
python domino-load-images.py your-registry-url.domain:port
One of the images provided as part of the bundle is an
appr image that can be used to host an application registry for serving charts to the
fleetcommand-agent. After extracting the
domino-appr-latest archive you will have a top level
appr directory that contains chart data formatted for use in an application registry. You can start an application registry server on any Docker-enabled machine that can connect to your private registry through
docker run like in the following example, passing in a filesystem path to the extracted
appr directory where shown:
docker run --name dom-offline-appr \ -d -p 50001:50001 \ -v /path/to/appr:/var/lib/appr \ -e DATABASE_URL="/var/lib/appr" \ --restart=always "your-registry-url.domain:port/appr:latest" \ run-server --port 50001 --db-class filesystem
Once images have been loaded into your private registry and charts have been loaded into a running application registry server, you’re ready to install Domino.
To install Domino using a custom registry, the image references must be
modified to reference the upstream registry. Use the
argument on the
init command to modify all image references to the
docker run --rm -v $(pwd):/install quay.io/domino/fleetcommand-agent:v24 \ init --image-registry your-registry-url.domain:port --full --file /install/domino.yml
If your registry requires authentication, ensure the
private_docker_registry section of your installer configuration is
filled in with the correct credentials:
private_docker_registry: server: your-registry-url.domain:port username: '<username>' password: '<password>'
Charts come prepackaged within the
fleetcommand-agent image. Set up
helm object in configuration to match the following:
helm: version: 3 host: gcr.io namespace: domino-eng-service-artifacts prefix: '' username: '' password: '' tiller_image: gcr.io/kubernetes-helm/tiller:v2.16.1 # Version is required and MUST be 2.16.1 insecure: false cache_path: '/app/charts'
http protocol before the hostname in this configuration is important. Once these changes have been made to your installer configuration file, you can run the
fleetcommand-agent to install Domino.