Cloud provider — GCP: Custom Resources

Описывает параметры группы GCP Instances, которые будет использовать machine-controller-manager (модуль node-manager).

На этот ресурс ссылается ресурс CloudInstanceClass модуля node-manager.

• spec

  объект

  Обязательный параметр

  • spec.additionalDisks

    массив объектов

    Список дополнительных дисков, которые будут подключены к инстансу.

    Полезно для нагрузок, связанных с хранением данных, таких как LINSTOR, Ceph, NFS и аналогичные решения.

    Пример:

    additionalDisks:
    - size: 100
      type: pd-ssd
    

    • spec.additionalDisks.autoDelete

      булевый

      Автоматически удалять диск при удалении инстанса.

      По умолчанию: true

    • spec.additionalDisks.provisionedIops

      целочисленный

      Запрошенное количество IOPS для диска.

      Обязательно для типов pd-extreme и hyperdisk-extreme.

      Допустимые значения: 1 <= X

    • spec.additionalDisks.provisionedThroughput

      целочисленный

      Запрошенная пропускная способность диска в МиБ/с.

      Применимо для типов hyperdisk-balanced и hyperdisk-throughput.

      Допустимые значения: 1 <= X

    • spec.additionalDisks.size

      целочисленный

      Обязательный параметр

      Размер диска в гигабайтах (ГБ).

      Допустимые значения: 1 <= X

      Пример:

      size: 100
      

    • spec.additionalDisks.type

      строка

      Обязательный параметр

      Тип диска.

      • pd-standard — стандартный Persistent Disk (HDD).
      • pd-balanced — сбалансированный Persistent Disk (SSD).
      • pd-ssd — SSD Persistent Disk.
      • pd-extreme — экстремальный Persistent Disk; требует указания provisionedIops.
      • hyperdisk-balanced — Hyperdisk со сбалансированной производительностью.
      • hyperdisk-throughput — Hyperdisk, оптимизированный для пропускной способности.
      • hyperdisk-extreme — Hyperdisk с максимальной производительностью; требует указания provisionedIops.

      Допустимые значения: pd-standard, pd-balanced, pd-ssd, pd-extreme, hyperdisk-balanced, hyperdisk-throughput, hyperdisk-extreme

      Пример:

      type: pd-ssd
      

  • spec.additionalLabels

    объект

    Список дополнительных лейблов.

    Подробно про лейблы можно прочитать в официальной документации.

    Пример:

    additionalLabels:
      project: cms-production
      severity: critical
    

  • spec.additionalNetworkTags

    массив строк

    Список дополнительных тегов.

    Теги, например, позволяют применять к инстансам правила firewall. Подробно про network tags можно прочитать в официальной документации.

  • spec.capacity

    Параметр устарел

    объект

    Устарело: параметр больше не используется. Для переданного типа инстанса Deckhouse использует параметры, полученные из облака.

    Емкость инстанса для нестандартных типов инстансов (параметр machineType).

    Используется cluster-autoscaler’ом при планировании, только когда в NodeGroup’е еще нет узлов (при minPerZone равном 0). Если в NodeGroup уже есть узлы, cluster-autoscaler использует при планировании фактические данные (CPU, memory) о мощности узла и не использует данные параметра capacity.

    Параметр необходимо указывать только для нестандартных типов инстансов. Параметры стандартных типов инстансов (a2-highgpu-8g, c2-standard-8 и т. п.) заложены в Deckhouse.

    • spec.capacity.cpu

      строка или число

      Обязательный параметр

      Количество vCPU узла.

      Шаблон: ^[0-9]+m?$

      Пример:

      cpu: 1000m
      

    • spec.capacity.memory

      строка или число

      Обязательный параметр

      Количество памяти узла.

      Шаблон: ^[0-9]+(\.[0-9]+)?(E|P|T|G|M|k|Ei|Pi|Ti|Gi|Mi|Ki)?$

      Пример:

      memory: 1500Mi
      

  • spec.disableExternalIP

    булевый

    Запрет назначения внешнего IP-адреса для инстанса.

  • spec.diskSizeGb

    целочисленный

    Размер root-диска. Значение указывается в ГиБ.

    По умолчанию: 50

    Пример:

    diskSizeGb: 20
    

  • spec.diskType

    строка

    Тип созданного диска.

    По умолчанию: pd-standard

    Допустимые значения: pd-standard, pd-ssd

    Пример:

    diskType: pd-ssd
    

  • spec.enableNestedVirtualization

    булевый

    Включить вложенную виртуализацию на инстансе.

    Необходимо для запуска виртуальных машин (например, KVM) внутри GCP-инстансов.

    Внимание. Поддерживается только на определённых типах машин. Список совместимых типов приведён в документации GCP.

    По умолчанию: false

  • spec.image

    строка

    Необязательный параметр.

    Образ, который будет использоваться в заказанных инстансах.

    Список доступных образов можно найти в документации провайдера.

    Список поддерживаемых Deckhouse ОС и их версий можно найти в документации Deckhouse (учитывайте используемую версию Deckhouse).

    Пример:

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

  • spec.machineType

    строка

    Обязательный параметр

    Тип заказываемых инстансов.

    Внимание! Следует убедиться, что указанный тип есть во всех зонах, перечисленных в параметре zones.

    GCP позволяет указывать нестандартное количество CPU и RAM, например: custom-8-40960 или n2-custom-8-40960.

    Пример:

    machineType: n1-standard-4
    

  • spec.preemptible

    булевый

    Необходимость заказа preemptible-инстансов (прерываемых виртуальных машин).

    По умолчанию: false

• status

  объект
  • status.nodeGroupConsumers

    массив строк