Microsoft.ServiceFabric managedClusters/nodeTypes 2021-07-01-preview

Определение ресурса Bicep

Тип ресурса managedClusters/nodeTypes можно развернуть с помощью операций, предназначенных для:

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

Формат ресурсов

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters/nodeTypes, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview' = {
  name: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  properties: {
    applicationPorts: {
      endPort: int
      startPort: int
    }
    capacities: {
      {customized property}: 'string'
    }
    dataDiskSizeGB: int
    dataDiskType: 'string'
    ephemeralPorts: {
      endPort: int
      startPort: int
    }
    frontendConfigurations: [
      {
        ipAddressType: 'string'
        loadBalancerBackendAddressPoolId: 'string'
        loadBalancerInboundNatPoolId: 'string'
      }
    ]
    isPrimary: bool
    isStateless: bool
    multiplePlacementGroups: bool
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRanges: [
          'string'
        ]
      }
    ]
    placementProperties: {
      {customized property}: 'string'
    }
    vmExtensions: [
      {
        name: 'string'
        properties: {
          autoUpgradeMinorVersion: bool
          forceUpdateTag: 'string'
          protectedSettings: any()
          provisionAfterExtensions: [
            'string'
          ]
          publisher: 'string'
          settings: any()
          type: 'string'
          typeHandlerVersion: 'string'
        }
      }
    ]
    vmImageOffer: 'string'
    vmImagePublisher: 'string'
    vmImageSku: 'string'
    vmImageVersion: 'string'
    vmInstanceCount: int
    vmManagedIdentity: {
      userAssignedIdentities: [
        'string'
      ]
    }
    vmSecrets: [
      {
        sourceVault: {
          id: 'string'
        }
        vaultCertificates: [
          {
            certificateStore: 'string'
            certificateUrl: 'string'
          }
        ]
      }
    ]
    vmSize: 'string'
  }
}

Значения свойств

managedClusters/nodeTypes

Имя Описание Значение
name имя ресурса.

Узнайте, как задать имена и типы для дочерних ресурсов в Bicep.
строка (обязательно)
tags Теги ресурсов Azure. Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Номер SKU типа узла. NodeTypeSku
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить только в том случае, если дочерний ресурс объявлен вне родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: managedClusters
properties Свойства типа узла NodeTypeProperties

NodeTypeProperties

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов у узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в ГБ. int (обязательно)
DataDiskType Тип диска управляемых данных. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
frontendConfigurations Указывает, что тип узла использует собственные внешние конфигурации вместо конфигурации по умолчанию для кластера. Этот параметр можно указать только для типов узлов, не являющихся первичными, и его нельзя добавить или удалить после создания типа узла. FrontendConfiguration[]
isPrimary Указывает, что системные службы Service Fabric для кластера будут выполняться на этом типе узла. Этот параметр нельзя изменить после создания типа узла. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multiplePlacementGroups Указывает, может ли масштабируемый набор, связанный с типом узла, состоять из нескольких групп размещения. bool
networkSecurityRules Правила безопасности сети для этого типа узла. Этот параметр можно указать только для типов узлов, настроенных с помощью интерфейсных конфигураций. NetworkSecurityRule[]
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypePropertiesPlacementProperties
vmExtensions Набор расширений, которые должны быть установлены на виртуальных машинах. VmssExtension[]
vmImageOffer Тип предложения образа Azure Виртуальные машины Marketplace. Например, UbuntuServer или WindowsServer. строка
vmImagePublisher Издатель образа Azure Виртуальные машины Marketplace. Например, Canonical или MicrosoftWindowsServer. строка
vmImageSku Номер SKU образа Azure Виртуальные машины Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. строка
vmImageVersion Версия образа Azure Виртуальные машины Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение latest. Если этот параметр опущен, значение по умолчанию — latest. строка
vmInstanceCount Количество узлов в типе узла.

Значения:
-1 — используется при настройке правил автомасштабирования или определении sku.capacity
0 — не поддерживается
}0 — используется для масштабирования вручную.
int (обязательно)

Ограничения:
Максимальное значение = 2147483647
vmManagedIdentity Удостоверения, назначаемые масштабируемму набору виртуальных машин в типе узла. VmManagedIdentity
vmSecrets Секреты для установки на виртуальных машинах. VaultSecretGroup[]
vmSize Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Например, Standard_D3. строка

EndpointRangeDescription

Имя Описание Значение
endPort Конечный порт диапазона портов int (обязательно)
startPort Начальный порт диапазона портов int (обязательно)

NodeTypePropertiesCapacities

Имя Описание Значение
{настроенное свойство} строка

FrontendConfiguration

Имя Описание Значение
ipAddressType Тип IP-адреса этой интерфейсной конфигурации. Если этот параметр опущен, значение по умолчанию — IPv4. IPv4
IPv6
loadBalancerBackendAddressPoolId Идентификатор ресурса Load Balancer серверного пула адресов, с которым связаны экземпляры виртуальных машин типа узла. Формат идентификатора ресурса : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}. строка
loadBalancerInboundNatPoolId Идентификатор ресурса Load Balancer пула NAT для входящего трафика, с которым связаны экземпляры виртуальных машин типа узла. Идентификатор ресурса имеет формат "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}". строка

NetworkSecurityRule

Имя Описание Значение
access Сетевой трафик разрешен или запрещен. "allow"
Deny (обязательно)
description Описание правила безопасности сети. строка
destinationAddressPrefixes Префиксы адресов назначения. Диапазоны CIDR или целевых IP-адресов. string[]
destinationPortRanges Диапазоны портов назначения. string[]
direction Направление правил безопасности сети. "inbound"
outbound (обязательно)
name Имя правила безопасности сети. строка (обязательно)
priority Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для Поставщика ресурсов Service Fabric ManagerКластера ресурсов. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже номер приоритета, тем выше приоритет правила. int (обязательно)

Ограничения:
Минимальное значение = 1000
Максимальное значение = 3000
protocol Сетевой протокол, к которому применяется данное правило. 'ah'
'esp'
'http'
'https'
'icmp'
"tcp"
"udp" (обязательно)
sourceAddressPrefixes Диапазоны CIDR или исходных IP-адресов. string[]
sourcePortRanges Диапазоны исходных портов. string[]

NodeTypePropertiesPlacementProperties

Имя Описание Значение
{настроенное свойство} строка

VmssExtension

Имя Описание Значение
name Имя модуля. строка (обязательно)
properties Описывает свойства расширения масштабируемого набора виртуальных машин. VmssExtensionProperties (обязательно)

VmssExtensionProperties

Имя Описание Значение
autoUpgradeMinorVersion Указывает, должно ли расширение использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
forceUpdateTag Если указано значение и отличается от предыдущего, обработчик расширений будет принудительно обновляться, даже если конфигурация расширения не изменилась. строка
protectedSettings Расширение может содержать protectedSettings или protectedSettingsFromKeyVault или вообще не иметь защищенных параметров. Для Bicep можно использовать функцию any().
provisionAfterExtensions Коллекция имен расширений, после которых необходимо подготовить это расширение. string[]
publisher Имя издателя обработчика расширений. строка (обязательно)
Параметры Общедоступные параметры расширения в формате JSON. Для Bicep можно использовать функцию any().
тип Указывает тип расширения; пример : CustomScriptExtension. строка (обязательно)
typeHandlerVersion Указывает версию обработчика скрипта. строка (обязательно)

VmManagedIdentity

Имя Описание Значение
userAssignedIdentities Список удостоверений пользователей, связанных с масштабируемым набором виртуальных машин в типе узла. Каждая запись будет иметь идентификаторы ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". string[]

VaultSecretGroup

Имя Описание Значение
sourceVault Относительный URL-адрес Key Vault, содержащий все сертификаты в VaultCertificates. SubResource (обязательно)
vaultCertificates Список ссылок на хранилище ключей в SourceVault, которые содержат сертификаты. VaultCertificate[] (обязательно)

SubResource

Имя Описание Значение
идентификатор Идентификатор ресурса Azure. строка

VaultCertificate

Имя Описание Значение
certificateStore Для виртуальных машин Windows указывает хранилище сертификатов на виртуальной машине, в которую следует добавить сертификат. Указанное хранилище сертификатов неявно находится в учетной записи LocalMachine.

Для виртуальных машин Linux файл сертификата помещается в каталог /var/lib/waagent с именем файла {UppercaseThumbprint}.crt для файла сертификата X509 и {UppercaseThumbprint}.prv для закрытого ключа. Оба этих файла имеют формат PEM.
строка (обязательно)
certificateUrl Это URL-адрес сертификата, который был отправлен в Key Vault в качестве секрета. Сведения о добавлении секрета в Key Vault см. в статье Добавление ключа или секрета в хранилище ключей. В этом случае сертификат должен иметь кодировку Base64 следующего объекта JSON, который закодирован в UTF-8:

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
строка (обязательно)

NodeTypeSku

Имя Описание Значение
Емкость Количество узлов в типе узла.

Если он присутствует в запросе, он переопределит properties.vmInstanceCount.
int (обязательно)

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647
name Имя SKU.

Имя создается внутренним образом и используется в сценариях автоматического масштабирования.
Свойство не позволяет изменять значения, отличные от созданных.
Чтобы избежать ошибок развертывания, опустите свойство .
строка
Уровень Указывает уровень типа узла.

Возможные значения:
Standard Edition
строка

Определение ресурса шаблона ARM

Тип ресурса managedClusters/nodeTypes можно развернуть с помощью операций, предназначенных для:

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

Формат ресурсов

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters/nodeTypes, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "apiVersion": "2021-07-01-preview",
  "name": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "properties": {
    "applicationPorts": {
      "endPort": "int",
      "startPort": "int"
    },
    "capacities": {
      "{customized property}": "string"
    },
    "dataDiskSizeGB": "int",
    "dataDiskType": "string",
    "ephemeralPorts": {
      "endPort": "int",
      "startPort": "int"
    },
    "frontendConfigurations": [
      {
        "ipAddressType": "string",
        "loadBalancerBackendAddressPoolId": "string",
        "loadBalancerInboundNatPoolId": "string"
      }
    ],
    "isPrimary": "bool",
    "isStateless": "bool",
    "multiplePlacementGroups": "bool",
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRanges": [ "string" ]
      }
    ],
    "placementProperties": {
      "{customized property}": "string"
    },
    "vmExtensions": [
      {
        "name": "string",
        "properties": {
          "autoUpgradeMinorVersion": "bool",
          "forceUpdateTag": "string",
          "protectedSettings": {},
          "provisionAfterExtensions": [ "string" ],
          "publisher": "string",
          "settings": {},
          "type": "string",
          "typeHandlerVersion": "string"
        }
      }
    ],
    "vmImageOffer": "string",
    "vmImagePublisher": "string",
    "vmImageSku": "string",
    "vmImageVersion": "string",
    "vmInstanceCount": "int",
    "vmManagedIdentity": {
      "userAssignedIdentities": [ "string" ]
    },
    "vmSecrets": [
      {
        "sourceVault": {
          "id": "string"
        },
        "vaultCertificates": [
          {
            "certificateStore": "string",
            "certificateUrl": "string"
          }
        ]
      }
    ],
    "vmSize": "string"
  }
}

Значения свойств

managedClusters/nodeTypes

Имя Описание Значение
тип Тип ресурса Microsoft.ServiceFabric/managedClusters/nodeTypes
версия_API Версия API ресурсов '2021-07-01-preview'
name имя ресурса.

Узнайте, как задать имена и типы для дочерних ресурсов в шаблонах JSON ARM.
строка (обязательно)
tags Теги ресурсов Azure. Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Номер SKU типа узла. NodeTypeSku
properties Свойства типа узла NodeTypeProperties

NodeTypeProperties

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов у узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в ГБ. int (обязательно)
DataDiskType Тип диска управляемых данных. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
frontendConfigurations Указывает, что тип узла использует собственные внешние конфигурации вместо конфигурации по умолчанию для кластера. Этот параметр можно указать только для типов узлов, не являющихся первичными, и его нельзя добавить или удалить после создания типа узла. FrontendConfiguration[]
isPrimary Указывает, что системные службы Service Fabric для кластера будут выполняться на этом типе узла. Этот параметр нельзя изменить после создания типа узла. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multiplePlacementGroups Указывает, может ли масштабируемый набор, связанный с типом узла, состоять из нескольких групп размещения. bool
networkSecurityRules Правила безопасности сети для этого типа узла. Этот параметр можно указать только для типов узлов, настроенных с помощью интерфейсных конфигураций. NetworkSecurityRule[]
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypePropertiesPlacementProperties
vmExtensions Набор расширений, которые должны быть установлены на виртуальных машинах. VmssExtension[]
vmImageOffer Тип предложения образа Azure Виртуальные машины Marketplace. Например, UbuntuServer или WindowsServer. строка
vmImagePublisher Издатель образа Azure Виртуальные машины Marketplace. Например, Canonical или MicrosoftWindowsServer. строка
vmImageSku Номер SKU образа Azure Виртуальные машины Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. строка
vmImageVersion Версия образа Azure Виртуальные машины Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение latest. Если этот параметр опущен, значение по умолчанию — latest. строка
vmInstanceCount Количество узлов в типе узла.

Значения:
-1 — используется при настройке правил автомасштабирования или определении sku.capacity
0 — не поддерживается
}0 — используется для масштабирования вручную.
int (обязательно)

Ограничения:
Максимальное значение = 2147483647
vmManagedIdentity Удостоверения, назначаемые масштабируемму набору виртуальных машин в типе узла. VmManagedIdentity
vmSecrets Секреты для установки на виртуальных машинах. VaultSecretGroup[]
vmSize Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Например, Standard_D3. строка

EndpointRangeDescription

Имя Описание Значение
endPort Конечный порт диапазона портов int (обязательно)
startPort Начальный порт диапазона портов int (обязательно)

NodeTypePropertiesCapacities

Имя Описание Значение
{настроенное свойство} строка

FrontendConfiguration

Имя Описание Значение
ipAddressType Тип IP-адреса этой интерфейсной конфигурации. Если этот параметр опущен, значение по умолчанию — IPv4. IPv4
IPv6
loadBalancerBackendAddressPoolId Идентификатор ресурса Load Balancer серверного пула адресов, с которым связаны экземпляры виртуальных машин типа узла. Формат идентификатора ресурса : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}. строка
loadBalancerInboundNatPoolId Идентификатор ресурса Load Balancer пула NAT для входящего трафика, с которым связаны экземпляры виртуальных машин типа узла. Идентификатор ресурса имеет формат "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}". строка

NetworkSecurityRule

Имя Описание Значение
access Сетевой трафик разрешен или запрещен. "allow"
Deny (обязательно)
description Описание правила безопасности сети. строка
destinationAddressPrefixes Префиксы адресов назначения. Диапазоны CIDR или целевых IP-адресов. string[]
destinationPortRanges Диапазоны портов назначения. string[]
direction Направление правил безопасности сети. "inbound"
outbound (обязательно)
name Имя правила безопасности сети. строка (обязательно)
priority Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для Поставщика ресурсов Service Fabric ManagerКластера ресурсов. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже номер приоритета, тем выше приоритет правила. int (обязательно)

Ограничения:
Минимальное значение = 1000
Максимальное значение = 3000
protocol Сетевой протокол, к которому применяется данное правило. 'ah'
'esp'
'http'
'https'
'icmp'
"tcp"
"udp" (обязательно)
sourceAddressPrefixes Диапазоны CIDR или исходных IP-адресов. string[]
sourcePortRanges Диапазоны исходных портов. string[]

NodeTypePropertiesPlacementProperties

Имя Описание Значение
{настраиваемое свойство} строка

VmssExtension

