Spire - sipb/homeworld GitHub Wiki

Spire is the administrative toolkit for deploying and maintaining Homeworld clusters. It is also known as homeworld-admin-tools.

Spire is written in Python and contains a variety of commands for performing various parts of the build process.

It supports functions like:

  • Generating and maintaining an encrypted copy of various authority keys.
  • Tracking encrypted copies of various upstream-issued encryption keys, like keytabs and SSH certs.
  • Generating intermediate configuration files and uploading them to the cluster.
  • SSHing into various cluster servers to configure and launch various components.
  • Maintaining various cluster components.
  • Requesting access to various cluster components.
  • Interacting with etcd and kubernetes.
  • Verifying that parts of the cluster are functioning as required.
  • Querying various properties of the cluster.
  • Updating packages on the cluster.
  • Sequencing large numbers of operations to automatically set up considerable parts of the cluster.
  • Deploying components on top of the kubernetes cluster.

See the deploy.md file for instructions on using Spire to deploy a cluster.

TODO: expand this page further.