Skip to content

spectrocloud/cluster-api-provider-maas

Repository files navigation

Cluster-API-Provider-MAAS

Cluster API Provider for Canonical Metal-As-A-Service maas.io

You're welcome to join the upcoming webinar for capmaas!

Getting Started

Public Images

Spectro Cloud public images

Kubernetes Version URL
1.25.6 https://maas-images-public.s3.amazonaws.com/u-2204-0-k-1256-0.tar.gz
1.26.1 https://maas-images-public.s3.amazonaws.com/u-2204-0-k-1261-0.tar.gz

Custom Image Generation

Refer image-generation/

Hello world

  • Create kind cluster
kind create cluster --name=maas-cluster
# MAAS access endpoint and key
MAAS_API_KEY: <maas-api-key>
MAAS_ENDPOINT: http://<maas-endpoint>/MAAS
MAAS_DNS_DOMAIN: maas.domain

# Cluster configuration
KUBERNETES_VERSION: v1.26.4
CONTROL_PLANE_MACHINE_IMAGE: custom/u-2204-0-k-1264-0
CONTROL_PLANE_MACHINE_MINCPU: 4
CONTROL_PLANE_MACHINE_MINMEMORY: 8192
WORKER_MACHINE_IMAGE: custom/u-2204-0-k-1264-0
WORKER_MACHINE_MINCPU: 4
WORKER_MACHINE_MINMEMORY: 8192

# Selecting machine based on resourcepool (optional) and machine tag (optional)
CONTROL_PLANE_MACHINE_RESOURCEPOOL: resorcepool-controller
CONTROL_PLANE_MACHINE_TAG: hello-world
WORKER_MACHINE_RESOURCEPOOL: resourcepool-worker
WORKER_MACHINE_TAG: hello-world
  • Initialize infrastructure
clusterctl init --infrastructure maas:v0.5.0
  • Generate and create cluster
clusterctl generate cluster t-cluster --infrastructure=maas:v0.5.0 --kubernetes-version v1.26.4 --control-plane-machine-count=1 --worker-machine-count=3 | kubectl apply -f -

Developer Guide

  • Create kind cluster
kind create cluster --name=maas-cluster
  • Install clusterctl v1 depending on the version you are working with

  • Makefile set IMG=

  • Run

make docker-build && make docker-push
  • Generate dev manifests
make dev-manifests
  • Move _build/dev/ directory contents to ~/.clusterapi/overrides v0.5.0 depending on version you are working with
.
├── clusterctl.yaml
├── overrides
│   ├── infrastructure-maas
│       └── v0.5.0
│           ├── cluster-template.yaml
│           ├── infrastructure-components.yaml
│           └── metadata.yaml
└── version.yaml

  • Run
clusterctl init --infrastructure maas:v0.5.0

Install CRDs

v1beta1 v0.5.0 release

  • Generate cluster using
clusterctl generate cluster t-cluster  --infrastructure=maas:v0.5.0 | kubectl apply -f -

or

clusterctl generate cluster t-cluster --infrastructure=maas:v0.5.0 --kubernetes-version v1.26.4 > my_cluster.yaml
kubectl apply -f my_cluster.yaml

or

clusterctl generate cluster t-cluster --infrastructure=maas:v0.5.0 --kubernetes-version v1.26.4 --control-plane-machine-count=1 --worker-machine-count=3 > my_cluster.yaml
kubectl apply -f my_cluster.yaml