Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


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

Code Block
themeEmacs
crc oc-env

Setup

Code Block
themeEmacs
crc 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

Code Block
themeEmacs
crc oc-env


Configure

Set configuration:

Code Block
themeEmacs
Code Block
themeEmacs
crc config set cpus 6
crc config get cpus   

crc config set memorycpus 1600010
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
themeEmacs
crc stop
crc start

For a full list of configuration parameters issue the following command:

Code Block
themeEmacs
crc config
 config view   
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
themeEmacs
crc config
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:

Code Block
themeEmacs
crc start

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
themeEmacs
oc login -u kubeadmin https://api.crc.testing:6443

Web Console

https://console-openshift-console.apps-crc.testing

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
themeEmacs
crc stop
crc start


Some changes will require a cleanup and re-setup.

Code Block
themeEmacs
crc cleanup
crc setup



Setup

Code Block
themeEmacs
crc setup

Image Added


Starting the Cluster

Once downloaded and extracted, run:

Code Block
themeEmacs
crc start

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
themeEmacs
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

Code Block
themeEmacs
crc console


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
themeEmacs
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
themeEmacs
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
themeEmacs
crc version
Code Block
CRC version: 2.33.0+c43b17
OpenShift version: 4.14.12
Podman version: 4.4.4


Delete the Cluster

Code Block
themeEmacs
crc delete


Open the Console

Code Block
themeEmacs
crc console


References

ReferenceURL
Install Red Hat OpenShift Local Kubernetes in macOS on MacBook Pro Intel x86_64 and M1 arm64https://www.youtube.com/watch?v=Qr2Gdc6p00A
Image configuration resourceshttps://docs.openshift.com/container-platform/4.9/openshift_images/image-configuration.html