Skip to content
This repository has been archived by the owner on Jan 31, 2024. It is now read-only.

Commit

Permalink
cloud: Document how to download disk image
Browse files Browse the repository at this point in the history
Now that it's being uploaded.
  • Loading branch information
cgwalters committed Jan 2, 2024
1 parent ff78291 commit deef186
Showing 1 changed file with 37 additions and 2 deletions.
39 changes: 37 additions & 2 deletions cloud/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,41 @@ can be used in any virtualization/IaaS system that is
such as [libvirt](https://blog.wikichoon.com/2020/09/virt-install-cloud-init.html),
AWS, etc.

- Download QCOW2: [Fedora ELN](https://storage.googleapis.com/centos-bootc-dev/fedora-bootc-cloud.qcow2).
## Pre-generated disk images

The qcow2 image was built using [osbuildbootc](https://github.com/cgwalters/osbuildbootc).
There are pre-generated disk images available which can be launched directly.

(Note: as of right now there are only disk images for Fedora until [this issue](https://github.com/osbuild/bootc-image-builder/issues/18) is fixed)

The disk images are stored as OCI artifacts; currently in the Github container registry until
[this issue](https://github.com/CentOS/centos-bootc-layered/issues/25) is fixed.

### Unpacking the disk image using oras

The [oras](https://oras.land/) project offers a handy CLI tool that can be used like this:

```text
$ oras pull ghcr.io/centos/fedora-bootc-cloud-disk:eln
...
Pulled ghcr.io/centos/fedora-bootc-cloud-disk:eln
Digest: sha256:2bd73cc3589f6c7c28d7335a704133fd08526e4c0197a3ae038f1821c736c144
$ zstd -d fedora-bootc-cloud-eln.qcow2.zst
```

### Unpacking using skopeo

It's more common to have `skopeo` instead of `oras`, but unfortunately the ergonomics here are currently atrocious:

```text
$ skopeo copy docker://ghcr.io/centos/fedora-bootc-cloud-disk:eln oci:disk
Getting image source signatures
Copying blob da734940e022 done
Copying config 44136fa355 done
Writing manifest to image destination
$ find disk/blobs/ -type f -size -5M | xargs -r rm
$ mv disk/blobs/sha256/* fedora-bootc-cloud-eln.qcow2.zst
$ rm -rf disk
$ zstd -d fedora-bootc-cloud-eln.qcow2.zst
fedora-bootc-cloud-eln.qcow2.zst: 790560768 bytes
$
```

0 comments on commit deef186

Please sign in to comment.