Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olge404/codereadycontainers
Install and setup a local code ready containers installation (openshift 4 equivalent) on ubuntu.
https://github.com/olge404/codereadycontainers
kubernetes kubernetes-cluster openshift openshift-cluster openshift-v4
Last synced: about 2 months ago
JSON representation
Install and setup a local code ready containers installation (openshift 4 equivalent) on ubuntu.
- Host: GitHub
- URL: https://github.com/olge404/codereadycontainers
- Owner: OlGe404
- License: apache-2.0
- Created: 2022-05-08T15:48:56.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-17T13:55:03.000Z (8 months ago)
- Last Synced: 2024-05-17T22:19:19.928Z (8 months ago)
- Topics: kubernetes, kubernetes-cluster, openshift, openshift-cluster, openshift-v4
- Homepage:
- Size: 62.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Dei: deinstall.yaml
Awesome Lists containing this project
README
# CodeReadyContainers
This repo can be used to setup a local code ready containers (CRC) installation (openshift 4 equivalent) on Ubuntu/Debian (only tested on Ubuntu 22.04).
## Requirements
To install CRC with this repo, you need:
* [A free redhat account](https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=&cad=rja&uact=8&ved=2ahUKEwjGw8bPx9L3AhUNCewKHT11D7EQFnoECAYQAQ&url=https%3A%2F%2Fwww.redhat.com%2Fwapps%2Fugc%2Fregister.html&usg=AOvVaw0XN5agOwobjJWWJmiitUP7)
* [Download the mandatory pullsecrets file](https://console.redhat.com/openshift/install/pull-secret) and save it as "pull-secret.json"
* 4 cpu cores (default 8)
* 9GB of memory (default 14GB)
* 35GB of free storage space
* One of the following operating systems:
- Ubuntu 18.04 LTS or later
- Debian 10 or later
The cluster monitoring is disabled by default, because it increases cpu and memory consumption by ~50% (when the system is under load).
To enable it, provide the -e crc_cluster_monitoring=true arg when calling the playbook. CPU/memory settings can be overwritten too by providing -e crc_cluster_cpus= or -e crc_cluster_memory=.
## Install
When you've created a redhat account and downloaded the pullsecret file, run:
* python3 -m pip install --user -r requirements.txt
* ansible-playbook install.yaml
**NOTE:** If passwordless sudo is disabled, force ansible to ask for your sudo password by appending -K or --ask-become-pass to
the ansible-playbook install.yaml command.
### Known Issues
If the installation fails, it can get stuck and prevent new installations to run succesfully. If you have trouble running the playbook consecutively after an installation failed, or if the crc VM doesn't come up, see https://github.com/code-ready/crc/issues/1027 for more information on how to resolve this.
```bash
# TL;DR
crc delete --force
sudo virsh list --all
sudo virsh destroy crc
sudo virsh undefine crc
```
## Deinstall
To deinstall CRC, run ansible-playbook deinstall.yaml.
If passwordless sudo is disabled, run ansible-playbook deinstall.yaml -K instead.
## Update
If you want to update an existing CRC installation to a new release, set the new version in
the [vars.yaml file](vars.yaml) and run ansible-playbook update.yaml. You can find the available
versions at https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/.
**WARNING:** By the time of writing, there is no way to update an existing CRC installation in place, so we have to deinstall/install the current CRC installation. This will delete the CRC instance including *all data and deployments in it*.
## Work with CRC
The CRC installation will be up and running after the installation, but is not added to your systems autostart. You can use the following commands to start/stop/interact with it.
| Command | Description |
| ----------- | -------------------------------------------------- |
| crc status | Display the status of the current CRC installation |
| crc start | Start a stopped CRC installation |
| crc stop | Stop a started CRC installation |
| crc console | Open thh webconsole in browser |