Skip to content

Commit 986c428

Browse files
committed
Add post about using bundle option
1 parent a1c8cd3 commit 986c428

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: "How to use bundle option"
3+
date: 2024-03-22T12:39:10+05:30
4+
---
5+
6+
CRC provides a config option called `bundle` to configure the _location_ of the bundle. This option is useful when you
7+
want to use a bundle that is not the default one or user want to try a bundle which is not part of release but available
8+
at the OpenShift mirror location. The `bundle` option can accept local filesystem paths, container registry URLs, and
9+
http/https URLs. This blog post will guide you through the process of using the `bundle` option using config or
10+
setup/start commands.
11+
12+
## Using `bundle` option with `crc config` command
13+
14+
You can use the `crc config set bundle` command to set the bundle location. This command can accept local filesystem paths,
15+
container registry URLs, and http/https URLs. Here are some examples:
16+
17+
```bash
18+
# Assume user want to use microshift-4.15.0 bundle which is not part of crc release but available at the OpenShift mirror location
19+
crc config set bundle https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/microshift/4.15.0/crc_microshift_libvirt_4.15.0_amd64.crcbundle
20+
crc setup
21+
crc start
22+
```
23+
24+
## Using `bundle` option with `crc setup` and `crc start` commands
25+
```bash
26+
crc setup --bundle https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/microshift/4.15.0/crc_microshift_libvirt_4.15.0_amd64.crcbundle
27+
crc start --bundle https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/microshift/4.15.0/crc_microshift_libvirt_4.15.0_amd64.crcbundle
28+
```
29+
30+
**Beware**, if you use -b https:// there will be no signature checks
31+
Bundles downloaded from mirror.openshift.com can be verified this way:
32+
```bash
33+
curl -L -O https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/microshift/4.15.0/crc_microshift_libvirt_4.15.0_amd64.crcbundle
34+
curl -L -O https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/microshift/4.15.0/crc_microshift_libvirt_4.15.0_amd64.crcbundle.sha256
35+
sha256sum crc_microshift_libvirt_4.15.0_amd64.crcbundle => should match with the content of crc_microshift_libvirt_4.15.0_amd64.crcbundle.sha256
36+
```
37+
38+
## Conclusion
39+
This blog post has shown you how to use the `bundle` option with CRC. By following these steps, you can quickly and easily
40+
spin up a local cluster using the bundle of your choice.
41+
As usual, we'd like to get your [feedback](https://github.com/crc-org/crc/issues/new/choose) on all this work!

0 commit comments

Comments
 (0)