Metal3 IP Address Manager for Cluster API Provider Metal3

This repository contains a controller to manage static IP address allocations in Cluster API Provider Metal3.

For more information about this controller and related repositories, see metal3.io.

Compatibility with Cluster API

IPAM version	CAPM3 version	Cluster API version	IPAM Release
v1alpha1 (v1.1.X)	v1beta1 (v1.1.X)	v1beta1 (v1.1.X)	v1.1.X
v1alpha1 (v1.2.X)	v1beta1 (v1.2.X)	v1beta1 (v1.2.X)	v1.2.X
v1alpha1 (v1.3.X)	v1beta1 (v1.3.X)	v1beta1 (v1.3.X)	v1.3.X
v1alpha1 (v1.4.X)	v1beta1 (v1.4.X)	v1beta1 (v1.4.X)	v1.4.X
v1alpha1 (v1.5.X)	v1beta1 (v1.5.X)	v1beta1 (v1.5.X)	v1.5.X
v1alpha1 (v1.6.X)	v1beta1 (v1.6.X)	v1beta1 (v1.6.X)	v1.6.X
v1alpha1 (v1.7.X)	v1beta1 (v1.7.X)	v1beta1 (v1.7.X)	v1.7.X
v1alpha1 (v1.8.X)	v1beta1 (v1.8.X)	v1beta1 (v1.8.X)	v1.8.X

Development Environment

See metal3-dev-env for an end-to-end development and test environment for cluster-api-provider-metal3 and baremetal-operator.

API

See the API Documentation for details about the objects used with this controller. You can also see the cluster deployment workflow for the outline of the deployment process.

Deployment and examples

Deploy IPAM

Deploys IPAM CRDs and deploys IPAM controllers

    make deploy

Run locally

Runs IPAM controller locally

    kubectl scale -n capm3-system \
      deployment.v1.apps/metal3-ipam-controller-manager --replicas 0
    make run

Deploy an example pool

    make deploy-examples

Delete the example pool

    make delete-examples