mirror of https://github.com/edgelesssys/constellation.git synced 2024-10-01 01:36:09 -04:00

History

renovate[bot] 1732795345 deps: update fedora:37 Docker digest (#1192 ) Co-authored-by: katexochen <katexochen@users.noreply.github.com>		2023-02-15 13:28:53 +01:00
..
server	initserver: add client verification	2022-11-28 19:34:02 +01:00
virtwrapper	Document exported funcs,types,interfaces and enable check. (#475 )	2022-11-09 15:57:54 +01:00
Dockerfile	deps: update fedora:37 Docker digest (#1192 )	2023-02-15 13:28:53 +01:00
main.go	initserver: add client verification	2022-11-28 19:34:02 +01:00
README.md	AB#2114 Add QEMU metadata API (#237 )	2022-06-30 11:14:26 +02:00

README.md

QEMU metadata API

This program provides a metadata API for Constellation on QEMU.

Dependencies

To interact with QEMU libvirt is required. Install the C libraries:

On Ubuntu:

sudo apt install libvirt-dev

On Fedora:

sudo dnf install libvirt-devel

Firewalld

If your system uses firewalld virtmanager will add itself to the firewall rules managed by firewalld. Your VMs might be unable to communicate with the host.

To fix this open port 8080 (the default port for the QEMU metadata API) for the libvirt zone:

# Open the port
sudo firewall-cmd --zone libvirt --add-port 8080/tcp --permanent

Docker image

Build the image:

DOCKER_BUILDKIT=1 docker build -t ghcr.io/edgelesssys/constellation/qemu-metadata-api:latest -f hack/qemu-metadata-api/Dockerfile .

A container of the image is automatically started by Terraform. You can also run the image manually using the following command:

docker run -it --rm \
    --network host \
    -v /var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock \
    ghcr.io/edgelesssys/constellation/qemu-metadata-api:latest