Поделиться через

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'
  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(Azure.Bicep.Types.Concrete.AnyType)
          provisionAfterExtensions: [
            'string'
          ]
          publisher: 'string'
          settings: any(Azure.Bicep.Types.Concrete.AnyType)
          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'
  }
  tags: {
    {customized property}: 'string'
  }
}

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

EndpointRangeDescription

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

FrontendConfiguration

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

ManagedProxyResourceTags

Имя Описание Ценность

Microsoft.ServiceFabric/managedClusters/nodeTypes

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

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

NetworkSecurityRule

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

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

NodeTypeProperties

Имя Описание Ценность
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
Мощности Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги для понимания объема ресурсов узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в GBS. 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 Virtual Machines Marketplace. Например, UbuntuServer или WindowsServer. струна
vmImagePublisher Издатель образа Azure Virtual Machines Marketplace. Например, Canonical или MicrosoftWindowsServer. струна
vmImageSku SKU образа Azure Virtual Machines Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. струна
vmImageVersion Версия образа Azure Virtual Machines Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна
vmInstanceCount Количество узлов в типе узла.

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

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

NodeTypePropertiesCapacities

Имя Описание Ценность

NodeTypePropertiesPlacementPropertiesProperties

Имя Описание Ценность

NodeTypeSku

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

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

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

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

Возможные значения:
категории "Стандартный"		 струна

SubResource

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

VaultCertificate

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

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

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

VaultSecretGroup

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

VmManagedIdentity

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

VmssExtension

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

VmssExtensionProperties

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

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

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

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

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

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

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "apiVersion": "2021-07-01-preview",
  "name": "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"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

EndpointRangeDescription

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

FrontendConfiguration

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

ManagedProxyResourceTags

Имя Описание Ценность

Microsoft.ServiceFabric/managedClusters/nodeTypes

Имя Описание Ценность
apiVersion Версия API '2021-07-01-preview'
имя Имя ресурса строка (обязательно)
свойства Свойства типа узла NodeTypeProperties
SKU SKU типа узла. NodeTypeSku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters/nodeTypes"

NetworkSecurityRule

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

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

NodeTypeProperties

Имя Описание Ценность
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
Мощности Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги для понимания объема ресурсов узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в GBS. 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 Virtual Machines Marketplace. Например, UbuntuServer или WindowsServer. струна
vmImagePublisher Издатель образа Azure Virtual Machines Marketplace. Например, Canonical или MicrosoftWindowsServer. струна
vmImageSku SKU образа Azure Virtual Machines Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. струна
vmImageVersion Версия образа Azure Virtual Machines Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна
vmInstanceCount Количество узлов в типе узла.

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

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

NodeTypePropertiesCapacities

Имя Описание Ценность

NodeTypePropertiesPlacementPropertiesProperties

Имя Описание Ценность

NodeTypeSku

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

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

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

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

Возможные значения:
категории "Стандартный"		 струна

SubResource

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

VaultCertificate

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

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

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

VaultSecretGroup

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

VmManagedIdentity

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

VmssExtension

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

VmssExtensionProperties

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

Определение ресурса 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"
  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"
            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"
    }
  })
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

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

EndpointRangeDescription

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

FrontendConfiguration

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

ManagedProxyResourceTags

Имя Описание Ценность

Microsoft.ServiceFabric/managedClusters/nodeTypes

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

NetworkSecurityRule

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

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

NodeTypeProperties

Имя Описание Ценность
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
Мощности Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги для понимания объема ресурсов узла. NodeTypePropertiesCapacities
dataDiskSizeGB Размер диска для каждой виртуальной машины в типе узла в GBS. 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 Virtual Machines Marketplace. Например, UbuntuServer или WindowsServer. струна
vmImagePublisher Издатель образа Azure Virtual Machines Marketplace. Например, Canonical или MicrosoftWindowsServer. струна
vmImageSku SKU образа Azure Virtual Machines Marketplace. Например, 14.04.0-LTS или 2012-R2-Datacenter. струна
vmImageVersion Версия образа Azure Virtual Machines Marketplace. Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна
vmInstanceCount Количество узлов в типе узла.

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

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

NodeTypePropertiesCapacities

Имя Описание Ценность

NodeTypePropertiesPlacementPropertiesProperties

Имя Описание Ценность

NodeTypeSku

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

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

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

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

Возможные значения:
категории "Стандартный"		 струна

SubResource

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

VaultCertificate

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

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

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

VaultSecretGroup

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

VmManagedIdentity

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

VmssExtension

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

VmssExtensionProperties

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