Available in editions:  CE, BE, SE, SE+, EE

The module is configured automatically based on the chosen placement strategy (the AzureClusterConfiguration custom resource). In most cases, you do not need to configure the module manually.

You can configure the number and parameters of ordering machines in the cloud via the NodeGroup custom resource of the node-manager module. Also, in this custom resource, you can specify the instance class’s name for the above group of nodes (the cloudInstances.ClassReference parameter). In the case of the Azure cloud provider, the instance class is the AzureInstanceClass custom resource that stores specific parameters of the machines.

The module automatically creates the following StorageClasses:

Name Disk type
managed-standard-ssd StandardSSD_LRS
managed-standard Standard_LRS
managed-premium Premium_LRS

It allows you to configure additional StorageClasses for volumes with configurable IOPS and Throughput. Also, you can filter out the unnecessary StorageClasses via the exclude parameter.

An example of Storage Class configuration:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cloud-provider-azure
spec:
  version: 1
  enabled: true
  settings:
    storageClass:
      provision:
      - name: managed-ultra-ssd
        diskIOPSReadWrite: 600
        diskMBpsReadWrite: 150
      exclude:
      - managed-standard.*
      - managed-premium
      default: managed-ultra-ssd

Settings

The module is configured using the ModuleConfig custom resource named cloud-provider-azure (learn more about setting up Deckhouse…).

Example of the ModuleConfig/cloud-provider-azure resource for configuring the module:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cloud-provider-azure
spec:
  version: 1
  enabled: true
  settings: # <-- Module parameters from the "Parameters" section below.

Parameters

Schema version: 1

  • settings
    object
    • settings.storageClass
      object
      • settings.storageClass.default
        Deprecated
        string

        The name of StorageClass that will be used in the cluster by default.

        If the parameter is omitted, the default StorageClass is either:

        • existing StorageClass present in the cluster that has the default annotation;
        • the first (in lexicographic order) StorageClass created by the module.

        Parameter is deprecated. Instead, use the global parameter global.defaultClusterStorageClass.

        Example:

        default: pd-ssd-not-replicated
      • settings.storageClass.exclude
        array of strings

        A list of StorageClass names (or regex expressions for names) to exclude from the creation in the cluster.

        Example:

        exclude:
- pd-standard.*
- pd-ssd-replicated
      • settings.storageClass.provision
        array of objects

        Defines additional StorageClasses for Azure ultra disks.

        • settings.storageClass.provision.cachingMode
          string

          String value that corresponds to the desired caching mode. If expected disk size is more than 4 TiB, you have to set cachineMode: None.

          Check out Azure documentation for more information.

          Allowed values: None, ReadOnly, ReadWrite

        • settings.storageClass.provision.diskIOPSReadWrite
          number

          Required value

          Disk IOPS (limit of 300 IOPS/GiB, up to a maximum of 160 K IOPS per disk).

        • settings.storageClass.provision.diskMBpsReadWrite
          number

          Required value

          Disk throughput in MBps (limit of a single disk is 256 KiB/s for each provisioned IOPS).

        • settings.storageClass.provision.name
          string

          Required value

          The name of the class to create.

        • settings.storageClass.provision.tags
          array of objects

          Azure disk tags.

          Example:

          tags:
- key: key1
  value: val1
- key: key2
  value: val2
          • settings.storageClass.provision.tags.key
            string

            Pattern: ^[A-Za-z0-9][-A-Za-z0-9_.]*$

          • settings.storageClass.provision.tags.value
            string

            Pattern: ^[A-Za-z0-9][-A-Za-z0-9_.]*$

        • settings.storageClass.provision.type
          string

          Required value

          Azure disk storage account type.

          Check out Azure documentation for more information.

          Allowed values: UltraSSD_LRS