Имя Описание Значение
name Имя модуля. string (обязательно)
properties Описывает свойства расширения масштабируемого набора виртуальных машин. VmssExtensionProperties (обязательно)

VmssExtensionProperties

Имя Описание Значение
autoUpgradeMinorVersion Указывает, должно ли расширение использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
forceUpdateTag Если указано значение, отличное от предыдущего, обработчик расширений будет вынужден обновиться, даже если конфигурация расширения не изменилась. строка
protectedSettings Расширение может содержать protectedSettings или protectedSettingsFromKeyVault или вообще не иметь защищенных параметров.
provisionAfterExtensions Коллекция имен расширений, после которых необходимо подготовить это расширение. string[]
publisher Имя издателя обработчика расширений. string (обязательно)
Параметры Общедоступные параметры расширения в формате JSON.
тип Указывает тип расширения; пример : CustomScriptExtension. string (обязательно)
typeHandlerVersion Указывает версию обработчика скрипта. string (обязательно)

VmManagedIdentity

Имя Описание Значение
userAssignedIdentities Список удостоверений пользователей, связанных с масштабируемым набором виртуальных машин в типе узла. Каждая запись будет иметь идентификаторы ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". string[]

VaultSecretGroup

Имя Описание Значение
sourceVault Относительный URL-адрес Key Vault, содержащий все сертификаты в VaultCertificates. SubResource (обязательно)
vaultCertificates Список ссылок на хранилища ключей в SourceVault, которые содержат сертификаты. VaultCertificate[] (обязательно)

SubResource

Имя Описание Значение
идентификатор Идентификатор ресурса Azure. строка

VaultCertificate

Имя Описание Значение
certificateStore Для виртуальных машин Windows указывает хранилище сертификатов на виртуальной машине, в которое необходимо добавить сертификат. Указанное хранилище сертификатов неявно находится в учетной записи LocalMachine.

Для виртуальных машин Linux файл сертификата помещается в каталог /var/lib/waagent с именем файла {UppercaseThumbprint}.crt для файла сертификата X509 и {UppercaseThumbprint}.prv для закрытого ключа. Оба этих файла имеют формат PEM.
string (обязательно)
certificateUrl Это URL-адрес сертификата, переданного в Key Vault в виде секрета. Сведения о добавлении секрета в Key Vault см. в статье Добавление ключа или секрета в хранилище ключей. В этом случае сертификат должен иметь кодировку Base64 следующего объекта JSON, который закодирован в UTF-8:

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
строка (обязательно)

NodeTypeSku

Имя Описание Значение
Емкость Количество узлов в типе узла.

Если он присутствует в запросе, он переопределит properties.vmInstanceCount.
int (обязательно)

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647
name Имя SKU.

Имя создается внутренним образом и используется в сценариях автоматического масштабирования.
Свойство не позволяет изменять значения, отличные от созданных.
Чтобы избежать ошибок развертывания, опустите свойство .
строка
Уровень Указывает уровень типа узла.

Возможные значения:
Standard Edition
строка

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса managedClusters/nodeTypes можно развернуть с помощью операций, предназначенных для:

  • Группы ресурсов

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

Формат ресурсов

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters/nodeTypes, добавьте в шаблон следующую terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview"
  name = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      applicationPorts = {
        endPort = int
        startPort = int
      }
      capacities = {
        {customized property} = "string"
      }
      dataDiskSizeGB = int
      dataDiskType = "string"
      ephemeralPorts = {
        endPort = int
        startPort = int
      }
      frontendConfigurations = [
        {
          ipAddressType = "string"
          loadBalancerBackendAddressPoolId = "string"
          loadBalancerInboundNatPoolId = "string"
        }
      ]
      isPrimary = bool
      isStateless = bool
      multiplePlacementGroups = bool
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRanges = [
            "string"
          ]
        }
      ]
      placementProperties = {
        {customized property} = "string"
      }
      vmExtensions = [
        {
          name = "string"
          properties = {
            autoUpgradeMinorVersion = bool
            forceUpdateTag = "string"
            provisionAfterExtensions = [
              "string"
            ]
            publisher = "string"
            type = "string"
            typeHandlerVersion = "string"
          }
        }
      ]
      vmImageOffer = "string"
      vmImagePublisher = "string"
      vmImageSku = "string"
      vmImageVersion = "string"
      vmInstanceCount = int
      vmManagedIdentity = {
        userAssignedIdentities = [
          "string"
        ]
      }
      vmSecrets = [
        {
          sourceVault = {
            id = "string"
          }
          vaultCertificates = [
            {
              certificateStore = "string"
              certificateUrl = "string"
            }
          ]
        }
      ]
      vmSize = "string"
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Значения свойств

