Cluster configuration field reference

This page describes the fields supported in the Google Distributed Cloud cluster configuration file. For each field, the following table identifies whether the field is required. The table also shows which fields are mutable, meaning which fields can be changed after a cluster has been created.

Generating a template for your cluster configuration file

You can create a cluster configuration file with the bmctl create config command. Although some fields have default values and others, such as metadata.name can be auto-filled, this YAML format configuration file is a template for specifying information about your cluster.

To create a new cluster configuration file, use the following command in the /baremetal folder:

bmctl create config -c CLUSTER_NAME

Replace CLUSTER_NAME with the name for the cluster you want to create. For more information about bmctl, see bmctl tool. For an example of the generated cluster configuration file, see Cluster configuration file sample.

Filling in your configuration file

In your configuration file, enter field values as described in the following field reference table before you create or upgrade your cluster.

Cluster configuration fields

Field name Resource type Required? Mutable?
Cluster resource Yes Yes
Cluster resource
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No Yes
Cluster resource
Cluster resource No No
Cluster resource Yes No
Cluster resource Yes No
Cluster resource
Cluster resource No Yes
Cluster resource No Yes
Cluster resource Yes No
Cluster resource Yes No
Cluster resource
Cluster resource
Cluster resource Yes Yes
Cluster resource
Cluster resource Yes No
Cluster resource No Yes
Cluster resource
Cluster resource No No
Cluster resource No No
Cluster resource Yes No
Cluster resource No No
Cluster resource No Yes
Cluster resource Yes No
Cluster resource No No
Cluster resource
Cluster resource No Yes
Cluster resource No Yes
Cluster resource Yes No
Cluster resource Yes No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No No
Cluster resource No Yes
Cluster resource No Yes
Cluster resource No No
Cluster resource No No
Cluster resource
Cluster resource No No
Cluster resource No No
Cluster resource
Cluster resource No No
Cluster resource No No
Cluster resource Yes No
Cluster resource Yes No
Cluster resource Yes No
Cluster resource Yes No
Cluster resource Yes No
Cluster resource No No
Cluster resource Yes No
Namespace resource Yes No
NodePool resource Yes No
NodePool resource No Yes
NodePool resource No Yes
NodePool resource No Yes
NodePool resource No Yes
Registry mirror Optional Mutable
Registry mirror Optional Mutable
Registry mirror Optional Mutable
Registry mirror Optional Mutable
Credentials 
Credentials  No Yes
Credentials  No Yes
Credentials  No Yes
Credentials  No Yes
Credentials  No Yes