Setup
Go to https://console.redhat.com/openshift/cluster-list
...
Select Cluster List and click Create cluster.
Select Local and select MacOS your OS and x86_64 and click the Download OpenShift Local.
Image Removed
Once downloaded, run the package.
Image Removed
Image RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage Removed
Install OC Client
Setup
Image Removed
Config
Configure our cpus and memory.
Version 2.33.0
https://mirror.openshift.com/pub/openshift-v4/clients/crc/2.33.0/
https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/2.33.0/crc-macos-installer.pkg
"crcVersion": "2.33.0",
"gitSha": "c43b17",
"openshiftVersion": "4.14.12",
"podmanVersion": "4.4.4"
Latest:
https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/latest/crc-macos-installer.pkg
Image Added
Once downloaded, run the package.
Image Added
Image AddedImage AddedImage AddedImage AddedImage AddedImage Added
Install OC Client
Configure
Set configuration:
Code Block |
---|
|
Code Block |
---|
|
crc config set cpus 10
crc config get cpus
crc config set memorycpus 3200010
crc config getset memory
30000
crc config set disk-size 120
crc config host-network-access true |
Verify configuration:Changes made while the cluster is running will require a restart before the changes are applied.
Code Block |
---|
|
crc stop
crc start
|
For a full list of configuration parameters issue the following command:
Code Block |
---|
- consent-telemetry |
Code Block |
---|
Modifies crc configuration properties.
Properties:
* bundle : no
- cpus Bundle path/URI - absolute or local path, http, https or docker URI (string, like 'https://foo.com/crc_vfkit_4.16.7_arm64.crcbundle', 'docker://quay.io/myorg/crc_vfkit_4.16.7_arm64.crcbundle:2.41.0' default '/Users/john/.crc/cache/crc_vfkit_4.16.7_arm64.crcbundle' )
* consent-telemetry : 10
- disk-size Consent to collection of anonymous usage data (yes/no)
* cpus: 120
- host-network-access : true
- memory Number of CPU cores (must be greater than or equal to '4')
* disable-update-check : 30000 |
For a full list of configuration parameters issue the following command:
Code Block |
---|
Modifies crc Disable update check (true/false, default: false)
* disk-sizeconfiguration properties.
Properties:
* bundle Total size in GiBBundle ofpath/URI the disk (must be greater than or equal to '31')
* enable-bundle-quay-fallback If bundle download from the default location fails, fallback to quay.io (true/false, default: false)
* enable-cluster-monitoring- absolute or local path, http, https or docker URI (string, like 'https://foo.com/crc_vfkit_4.16.7_arm64.crcbundle', 'docker://quay.io/myorg/crc_vfkit_4.16.7_arm64.crcbundle:2.41.0' default '/Users/john/.crc/cache/crc_vfkit_4.16.7_arm64.crcbundle' )
* consent-telemetry Enable cluster monitoring Operator (true/false, default: false Consent to collection of anonymous usage data (yes/no)
* cpus enable-emergency-login Enable emergency login for 'core' user. Password is randomly generated. (true/false, default: false)
* enable-experimental-features Number of CPU cores (must be Enablegreater experimentalthan features (true/false, default: falseor equal to '4')
* enabledisable-sharedupdate-dirscheck Disable update Mounts host's home directory at '/' in the CRC VM (true/false, default: truecheck (true/false, default: false)
* host-network-accessdisk-size Allow TCP/IP connections from the CRC VMTotal tosize servicesin runningGiB onof the hostdisk (true/false, default: falsemust be greater than or equal to '31')
* http-proxyenable-bundle-quay-fallback If bundle download from the default location fails, fallback to quay.io (true/false, default: false)
* enable-cluster-monitoring HTTP proxy URL (string, like 'http://my-proxy.com:8443')
* https-proxy Enable cluster monitoring Operator (true/false, default: false)
* enable-emergency-login HTTPSEnable proxyemergency URL (string, like 'https://my-proxy.com:8443')
* ingress-http-port login for 'core' user. Password is randomly generated. (true/false, default: false)
* enable-experimental-features Enable experimental HTTP port to use for OpenShift ingress/routes on the host (1024-65535features (true/false, default: 80false)
* ingressenable-httpsshared-portdirs HTTPSMounts porthost's tohome usedirectory forat OpenShift ingress'/routes' onin the hostCRC (1024-65535VM (true/false, default: 443true)
* kubeadminhost-network-passwordaccess Allow User defined kubeadmin password
* memory TCP/IP connections from the CRC VM to services running on the host (true/false, default: false)
* http-proxy Memory size in MiB (must be greaterHTTP thanproxy orURL equal(string, tolike '10752http://my-proxy.com:8443')
* nameserverhttps-proxy HTTPS IPv4proxy address ofURL nameserver (string, like '1.1.1.1 or 8.8.8.8'https://my-proxy.com:8443')
* no-proxyingress-http-port HTTP port to use for OpenShift ingress/routes on the host Hosts(1024-65535, ipv4 addresses or CIDR which do not use a proxy (string, comma-separated list such as '127.0.0.1,192.168.100.1/24')
* persistent-volume-sizedefault: 80)
* ingress-https-port HTTPS port to use for OpenShift ingress/routes on the host Total size in GiB of the persistent volume used by the CSI driver for microshift preset (must be greater than or equal to '15')
* preset(1024-65535, default: 443)
* kubeadmin-password User defined kubeadmin password
* memory Memory Virtualsize machinein presetMiB (validmust values are: [openshift okd microshift]be greater than or equal to '10752')
* proxy-ca-filenameserver Path to an HTTPSIPv4 proxyaddress certificateof authoritynameserver (CA)
* pull-secret-file string, like '1.1.1.1 or 8.8.8.8')
* no-proxy Path of image pull secret (download from https://console.redhat.com/openshift/create/local)
* skip-check-admin-helper-cached Hosts, ipv4 Skipaddresses preflight check (true/false, default: falseor CIDR which do not use a proxy (string, comma-separated list such as '127.0.0.1,192.168.100.1/24')
* skippersistent-checkvolume-bundle-extractedsize Skip preflight check (true/false, default: false)
* skip-check-crc-symlink Skip preflight check (true/false, default: false)
* skip-check-daemon-launchd-plist Total size in GiB of the persistent volume used by the CSI driver for microshift preset (must be greater than or equal to '15')
* preset Skip preflight check (true/false, default: false)
* skip-check-m1-cpu SkipVirtual preflightmachine checkpreset (true/false, default: false)valid values are: [openshift okd microshift])
* skipproxy-check-mac-versionca-file Path Skipto an preflightHTTPS check (true/false, default: falseproxy certificate authority (CA)
* skippull-checksecret-old-autostartfile Skip preflight check (true/false, default: false Path of image pull secret (download from https://console.redhat.com/openshift/create/local)
* skip-check-podmanadmin-inhelper-ocbindircached Skip preflight check (true/false, default: false)
* skip-check-rambundle-extracted Skip preflight check (true/false, default: false)
* skip-check-crc-symlink Skip preflight check (true/false, default: false)
* skip-check-resolverdaemon-file-permissionslaunchd-plist Skip preflight check (true/false, default: false)
* skip-check-root-userm1-cpu Skip preflight check (true/false, default: false)
* skip-check-ssh-port mac-version Skip preflight check (true/false, default: false)
* skip-check-supportedold-cpu-archautostart Skip preflight check (true/false, default: false)
* skip-check-podman-in-ocbindir Skip preflight check-vfkit-installed (true/false, default: false)
* skip-check-ram Skip preflight check (true/false, default: false) |
Starting the Cluster
Once downloaded and extracted, run:
Image Removed
Grab the pull secrets form the UI by clicking the Copy pull secret link.
Image Removed
Past the pull secret to the terminal
Image RemovedImage Removed
Login
Code Block |
---|
|
oc login -u kubeadmin https://api.crc.testing:6443 |
CRC
* skip-check-resolver-file-permissions Skip preflight check (true/false, default: false)
* skip-check-root-user Skip preflight check (true/false, default: false)
* skip-check-ssh-port Skip preflight check (true/false, default: false)
* skip-check-supported-cpu-arch Skip preflight check (true/false, default: false)
* skip-check-vfkit-installed Skip preflight check (true/false, default: false) |
Changes made while the cluster is running will require a restart before the changes are applied.
Code Block |
---|
|
crc stop
crc start
|
Some changes will require a cleanup and re-setup.
Code Block |
---|
|
crc cleanup
crc setup
|
Setup
Image Added
Starting the Cluster
Once downloaded and extracted, run:
Image Added
Grab the pull secrets form the UI by clicking the Copy pull secret link.
Image Added
Past the pull secret to the terminal
Image AddedImage Added
Login
Code Block |
---|
|
oc login -u kubeadmin https://api.crc.testing:6443 |
Web Console
Open the console using crc or by going to https://console-openshift-console.apps-crc.testing
CRC
- Code Ready Containers
Code Block |
---|
CRC is a tool that manages a local OpenShift 4.x cluster optimized for testing and development purposes
Usage:
crc [flags]
crc [command]
Available Commands:
bundle Manage CRC bundles
cleanup Undo config changes
completion Generate the autocompletion script for the specified shell
config Modify crc configuration
console Open the OpenShift Web Console in the default browser
delete Delete the instance
help Help about any command
ip Get IP address of the running OpenShift cluster
oc-env Add the 'oc' executable to PATH
podman-env Setup podman environment
setup Set up prerequisites for using CRC
start Start the instance
status Display status of the OpenShift cluster
stop Stop the instance
version Print version information
Flags:
-h, --help help for crc
--log-level string log level (e.g. "debug | info | warn | error") (default "info") |
Helpful Commands
CRC Status
Code Block |
---|
CRC VM: Running
OpenShift: Running (v4.16.7)
RAM Usage: 7.89GB of 16.34GB
Disk Usage: 31.53GB of 128.2GB (Inside the CRC VM)
Cache Usage: 38.67GB
Cache Directory: /Users/john/.crc/cache |
CRC Configuration
Code Block |
---|
|
crc config view |
Code Block |
---|
- consent-telemetry |
Code Block |
---|
CRC is a tool that manages a local OpenShift 4.x cluster optimized for testing and development purposes
Usage:
crc [flags]
crc [command]
Available Commands:
bundle Manage CRC bundles
cleanup Undo config changes
completion Generate the autocompletion script for the specified shell
config Modify crc configuration
console Open the OpenShift Web Console in the default browser
delete Delete the instance
help Help about any: commandno
- cpus ip Get IP address of the running OpenShift cluster
oc-env Add the 'oc' executable to PATH
podman-env Setup podman: environment8
- disk-size setup Set up prerequisites for using CRC
start Start the instance
status : Display status of the OpenShift cluster
stop120
- host-network-access Stop the instance
version: true
- memory Print version information
Flags:
-h, --help help for crc
--log-level string : log level (e.g. "debug | info | warn | error") (default "info")24000 |
CRC Version
Code Block |
---|
CRC version: 2.33.0+c43b17
OpenShift version: 4.14.12
Podman version: 4.4.4 |
Delete the Cluster
Open the Console
References