https://github.com/crc-org/snc
Single Node Cluster creation scripts for OpenShift 4.x as used by CodeReady Containers
https://github.com/crc-org/snc
codeready openshift openshift-cluster openshift-deployment podman single-node-cluster snc
Last synced: 7 months ago
JSON representation
Single Node Cluster creation scripts for OpenShift 4.x as used by CodeReady Containers
- Host: GitHub
- URL: https://github.com/crc-org/snc
- Owner: crc-org
- License: apache-2.0
- Created: 2019-03-07T12:05:09.000Z (over 6 years ago)
- Default Branch: release-4.16
- Last Pushed: 2024-09-16T05:21:38.000Z (about 1 year ago)
- Last Synced: 2024-09-16T06:42:49.794Z (about 1 year ago)
- Topics: codeready, openshift, openshift-cluster, openshift-deployment, podman, single-node-cluster, snc
- Language: Shell
- Homepage: https://crc.dev
- Size: 616 KB
- Stars: 100
- Watchers: 14
- Forks: 50
- Open Issues: 68
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: security-notice.yaml
Awesome Lists containing this project
README
# 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 `
- `./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](https://github.com/openshift/installer/blob/master/docs/user/overview.md#cluster-installation-process). It can take up to 45 mins.
You can monitor the progress of the installation with `kubectl`.
```
$ export KUBECONFIG=/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](https://origin-release.apps.ci.l2s4.p1.openshiftapps.com)
- For example, to build release: 4.5.0-0.okd-2020-08-12-020541
```bash
# 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"
# 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
```
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 /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.
Please note the SNC project is “as-is” on this Github repository. At this time, it is not an offically supported Red Hat solution.