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

...


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
config set cpus 6
crc config getset cpus   
10
crc config set memory 16000
crc config get memory

30000
crc config set disk-size 120
crc config get disk-size
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
Modifies- crcconsent-telemetry configuration properties.
Properties: 

* bundle                    : no
- cpus                                 Bundle path/URI: 10
- absolutedisk-size 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             : 120
- host-network-access     Consent to collection of anonymous usage data (yes/no)
* cpus      : true
- memory                         Number  of CPU cores (must be : 30000


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

Code Block
themeEmacs
crc config
Code Block
Modifies crc configuration properties.
Properties: 

* bundlegreater than or equal to '4')
* disable-update-check                 Disable update check (true/false, default: false)
* disk-size              Bundle path/URI - absolute or local path, http, https or docker URI (string,  Total size in GiB of the disk (must be greater than or equal to '31')
* enable-bundle-quay-fallbacklike '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                    IfConsent bundleto downloadcollection fromof theanonymous defaultusage location fails, fallback to quay.io (true/false, default: false)
* enable-cluster-monitoringdata (yes/no)
* cpus                  Enable cluster monitoring Operator (true/false, default: false)
* enable-emergency-login        Number of CPU cores (must be greater Enablethan emergencyor loginequal forto 'core' user. Password is randomly generated. (true/false, default: false4')
* enabledisable-experimentalupdate-featurescheck         Enable experimental features        Disable update check (true/false, default: false)
* enabledisk-shared-dirssize                   Mounts host's home directory at '/' in the CRC VM (true/false, default: true)
* host-network-access        Total size in GiB of the disk (must be greater than or equal to '31')
* enable-bundle-quay-fallback          AllowIf TCP/IPbundle connectionsdownload from the CRCdefault VMlocation tofails, servicesfallback running on the hostto quay.io (true/false, default: false)
* httpenable-cluster-proxymonitoring            Enable cluster              HTTP proxy URL (string, like 'http://my-proxy.com:8443'monitoring Operator (true/false, default: false)
* httpsenable-emergency-proxylogin               Enable emergency login for 'core' user. Password is    HTTPS proxy URL (string, like 'https://my-proxy.com:8443'randomly generated. (true/false, default: false)
* ingressenable-httpexperimental-portfeatures         Enable experimental features (true/false, default: false)
* enable-shared-dirs                  HTTP portMounts tohost's usehome fordirectory OpenShiftat ingress'/routes' onin the CRC hostVM (1024-65535true/false, default: 80true)
* ingresshost-httpsnetwork-portaccess                   HTTPS port to use for OpenShift ingress/routesAllow TCP/IP connections from the CRC VM to services running on the host (1024-65535true/false, default: 443false)
* kubeadminhttp-passwordproxy                   User defined kubeadmin password
* memory    HTTP proxy URL (string,      like 'http://my-proxy.com:8443')
* https-proxy                    Memory size in MiB (must be greaterHTTPS thanproxy orURL equal(string, tolike '10752https://my-proxy.com:8443')
* nameserveringress-http-port                    HTTP port to use for OpenShift ingress/routes IPv4on addressthe of nameserverhost (string1024-65535, like '1.1.1.1 or 8.8.8.8'default: 80)
* noingress-https-proxyport                   HTTPS 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-sizethe host (1024-65535, default: 443)
* kubeadmin-password                   User defined kubeadmin password
* memory                   Total size in GiB of the persistent volume used by the CSI driverMemory forsize microshiftin presetMiB (must be greater than or equal to '1510752')
* presetnameserver                           IPv4 address of nameserver Virtual(string, machine preset (valid values are: [openshift okd microshift]like '1.1.1.1 or 8.8.8.8')
* proxy-ca-fileno-proxy                         Path to an HTTPS proxyHosts, certificateipv4 authority (CA)
* pull-secret-file             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    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-supported-cpu-archold-autostart             Skip preflight check (true/false, default: false)
* skip-check-vfkitpodman-in-installedocbindir           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