Skip to main content

MAAS CAPI Override Reference

This page provides examples and references for overriding Cluster API (CAPI) properties on MAAS clusters using the Cluster API Provider MAAS (CAPMAAS).

info

Overriding CAPI properties is not supported on MAAS HyperShift host clusters or HyperShift-hosted OpenShift workload clusters. The override toggles in the Palette UI have no effect on these cluster types.

MAAS​

Cluster-level overrides target the MaasCluster resource, and pool-level overrides target the MaasMachineTemplate resource.

LevelCAPI KindAPI References
ClusterMaasClusterv0.6.1 MaasCluster API types
PoolMaasMachineTemplatev0.6.1 MaasMachineTemplate API types

Examples​

These examples demonstrate how to override CAPI properties using YAML directly targeting the underlying CAPMAAS resources.

Cluster-Level​

Set the LXD network bridge for a passthrough deployment
maasCluster:
  spec:
    lxdConfig:
      networkBridge: passthrough-dev

Pool-Level​

MaasMachineTemplate has an extra level of nesting. The spec wraps a template, which contains another spec field that holds the actual machine configuration. All pool-level MAAS overrides use this structure.

Select machines by MAAS tag
maasMachineTemplate:
  spec:
    template:
      spec:
        tags:
          - pcp

Unsupported First-Class Properties​

All first-class properties are supported. To learn more about the difference between first-class properties and override properties, refer to the First-Class Support vs. Override section.