Versions Compared

Key

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

...

Select Local and select 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, memory and disk size.


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 get disk-size

Changes made while the cluster is running will require a restart before the changes are applied. 

Code Block
themeEmacs
crc stop
crc start
host-network-access true


Verify configurationFor a full list of configuration parameters issue the following command:

Code Block
themeEmacs
crc 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 inBundle GiBpath/URI of- theabsolute diskor (mustlocal bepath, greaterhttp, thanhttps 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-monitoringdocker 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)
* enable-emergency-login   Consent to collection of anonymous usage data (yes/no)
* cpus    Enable emergency login for 'core' user. Password is randomly generated. (true/false, default: false)
* enable-experimental-features         Enable experimental features (true/false, default: false)
* enable-shared-dirs Number of CPU cores (must be greater than or equal to '4')
* disable-update-check          Mounts host's home directory at '/' in theDisable CRCupdate VMcheck (true/false, default: truefalse)
* hostdisk-network-accesssize                  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         HTTP proxy URL (string, like 'http://my-proxy.com:8443'to quay.io (true/false, default: false)
* httpsenable-cluster-proxymonitoring            Enable cluster monitoring Operator (true/false,          HTTPS proxy URL (string, like 'https://my-proxy.com:8443'default: false)
* ingressenable-httpemergency-portlogin               Enable emergency login for 'core' HTTPuser. portPassword tois userandomly for OpenShift ingress/routes on the host (1024-65535generated. (true/false, default: 80false)
* ingressenable-httpsexperimental-portfeatures         Enable experimental features (true/false, default: false)
* enable-shared-dirs     HTTPS port to use for OpenShift ingress/routes on the host (1024-65535         Mounts host's home directory at '/' in the CRC VM (true/false, default: 443true)
* kubeadmin-passwordhost-network-access                  Allow TCP/IP Userconnections definedfrom kubeadminthe password
*CRC memoryVM 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.8https://my-proxy.com:8443')
* noingress-http-proxyport                    HTTP port to use for OpenShift ingress/routes on  Hosts, 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-size          the host (1024-65535, default: 80)
* ingress-https-port                   HTTPS port to use for OpenShift ingress/routes on the host (1024-65535, default: 443)
* kubeadmin-password     Total size in GiB of the persistent volume used by the CSI driver for microshift preset User defined kubeadmin password
* memory                               Memory size in MiB (must be greater than or equal to '1510752')
* presetnameserver                           IPv4 address   Virtual machine presetof nameserver (validstring, values are: [openshift okd microshift]like '1.1.1.1 or 8.8.8.8')
* no-proxy-ca-file                        Path to an HTTPS proxy certificateHosts, authority (CA)
* pull-secret-file              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-size       Path of image pull secret (download from https://console.redhat.com/openshift/create/local)
* skip-check-admin-helper-cached       Skip preflight check (true/false, default: false)
* skip-check-bundle-extracted 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-crc-symlink               SkipVirtual preflightmachine checkpreset (true/false, default: falsevalid values are: [openshift okd microshift])
* skipproxy-check-daemon-launchd-plistca-file      Skip preflight check (true/false, default: false)
* skip-check-m1-cpu            Path to an HTTPS proxy    Skip preflight check (true/false, default: falsecertificate authority (CA)
* skippull-checksecret-mac-versionfile               Skip preflight check (true/false, default: false)
* skip-check-old-autostart       Path of image pull secret (download from https://console.redhat.com/openshift/create/local)
* skip-check-admin-helper-cached       Skip preflight check (true/false, default: false)
* skip-check-podman-in-ocbindirbundle-extracted          Skip preflight check (true/false, default: false)
* skip-check-ram        crc-symlink               Skip preflight check (true/false, default: false)
* skip-check-resolverdaemon-filelaunchd-permissionsplist      Skip preflight check (true/false, default: false)
* skip-check-root-userm1-cpu                    Skip preflight check (true/false, default: false)
* skip-check-sshmac-port version                 Skip preflight check (true/false, default: false)
* skip-check-supported-cpu-archold-autostart             Skip preflight check (true/false, default: false)
* skip-check-podman-vfkitin-installed  ocbindir         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-ram                       Skip preflight check (true/false, default: false)
* 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