Single node cluster (snc) scripts for OpenShift 4

NOTE: Please select the respective branch to create a bundle for a specific OpenShift release (ie. to create a 4.15.x OpenShift bundle, choose the release-4.15 branch)

How to use?

• Clone this repo git clone https://github.com/code-ready/snc.git
• cd <directory_to_cloned_repo>
• ./snc.sh

How to create disk image?

• Once your snc.sh script run successfully.
• ./createdisk.sh crc-tmp-install-data

Monitoring

The installation is a long process. It can take up to 45 mins. You can monitor the progress of the installation with kubectl.

$ export KUBECONFIG=<directory_to_cloned_repo>/crc-tmp-install-data/auth/kubeconfig
$ kubectl get pods --all-namespaces

Building SNC for OKD 4

• Before running ./snc.sh, you need to create a pull secret file, and set a couple of environment variables to override the default behavior.
• Select the OKD 4 release that you want to build from: https://origin-release.apps.ci.l2s4.p1.openshiftapps.com
• For example, to build release: 4.5.0-0.okd-2020-08-12-020541

# Create a pull secret file

cat << EOF > /tmp/pull_secret.json
{"auths":{"fake":{"auth": "Zm9vOmJhcgo="}}}
EOF

# Set environment for OKD build
export OKD_VERSION=4.5.0-0.okd-2020-08-12-020541
export OPENSHIFT_PULL_SECRET_PATH="/tmp/pull_secret.json"

# Optionally cache the iso somewhere
export ISO_CACHE_DIR=$HOME/.local/share/libvirt/images

# Build the Single Node cluster
./snc.sh

• When the build is complete, create the disk image as described below.

export BUNDLED_PULL_SECRET_PATH="/tmp/pull_secret.json"
./createdisk.sh crc-tmp-install-data

Creating container image for bundles

After running snc.sh/createdisk.sh, the generated bundles can be uploaded to a container registry using this command:

./gen-bundle-image.sh <version> <openshift/okd/microshift>

Note: a GPG key is needed to sign the bundles before they are wrapped in a container image.

Troubleshooting

OpenShift installer will create 1 VM. It is sometimes useful to ssh inside the VM. Add the following lines in your ~/.ssh/config file. You can then do ssh master.

Host master
    Hostname 192.168.126.11
    User core
    IdentityFile <directory_to_cloned_repo>/id_ecdsa_crc
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null

Environment Variables

The following environment variables can be used to change the default values of bundle generation.

SNC_GENERATE_MACOS_BUNDLE : if set to 0, bundle generation for MacOS is disabled, any other value will enable it. SNC_GENERATE_WINDOWS_BUNDLE : if set to 0, bundle generation for Windows is disabled, any other value will enable it. SNC_GENERATE_LINUX_BUNDLE : if set to 0, bundle generation for Linux is disabled, any other value will enable it.

SNC_HTTP_PROXY : HTTP proxy URL; when set, configures proxy.httpProxy in install-config. SNC_HTTPS_PROXY : HTTPS proxy URL; when set, configures proxy.httpsProxy in install-config. Either or both may be set; noProxy is applied when at least one is set.

Example:

export SNC_HTTP_PROXY=http://proxy.example.com:8080
export SNC_HTTPS_PROXY=http://proxy.example.com:8080
./snc.sh

Please note the SNC project is “as-is” on this Github repository. At this time, it is not an offically supported Red Hat solution.