managedClusters/nodeTypes

Имя Описание Значение
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview"
name имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: managedClusters
tags Теги ресурсов Azure. Словарь имен и значений тегов.
sku Номер SKU типа узла. NodeTypeSku
properties Свойства типа узла NodeTypeProperties

NodeTypeProperties

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов у узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в ГБ. int (обязательно)
DataDiskType Тип диска управляемых данных. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
frontendConfigurations Указывает, что тип узла использует собственные внешние конфигурации вместо конфигурации по умолчанию для кластера. Этот параметр можно указать только для типов узлов, не являющихся первичными, и его нельзя добавить или удалить после создания типа узла. FrontendConfiguration[]
isPrimary Указывает, что системные службы Service Fabric для кластера будут выполняться на этом типе узла. Этот параметр нельзя изменить после создания типа узла. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multiplePlacementGroups Указывает, может ли масштабируемый набор, связанный с типом узла, состоять из нескольких групп размещения. bool
networkSecurityRules Правила безопасности сети для этого типа узла. Этот параметр можно указать только для типов узлов, настроенных с помощью интерфейсных конфигураций. NetworkSecurityRule[]
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypePropertiesPlacementProperties
vmExtensions Набор расширений, которые должны быть установлены на виртуальных машинах. VmssExtension[]
vmImageOffer Тип предложения образа Azure Виртуальные машины Marketplace. Например, UbuntuServer или WindowsServer. строка
vmImagePublisher Издатель образа Azure Виртуальные машины Marketplace. Например, Canonical или MicrosoftWindowsServer. строка
vmImageSku Номер SKU образа Azure Виртуальные машины Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. строка
vmImageVersion Версия образа Azure Виртуальные машины Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение latest. Если этот параметр опущен, по умолчанию используется значение latest. строка
vmInstanceCount Количество узлов в типе узла.

Значения:
-1 — используется при настройке правил автоматического масштабирования или определении sku.capacity
0 — не поддерживается
}0 — используется для масштабирования вручную.
int (обязательно)

Ограничения:
Максимальное значение = 2147483647
vmManagedIdentity Удостоверения для назначения масштабируемого набора виртуальных машин в типе узла. VmManagedIdentity
vmSecrets Секреты для установки на виртуальных машинах. VaultSecretGroup[]
vmSize Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Например, Standard_D3. строка

EndpointRangeDescription

Имя Описание Значение
endPort Конечный порт диапазона портов int (обязательно)
startPort Начальный порт диапазона портов int (обязательно)

NodeTypePropertiesCapacities

Имя Описание Значение
{настраиваемое свойство} строка

FrontendConfiguration

Имя Описание Значение
ipAddressType Тип IP-адреса этой интерфейсной конфигурации. Если этот параметр опущен, значение по умолчанию — IPv4. "IPv4"
"IPv6"
loadBalancerBackendAddressPoolId Идентификатор ресурса Load Balancer серверного пула адресов, с которым связаны экземпляры виртуальных машин типа узла. Формат идентификатора ресурса: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}. строка
loadBalancerInboundNatPoolId Идентификатор ресурса Load Balancer пула NAT для входящего трафика, с которым связаны экземпляры виртуальных машин типа узла. Формат идентификатора ресурса : "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}". строка

NetworkSecurityRule

