If the cluster control plane is hosted on a virtual machines or bare-metal servers, the cloud provider uses the settings from the cloud-provider-dynamix module in the Deckhouse configuration. If the cluster control plane is hosted in a cloud, the cloud provider uses the DynamixClusterConfiguration structure for configuration.

DynamixClusterConfiguration

Version: deckhouse.io/v1

Describes the configuration of a cloud cluster in Dynamix.

Used by the cloud provider if a cluster’s control plane is hosted in the cloud.

Run the following command to change the configuration in a running cluster:

d8 system edit provider-cluster-configuration

After updating the node parameters, you need to run the dhctl converge command for the changes to take effect. For more information about changing the cluster configuration, see Adding and managing cloud nodes.

Example:

apiVersion: deckhouse.io/v1
kind: DynamixClusterConfiguration
layout: StandardWithInternalNetwork
sshPublicKey: ssh-rsa AAAA
location: dynamix
account: acc_user
nodeNetworkCIDR: 10.241.32.0/24
nameservers:
- 10.0.0.10
provider:
  controllerUrl: "<controller url>"
  oAuth2Url: "<oAuth2 url>"
  appId: "<app id>"
  appSecret: "<app secret>"
  insecure: true
masterNodeGroup:
  replicas: 1
  instanceClass:
    numCPUs: 6
    memory: 16384
    rootDiskSizeGb: 50
    imageName: "<image name>"
    storageEndpoint: "<storage endpoint>"
    pool: "<pool>"
    externalNetwork: "<external network>"
nodeGroups:
- name: worker
  replicas: 1
  instanceClass:
    numCPUs: 6
    memory: 16384
    rootDiskSizeGb: 50
    imageName: "<image name>"
    externalNetwork: "<external network>"
  • account
    string

    Required value

    Account name.

  • apiVersion
    string

    Required value

    Allowed values: deckhouse.io/v1

  • kind
    string

    Required value

    Allowed values: DynamixClusterConfiguration

  • layout
    string

    Required value

    The way resources are located in the cloud.

    Read more about possible provider layouts.

  • location
    string

    Required value

    The name of the location to install the cluster.

  • masterNodeGroup
    object

    Required value

    The definition of the master’s NodeGroup.

    For the changes to take effect, run dhctl converge after modifying the parameters of the masterNodeGroup section.

    • masterNodeGroup.instanceClass
      object

      Required value

      Partial contents of the fields of the DynamixInstanceClass.

      • masterNodeGroup.instanceClass.etcdDiskSizeGb
        integer

        Etcd disk size in GiB.

        Default: 15

        Example:

        etcdDiskSizeGb: 15
      • masterNodeGroup.instanceClass.externalNetwork
        string

        Required value

        External network name.

        Example:

        externalNetwork: extnet_vlan_1700
      • masterNodeGroup.instanceClass.imageName
        string

        Required value

        OS image name to use for VM deployment.

        Example:

        imageName: '1'
      • masterNodeGroup.instanceClass.memory
        integer

        Required value

        Memory in MiB to allocate to the VM.

        Allowed values: 1 <= X

        Example:

        memory: 8192
      • masterNodeGroup.instanceClass.numCPUs
        integer

        Required value

        Number of vCPUs to allocate to the VM.

        Allowed values: 1 <= X

        Example:

        numCPUs: 2
      • masterNodeGroup.instanceClass.pool
        string

        Required value

        Storage pool name.

        Example:

        pool: pool_a
      • masterNodeGroup.instanceClass.rootDiskSizeGb
        integer

        Root disk size in GiB to use in Dynamix VirtualMachines.

        Default: 50

        Example:

        rootDiskSizeGb: 50
      • masterNodeGroup.instanceClass.storageEndpoint
        string

        Required value

        Storage name.

        Example:

        storageEndpoint: SharedTatlin_G1_SEP
    • masterNodeGroup.replicas
      integer

      Required value

      The number of master nodes to create. It is important to have an odd number of masters to ensure a quorum.

      Allowed values: 1 <= X

  • nameservers
    array of strings

    A list of IP addresses of the DNS servers.

    Default: []

  • nodeGroups
    array of objects

    An array of additional NodeGroups for creating static nodes (e.g., for dedicated front nodes or gateways).

    • nodeGroups.instanceClass
      object

      Required value

      Partial contents of the fields of the.

      • nodeGroups.instanceClass.etcdDiskSizeGb
        integer

        Etcd disk size in GiB.

        Default: 15

        Example:

        etcdDiskSizeGb: 15
      • nodeGroups.instanceClass.externalNetwork
        string

        Required value

        External network name.

        Example:

        externalNetwork: extnet_vlan_1700
      • nodeGroups.instanceClass.imageName
        string

        Required value

        OS image name to use for VM deployment.

        Example:

        imageName: '1'
      • nodeGroups.instanceClass.memory
        integer

        Required value

        Memory in MiB to allocate to the VM.

        Allowed values: 1 <= X

        Example:

        memory: 8192
      • nodeGroups.instanceClass.numCPUs
        integer

        Required value

        Number of vCPUs to allocate to the VM.

        Allowed values: 1 <= X

        Example:

        numCPUs: 2
      • nodeGroups.instanceClass.pool
        string

        Storage pool name.

        Example:

        pool: pool_a
      • nodeGroups.instanceClass.rootDiskSizeGb
        integer

        Root disk size in GiB to use in Dynamix VirtualMachines.

        Default: 50

        Example:

        rootDiskSizeGb: 50
      • nodeGroups.instanceClass.storageEndpoint
        string

        Storage name.

        Example:

        storageEndpoint: SharedTatlin_G1_SEP
    • nodeGroups.name
      string

      Required value

      The name of the NodeGroup to use for generating node names.

    • nodeGroups.nodeTemplate

      Parameters of Node objects in Kubernetes to add after registering the node.

      • nodeGroups.nodeTemplate.annotations
        object

        The same as the metadata.annotations standard field.

        Example:

        annotations:
  ai.fleet.com/discombobulate: 'true'
      • nodeGroups.nodeTemplate.labels
        object

        A list of labels to attach to cluster resources.

        The same as the metadata.labels standard field.

        Example:

        labels:
  environment: production
  app: warp-drive-ai
      • nodeGroups.nodeTemplate.taints
        array of objects

        The same as the .spec.taints field of the Node object.

        Available fields: effect, key, and values.

        Example:

        taints:
- effect: NoExecute
  key: ship-class
  value: frigate
        • nodeGroups.nodeTemplate.taints.effect
          string

          Allowed values: NoSchedule, PreferNoSchedule, NoExecute

        • nodeGroups.nodeTemplate.taints.key
          string
        • nodeGroups.nodeTemplate.taints.value
          string
    • nodeGroups.replicas
      integer

      Required value

      The number of nodes to create.

  • nodeNetworkCIDR
    string

    IP CIDR to be assigned to the internal segment of this ViNS.

  • provider
    object

    Required value

    Parameters for connecting to the Dynamix.

    • provider.appId
      string

      Required value

      App ID.

    • provider.appSecret
      string

      Required value

      App Secret.

    • provider.controllerUrl
      string

      Required value

      The URL to the Dynamix API endpoint.

    • provider.insecure
      boolean

      Set to true if Dynamix has a self-signed certificate.

      Default: false

    • provider.oAuth2Url
      string

      Required value

      The URL to the SSO Dynamix API endpoint.

  • sshPublicKey
    string

    Required value

    A public key for accessing nodes.