debug daemon (debugd)

debugd Prerequisites

Go 1.18

Build debugd

mkdir -p build
go build -o build/debugd debugd/debugd/cmd/debugd/debugd.go

Build & install cdbg

The go install command for cdbg only works inside the checked out repository due to replace directives in the go.mod file.

git clone https://github.com/edgelesssys/constellation && cd constellation
go install github.com/edgelesssys/constellation/debugd/cdbg

debugd & cdbg usage

With cdbg and yq installed in your path:

Write the configuration file for cdbg cdbg-conf.yaml:

cdbg:
  authorizedKeys:
    - username: my-username
      publicKey: ssh-rsa AAAAB…LJuM=
  coordinatorPath: "./coordinator"
  systemdUnits:
    - name: some-custom.service
      contents: |-
        [Unit]
        Description=…

Run constellation config generate to create a new default configuration
Locate the latest debugd images for GCP and Azure

Modify the constellation-conf.yaml to use an image with the debugd already included and add required firewall rules:

# Set timestamp from cloud provider image name
export TIMESTAMP=01234

yq -i \
    ".provider.azureConfig.image = \"/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/CONSTELLATION-IMAGES/providers/Microsoft.Compute/galleries/Constellation/images/constellation-coreos-debugd/versions/0.0.${TIMESTAMP}\"" \
    constellation-conf.yaml

yq -i \
    ".provider.gcpConfig.image = \"projects/constellation-images/global/images/constellation-coreos-debugd-${TIMESTAMP}\"" \
    constellation-conf.yaml

yq -i \
    ".ingressFirewall += {
        \"name\": \"debugd\",
        \"description\": \"debugd default port\",
        \"protocol\": \"tcp\",
        \"iprange\": \"0.0.0.0/0\",
        \"fromport\": 4000,
        \"toport\": 0
    }" \
    constellation-conf.yaml

Run constellation create […]
Run cdbg deploy
Run constellation init […] as usual

debugd GCP image

For GCP, run the following command to get a list of all constellation images, sorted by their creation date:

gcloud compute images list --filter="name~'constellation-.+'" --sort-by=~creationTimestamp --project constellation-images

Choose the newest debugd image with the naming scheme constellation-coreos-debugd-<timestamp>.

debugd Azure Image

For Azure, run the following command to get a list of all constellation debugd images, sorted by their creation date:

az sig image-version list --resource-group constellation-images --gallery-name Constellation --gallery-image-definition constellation-coreos-debugd --query "sort_by([], &publishingProfile.publishedDate)[].id" -o table

Choose the newest debugd image and copy the full URI.

2.8 KiB Raw Blame History