…
|
||
---|---|---|
.. | ||
assembler | ||
build | ||
dependencies | ||
dm-verity | ||
docs | ||
images | ||
runner | ||
docker.env | ||
Makefile | ||
podman.env | ||
README.md |
Constellation images
We use the Fedora CoreOS Assembler to build the base image for Constellation nodes.
Setup
-
Install prerequisites:
-
Log in to GCP and Azure
gcloud auth login az login
-
Ensure read and write access to
/dev/kvm
(and repeat after every reboot)sudo chmod 666 /dev/kvm
Configuration
Create a configuration file in image/config.mk
to override any of the variables found at the top of the Makefile.
Important settings are:
BOOTSTRAPPER_BINARY
: path to a bootstrapper binary. Can be substituted with a path to adebugd
binary if a debug image should be built. The binary has to be built before!CONTAINER_ENGINE
: container engine used to run COSA. eitherpodman
ordocker
.COSA_INIT_REPO
: Git repository containing CoreOS config. Cloned incosa-init
target.COSA_INIT_BRANCH
: Git branch checked out fromCOSA_INIT_REPO
. Can be used to test out changes on another branch before merging.NETRC
path to a netrc file containing a GitHub PAT. Used to authenticate to GitHub from within the COSA container.GCP_IMAGE_NAME
: Image name for the GCP image. Set to include a timestamp when using the build pipeline. Can be set to a custom value if you wat to upload a custom image for testing on GCP.AZURE_IMAGE_NAME
: Image name for the Azure image. Can be set to a custom value if you wat to upload a custom image for testing on Azure.
Example config.mk
to create a debug image with docker and name it my-custom-image
:
BOOTSTRAPPER_BINARY = ../build/debugd
CONTAINER_ENGINE = docker
GCP_IMAGE_NAME = my-custom-image
AZURE_IMAGE_NAME = my-custom-image
Build an image
It is always advisable to create an image from a clean
build
dir.
Clean up the build
dir and remove old images (⚠ this will undo any local changes to the CoreOS configuration!):
sudo make clean
Ensure you have the modified cosa container image installed:
make cosa-image
-
Build QEMU image (for local testing only)
make coreos
-
Build Azure image (without upload)
make image-azure
-
Build Azure image (with upload)
make image-azure upload-azure
-
Build GCP image (without upload)
make image-gcp
-
Build GCP image (with upload)
make image-gcp upload-gcp
Resulting images for the CSPs can be found under images. QEMU images are stored at build/builds/latest/
with a name ending in .qcow2
.