Имя Описание Значение
access Сетевой трафик разрешен или запрещен. "allow"
"deny" (обязательно)
description Описание правила безопасности сети. строка
destinationAddressPrefixes Префиксы адреса назначения. Диапазоны IP-адресов CIDR или назначения. string[]
destinationPortRanges Диапазоны портов назначения. string[]
direction Направление правила безопасности сети. "inbound"
"outbound" (обязательно)
name Имя правила безопасности сети. string (обязательно)
priority Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для поставщика ресурсов Service Fabric ManagerCluster. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже номер приоритета, тем выше приоритет правила. int (обязательно)

Ограничения:
Минимальное значение = 1000
Максимальное значение = 3000
protocol Сетевой протокол, к которому применяется данное правило. "ah"
"esp"
"http"
"https"
"icmp"
"tcp"
"udp" (обязательно)
sourceAddressPrefixes Диапазоны CIDR или исходных IP-адресов. string[]
sourcePortRanges Диапазоны исходных портов. string[]

NodeTypePropertiesPlacementProperties

Имя Описание Значение
{настроенное свойство} строка

VmssExtension

Имя Описание Значение
name Имя модуля. строка (обязательно)
properties Описывает свойства расширения масштабируемого набора виртуальных машин. VmssExtensionProperties (обязательно)

VmssExtensionProperties

Имя Описание Значение
autoUpgradeMinorVersion Указывает, должно ли расширение использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. bool
forceUpdateTag Если указано значение и отличается от предыдущего, обработчик расширений будет принудительно обновляться, даже если конфигурация расширения не изменилась. строка
protectedSettings Расширение может содержать protectedSettings или protectedSettingsFromKeyVault или вообще не иметь защищенных параметров.
provisionAfterExtensions Коллекция имен расширений, после которых необходимо подготовить это расширение. string[]
publisher Имя издателя обработчика расширений. строка (обязательно)
Параметры Общедоступные параметры расширения в формате JSON.
тип Указывает тип расширения; пример : CustomScriptExtension. строка (обязательно)
typeHandlerVersion Указывает версию обработчика скрипта. строка (обязательно)

VmManagedIdentity

Имя Описание Значение
userAssignedIdentities Список удостоверений пользователей, связанных с масштабируемым набором виртуальных машин в типе узла. Каждая запись будет иметь идентификаторы ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". string[]

VaultSecretGroup

Имя Описание Значение
sourceVault Относительный URL-адрес Key Vault, содержащий все сертификаты в VaultCertificates. SubResource (обязательно)
vaultCertificates Список ссылок на хранилище ключей в SourceVault, которые содержат сертификаты. VaultCertificate[] (обязательно)

SubResource

Имя Описание Значение
идентификатор Идентификатор ресурса Azure. строка

VaultCertificate

Имя Описание Значение
certificateStore Для виртуальных машин Windows указывает хранилище сертификатов на виртуальной машине, в которую следует добавить сертификат. Указанное хранилище сертификатов неявно находится в учетной записи LocalMachine.

Для виртуальных машин Linux файл сертификата помещается в каталог /var/lib/waagent с именем файла {UppercaseThumbprint}.crt для файла сертификата X509 и {UppercaseThumbprint}.prv для закрытого ключа. Оба этих файла имеют формат PEM.
строка (обязательно)
certificateUrl Это URL-адрес сертификата, который был отправлен в Key Vault в качестве секрета. Сведения о добавлении секрета в Key Vault см. в статье Добавление ключа или секрета в хранилище ключей. В этом случае сертификат должен иметь кодировку Base64 следующего объекта JSON, который закодирован в UTF-8:

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
строка (обязательно)

NodeTypeSku

Имя Описание Значение
Емкость Количество узлов в типе узла.

Если он присутствует в запросе, он переопределит properties.vmInstanceCount.
int (обязательно)

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647
name Имя SKU.

Имя создается внутренним образом и используется в сценариях автоматического масштабирования.
Свойство не позволяет изменять значения, отличные от созданных.
Чтобы избежать ошибок развертывания, опустите свойство .
строка
Уровень Указывает уровень типа узла.

Возможные значения:
Standard Edition
строка