[Docs] Document how to use mirror for crcbundle download

[cjeanner]

Hello,

In order to make some faster bootstrapping of CRC (I'm iterating some tests here), it would be really nice if we could use a custom mirror for the crcbundle download.

From what I could see, this is currently not possible, and the version as well as the location of the bundle seem to be fixed[1].

While downloading 3GB isn't really an issue on my internet line, it may happen the remote server hosting the bundle is a bit slow - and this has a non-null impact on my local testings.

Also, having the capability to use a local mirror would avoid many, many hits against the hosting service, allowing better network management all the way.

Something like crc setup --mirror http://mirror.local or the like would be really, really nice :).

Cheers,

C.

[1] https://github.com/crc-org/crc/blob/bdda86992d74bc055b71039d2f1664b159bde51a/pkg/crc/machine/bundle/constants.go#L17

[praveenkumar]

@cjeanner you can upload the bundle to any local mirror and then use

crc setup -b http://mirror.local/<bundle_name>

[cjeanner]

oohhh - I was wondering if that -b would actually accept some proper URI :). Now I get my answer - thanks!

[praveenkumar]

@cjeanner https://crc.dev/blog/posts/2022-09-26-bundle-option-in-crc/ it can accept even image URI :)

[praveenkumar]

Looks like we have the proper doc in config section but not part of setup so may be we should fix that.

$ ./crc config | grep bundle
* bundle                                     Bundle path/URI - absolute or local path, http, https or docker URI (string, like 'https://foo.com/crc_microshift_libvirt_4.12.5_amd64.crcbundle', 'docker://quay.io/myorg/crc_microshift_libvirt_4.12.5_amd64.crcbundle:2.15.0' default '/home/prkumar/.crc/cache/crc_microshift_libvirt_4.12.5_amd64.crcbundle' )

$ ./crc setup -h | grep bundle
  -b, --bundle string                  Bundle to use for instance (default "/home/prkumar/.crc/cache/crc_microshift_libvirt_4.12.5_amd64.crcbundle")

[gbraad]

Making this a documentation task, as there is nothing for us to fix here, besides maybe a small change in setup. However, this is missing documentation or an entry in FAQ.