Cloud provider — GCP: Custom Resources

Parameters of a group of GCP Instances used by machine-controller-manager (the node-manager module).

The CloudInstanceClass resource of the node-manager module refers to this resource.

• spec

  object

  Required value

  • spec.additionalDisks

    array of objects

    A list of additional disks to attach to the instance.

    Useful for storage workloads such as LINSTOR, Ceph, NFS, and similar.

    Example:

    additionalDisks:
    - size: 100
      type: pd-ssd
    

    • spec.additionalDisks.autoDelete

      boolean

      Automatically delete the disk when the instance is deleted.

      Default: true

    • spec.additionalDisks.provisionedIops

      integer

      Provisioned IOPS for the disk.

      Required for pd-extreme and hyperdisk-extreme disk types.

      Allowed values: 1 <= X

    • spec.additionalDisks.provisionedThroughput

      integer

      Provisioned throughput in MiB/s for the disk.

      Applicable for hyperdisk-balanced and hyperdisk-throughput disk types.

      Allowed values: 1 <= X

    • spec.additionalDisks.size

      integer

      Required value

      Disk size in gigabytes (GB).

      Allowed values: 1 <= X

      Example:

      size: 100
      

    • spec.additionalDisks.type

      string

      Required value

      Disk type.

      • pd-standard — standard Persistent Disk (HDD).
      • pd-balanced — balanced Persistent Disk (SSD).
      • pd-ssd — SSD Persistent Disk.
      • pd-extreme — extreme Persistent Disk; requires provisionedIops.
      • hyperdisk-balanced — Hyperdisk with balanced performance.
      • hyperdisk-throughput — Hyperdisk optimized for throughput.
      • hyperdisk-extreme — Hyperdisk with maximum performance; requires provisionedIops.

      Allowed values: pd-standard, pd-balanced, pd-ssd, pd-extreme, hyperdisk-balanced, hyperdisk-throughput, hyperdisk-extreme

      Example:

      type: pd-ssd
      

  • spec.additionalLabels

    object

    Additional labels.

    More info…

    Example:

    additionalLabels:
      project: cms-production
      severity: critical
    

  • spec.additionalNetworkTags

    array of strings

    The list of additional tags.

    For example, you can use tags to apply firewall rules to instances. The detailed description of network tags is available in the official documentation.

  • spec.capacity

    Deprecated

    object

    Deprecated: the parameter is no longer used. Deckhouse is using parameters from the cloud for passed instance type.

    Instance capacity for non-standard instance types (the machineType parameter).

    Cluster-autoscaler uses the parameter for scheduling only when there are no nodes in NodeGroup yet (if minPerZone equal to 0). If there are already nodes in the NodeGroup, then cluster-autoscaler uses the actual node capacity (CPU, memory) when planning, and does not use the capacity parameter.

    The parameter must be specified only for non-standard instance types. Info about the capacity of standard instance types (a2-highgpu-8g, c2-standard-8, etc.) is embedded in Deckhouse.

    • spec.capacity.cpu

      integer or string

      Required value

      Node vCPU resources.

      Pattern: ^[0-9]+m?$

      Example:

      cpu: 1000m
      

    • spec.capacity.memory

      integer or string

      Required value

      Node memory resources.

      Pattern: ^[0-9]+(\.[0-9]+)?(E|P|T|G|M|k|Ei|Pi|Ti|Gi|Mi|Ki)?$

      Example:

      memory: 1500Mi
      

  • spec.disableExternalIP

    boolean

    Defines whether to disable external ip for an instance or not. True means that an instance is created without external ip

  • spec.diskSizeGb

    integer

    Instance’s root disk size in gibibytes.

    Default: 50

    Example:

    diskSizeGb: 20
    

  • spec.diskType

    string

    Instance’s disk type.

    Default: pd-standard

    Allowed values: pd-standard, pd-ssd

    Example:

    diskType: pd-ssd
    

  • spec.enableNestedVirtualization

    boolean

    Enables nested virtualization on the instance.

    Required for running virtual machine workloads (e.g., KVM-based VMs) inside GCP instances.

    Warning. Only supported on specific machine types. See the GCP documentation for the list of compatible types.

    Default: false

  • spec.image

    string

    Not required value.

    Image to use while provisioning GCP servers.

    You can find a list of available images in the provider documentation.

    The list of OS and their versions supported by Deckhouse can be found in the Deckhouse documentation (take into account the Deckhouse version used).

    Example:

    image: https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/images/ubuntu-2404-noble-amd64-v20260128
    

  • spec.machineType

    string

    Required value

    Machine type of GCP instance.

    Caution! Make sure that this type is present in all zones specified in the zones parameter.

    GCP lets you specify a custom amount of resources (CPU and RAM), e.g., custom-8-40960 or n2-custom-8-40960.

    Example:

    machineType: n1-standard-4
    

  • spec.preemptible

    boolean

    Should instances be preemptible.

    Default: false

• status

  object
  • status.nodeGroupConsumers

    array of strings