constellation/cli/internal/libvirt/README.md

34 lines
1.0 KiB
Markdown

# Containerized libvirt
To avoid dependency issues with the libvirt setup of the host, we provide a containerized libvirt instance.
If no libvirt connection string is provided in the Constellation config file during create,
this container is deployed to provide a libvirt daemon for orchestrating Constellation nodes in QEMU.
The container will listen for libvirt connections on `localhost:16599`.
Connecting to the libvirt daemon running in the container and manage the deployment using `virsh` run the following:
```shell
virsh -c "qemu+tcp://localhost:16599/system"
```
## Docker image
Build the image:
```shell
bazel build //cli/internal/libvirt:constellation_libvirt
bazel build //bazel/release:libvirt_sum
bazel build //bazel/release:libvirt_tar
bazel run //bazel/release:libvirt_push
```
A container of the image is automatically started by the CLI.
You can also run the image manually using the following command:
```shell
docker run -it --rm \
--network host \
--privileged true \
ghcr.io/edgelesssys/constellation/libvirt:latest
```