Disconnected environment

Frequently, portions of a data center might not have access to the Internet, even via proxy servers. You can still install OpenShift Container Platform in these environments, but you must download required software and images and make them available to the disconnected environment.

Table of Contents


  • The registry host needs to have access to the Internet and at least 110 GB of disk space. You will download the required software repositories and container images to this computer. The registry host will usually be the Jumphost but it can be another server.


All the configuration needs to be done in the ansible hosts file /etc/dci-openshift-agent/hosts.

Following an example of the configuration file highlighting the variables needed by the disconnected environment:


# Registry Host
#   Define a host here to create or use a local copy of the installation registry
#   Used for disconnected installation
pctt-hv1 ansible_user=dci-openshift-agent

# The following cert_* variables are needed to create the certificates
#   when creating a disconnected registry. They are not needed to use
#   an existing disconnected registry.

The variables needed by the disconnected environment:

Group Variable Required Type Description
[registry_host] True String Define a host here to create or use a local registry
[all:vars] webserver_url True String URL of the webserver hosting the qcow images
[registry_host:vars] disconnected_registry_auths_file True String File that contains extra auth tokens to include in the pull-secret. This file will be generated if it doesn't exist.
[registry_host:vars] disconnected_registry_mirrors_file True String File that contains the addition trust bundle and image content sources for the local registry. The contents of this file will be appended to the install-config.yml file. This file will be generated if it doesn't exist.
[registry_host:vars] provision_cache_store True String Folder using for the caching
[registry_host:vars] registry_dir True String Folder where to store the openshift container images
[registry_host:vars] local_registry True String URL of the local registry hosting the openshift container images
[registry_host:vars] local_repo True String Specify the name of the repository to create in your registry,

Deploying the registry (Optional)

A playbook exist to deploy the registry and the webserver storing the QCOW images

On the Jumphost:

su - dci-openshift-agent
cd samples
ansible-playbook infrastructure.yml



Running dci-openshift-agent

After the configuration and the registry are setup, we can deploy openshift using the dci-openshift-agent:

systemctl start dci-openshift-agent




Apache License, Version 2.0 (see LICENSE file)


Email: Distributed-CI Team distributed-ci@redhat.com IRC: #distributed-ci on Freenode

results matching ""

    No results matching ""