Skip to content

README.md

Latest commit

 

History

History
46 lines (33 loc) · 2.09 KB

README.md

File metadata and controls

46 lines (33 loc) · 2.09 KB

Magic Castle for Incus

What is Incus

From linuxcontainers.org:

Incus is a next-generation system container, application container, and virtual machine manager.

It provides a user experience similar to that of a public cloud. With it, you can easily mix and match both containers and virtual machines, sharing the same underlying storage and network.

How to instal Incus

To install Incus on your personal compute or in a virtual machine, follow the instructions: Install and initialize Incus

How to create a Magic Castle cluster with Incus

  1. Install terraform on the same machine running Incus.
  2. Grab the incus example main.tf
  3. Set the incus terraform provider environment variable : export INCUS_SOCKET=/var/run/incus/unix.socket
  4. Initialize terraform: terraform init
  5. Apply: terraform apply
  6. Note the project id from the terraform output.
  7. Connect to an instance, replace <project> by incus project id: incus --project <project> exec mgmt1 -- /bin/bash.

What features are yet implemented?

When deploying Magic Castle with Incus, the following features are yet implemented:

  • Virtual machine instance type
  • Volumes
  • GPU
  • Firewall / network ACLs
  • SELinux
  • NFS Automount

Autoscaling with Terraform Cloud

It is possible to enable the cluster autoscaling as described in Magic Castle Terraform Cloud documentation.

Since Incus is a local provider, a local terraform agent is required. To setup a Terraform agent, follow the instructions. The Terraform agent has to run on the same machine as the incus server. In the Terraform cloud workspace of the cluster, make sure to define the environment variable INCUS_SOCKET=/var/run/incus/unix.socket. This will allow the Terraform agent to communicate with Incus.