Skip to content

Instantly share code, notes, and snippets.

@ryanj
Last active August 5, 2021 19:40
Show Gist options
  • Save ryanj/a00d84a2a250ccf8b6bfe57d04c77849 to your computer and use it in GitHub Desktop.
Save ryanj/a00d84a2a250ccf8b6bfe57d04c77849 to your computer and use it in GitHub Desktop.
How to set up CodeReadyContainers on Fedora Silverblue http://bit.ly/crc-silver
<section data-markdown>
# CodeReadyContainers on Fedora Silverblue
http://bit.ly/crc-silver
https://gist.github.com/ryanj/01b8592a04e40837ccd07b76716dbe73
</section>
<section data-markdown>
## 1. Silverblue Install
1. download an installer image: https://silverblue.fedoraproject.org/download
2. create USB (I used Fedora MediaWriter, linked on the /download page)
3. disable BIOS secure boot (a required step for some hardware)
4. boot from USB
5. wipe partition table (or partition with /var)
* manual partitioning guide: https://docs.fedoraproject.org/en-US/fedora-silverblue/installation/#manual-partition
6. after first login, run:
* `rpm-ostree update`
* `systemctl reboot`
</section>
<section data-markdown>
## 2. Silverblue Setup
install OS-level dependency requirements:
```bash
rpm-ostree install qemu libvirt virt-manager
```
* WARN: https://bugzilla.redhat.com/show_bug.cgi?id=1919994
</section>
<section data-markdown>
## 3. Group Membership
Create a `libvirt` group:
```bash
sudo groupadd --system libvirt
```
Add your user to the `libvirt` group:
```bash
sudo usermod -aG libvirt $(whoami)
```
Verify your membership in the `libvirt` group:
```bash
groups $(whoami)
```
</section>
<section data-markdown>
## 4. CRC Download
Download latest CRC release from: https://console.redhat.com/openshift/create/local
Tip: Remember to download or copy your CRC pull secret on this page
</section>
<section data-markdown>
## 5. CRC Install
```bash
cd ~/Downloads && tar xvJf ./crc-*.xz
mkdir -p ~/bin
mv ./crc-linux-amd64/crc ~/bin
```
</section>
<section data-markdown>
## 6. CRC Setup
```bash
crc setup
```
</section>
<section data-markdown>
## 7. CRC Startup
```bash
crc start -p ~/Downloads/pull_secret
```
if you don't include the -p flag, you'll need to interactively paste the pull secret during VM initialization
Tip: make sure to note the admin credentials in the log output!
</section>
<section data-markdown>
Access the resulting web console with:
```bash
crc console
```
(proceed through a short series of SSL warnings... 1,2,3)
</section>
<section data-markdown>
## 8. Follow-up Tasks
1. Visit the embedded OperatorHub service directory. Try installing an operator to enable professionally-maintained cloud service solutions on your cluster. After installation via Hub (by a cluster admin), operator-backed solutions will available for use by standard developers
2. Add additional user accounts, login as a normal (non-admin) user, then - try building and deploying a basic application
</section>
<section data-markdown>
## 9. Cleanup
When you're done having fun:
* Halt the VM with: `crc stop`
* Remove the VM entirely (reclaim disk space): `crc delete`
</section>
<section data-markdown>
http://bit.ly/crc-silver
</section>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment