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

Кластеры Microsoft.ServiceFabric 2020-12-01-preview

  • Статья

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

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

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

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

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

resource symbolicname 'Microsoft.ServiceFabric/clusters@2020-12-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    addOnFeatures: [
      'string'
    ]
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    certificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    clientCertificateCommonNames: [
      {
        certificateCommonName: 'string'
        certificateIssuerThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clientCertificateThumbprints: [
      {
        certificateThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clusterCodeVersion: 'string'
    diagnosticsStorageAccountConfig: {
      blobEndpoint: 'string'
      protectedAccountKeyName: 'string'
      protectedAccountKeyName2: 'string'
      queueEndpoint: 'string'
      storageAccountName: 'string'
      tableEndpoint: 'string'
    }
    eventStoreServiceEnabled: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        isPrimary: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    reverseProxyCertificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    vmImage: 'string'
  }
}

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

clusters

Имя Описание Значение
name имя ресурса. string (обязательно)

Ограничение символов: 4-23

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы. Закачивается строчной буквой или цифрой.
location Расположение ресурса Azure. string (обязательно)
tags Теги ресурсов Azure. Словарь имен и значений тегов. См . раздел Теги в шаблонах
properties Свойства ресурса кластера Свойства clusterProperties

Свойства clusterProperties

Имя Описание Значение
addOnFeatures Список дополнительных функций, которые необходимо включить в кластере. Массив строк, содержащий любой из:
BackupRestoreService
"DnsService"
'RepairManager'
ResourceMonitorService
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
сертификат Сертификат, используемый для защиты кластера. Предоставленный сертификат будет использоваться для обеспечения безопасности узла в кластере, SSL-сертификата для конечной точки управления кластером и клиента администратора по умолчанию. CertificateDescription
certificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
clientCertificateCommonNames Список сертификатов клиента, на которые ссылается общее имя, на которые разрешено управлять кластером. ClientCertificateCommonName[]
clientCertificateThumbprints Список сертификатов клиента, на которые ссылается отпечаток, на которые разрешено управлять кластером. ClientCertificateThumbprint[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство может быть установлено только в том случае, если параметр upgradeMode имеет значение "Вручную". Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. строка
diagnosticsStorageAccountConfig Сведения об учетной записи хранения для хранения журналов диагностики Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
managementEndpoint Конечная точка управления HTTP кластера. string (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
reliabilityLevel Уровень надежности задает реплика заданный размер системных служб. Узнайте о ReliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика задано значение 1. Этот параметр следует использовать только для тестовых кластеров.
— Бронзовый — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом реплика 5.
— Золотой — запуск системных служб с целевым числом реплика 7.
— Platinum — запуск системных служб с целевым числом реплика установленным числом 9.		 "Бронза"
"Золотой"
"Нет"
"Платина"
'Silver'
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. CertificateDescription
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
upgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric.

— Автоматический — кластер будет автоматически обновлен до последней версии среды выполнения Service Fabric, как только он станет доступен.
— Вручную — кластер не будет автоматически обновлен до последней версии среды выполнения Service Fabric. Кластер обновляется путем установки свойства clusterCodeVersion в кластерном ресурсе.		 "Автоматический"
"Manual"
vmImage Образ виртуальной машины VMSS настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка

ApplicationTypeVersionsCleanupPolicy

Имя Описание Значение
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения для сохранения. int (обязательно)

Ограничения:
Минимальное значение = 0

AzureActiveDirectory

Имя Описание Значение
clientApplication Идентификатор клиентского приложения Azure Active Directory. строка
clusterApplication Идентификатор приложения кластера Azure Active Directory. строка
tenantId Идентификатор клиента Azure Active Directory. строка

CertificateDescription

Имя Описание Значение
thumbprint Отпечаток первичного сертификата. string (обязательно)
thumbprintSecondary Отпечаток дополнительного сертификата. строка
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"Мой"
"Корень"
'TrustedPeople'
'TrustedPublisher'

ServerCertificateCommonNames

Имя Описание Значение
commonNames Список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonName[]
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"Мой"
"Корень"
'TrustedPeople'
'TrustedPublisher'

ServerCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата сервера. string (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата сервера. string (обязательно)

ClientCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата клиента. string (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата клиента. string (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

ClientCertificateThumbprint

Имя Описание Значение
certificateThumbprint Отпечаток сертификата клиента. string (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

DiagnosticsStorageAccountConfig

Имя Описание Значение
blobEndpoint Конечная точка BLOB-объекта учетной записи хранения Azure. string (обязательно)
protectedAccountKeyName Защищенное диагностика имя ключа хранилища. string (обязательно)
protectedAccountKeyName2 Дополнительный защищенный диагностика имя ключа хранилища. При смене одного из ключей учетной записи хранения кластер будет использовать другой. строка
queueEndpoint Конечная точка очереди учетной записи хранения Azure. string (обязательно)
storageAccountName Имя учетной записи хранения Azure. string (обязательно)
tableEndpoint Конечная точка таблицы учетной записи хранения Azure. string (обязательно)

SettingsSectionDescription

Имя Описание Значение
name Имя раздела параметров структуры. string (обязательно)
параметры Коллекция параметров в разделе. SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

Имя Описание Значение
name Имя параметра параметра структуры. string (обязательно)
значение Значение параметра параметра параметра fabric. string (обязательно)

NodeTypeDescription

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначает порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов имеет узел. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Порт конечной точки управления кластером TCP. int (обязательно)
durabilityLevel Уровень устойчивости типа узла. Узнайте о Программе устойчивостиLevel.

- Бронза - нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры могут быть приостановлены на 10 минут для каждого определяемого пользователем типа.
— Золотой — задания инфраструктуры можно приостановить на 2 часа для каждого UD. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.		 "Бронза"
"Золотой"
'Silver'
ephemeralPorts Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как основной. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
name Имя типа узла. строка (обязательно)
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount Количество узлов в типе узла. Это число должно соответствовать свойству capacity в соответствующем ресурсе VirtualMachineScaleSet. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

NodeTypeDescriptionPlacementProperties

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

ClusterUpgradePolicy

Имя Описание Значение
deltaHealthPolicy Политика разностной работоспособности кластера, используемая при обновлении кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthCheckRetryTimeout Время повторной оценки работоспособности, когда приложение или кластер неработоспособны до отката обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms. строка (обязательно)
healthCheckStableDuration Период времени, в течение которого приложение или кластер должен оставаться работоспособным, прежде чем процесс обновления перейдет к следующему домену обновления. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. строка (обязательно)
healthCheckWaitDuration Время ожидания после завершения обновления домена перед выполнением проверок работоспособности. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. строка (обязательно)
healthPolicy Политика работоспособности кластера, используемая при обновлении кластера. ClusterHealthPolicy (обязательно)
upgradeDomainTimeout Время, в течение которого каждый домен обновления должен завершиться до отката обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms. строка (обязательно)
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем. По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа. Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms. строка (обязательно)
upgradeTimeout Время, в течение которого общее обновление необходимо завершить до отката обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms. строка (обязательно)

ClusterUpgradeDeltaHealthPolicy

Имя Описание Значение
applicationDeltaHealthPolicies Определяет карту политики разностной работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей при обновлении кластера. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Максимально допустимый процент снижения работоспособности приложений, разрешенный во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включены в этот параметр.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyNodes Максимальный процент неработоспособных узлов, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes Максимальный процент неработоспособных узлов домена обновления, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов домена обновления в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку для всех доменов обновления, завершивших обновление, находится ли состояние этих доменов в допустимых пределах.
 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationDeltaHealthPolicyMap

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

ApplicationDeltaHealthPolicy

Имя Описание Значение
defaultServiceTypeDeltaHealthPolicy Политика разностной работоспособности, используемая по умолчанию для оценки работоспособности типа службы при обновлении кластера. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Сопоставление с политикой разностной работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

Имя Описание Значение
maxPercentDeltaUnhealthyServices Максимально допустимый процент снижения работоспособности служб, разрешенный во время обновления кластера.
Разница измеряется между состоянием служб в начале обновления и состоянием служб на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeDeltaHealthPolicyMap

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

ClusterHealthPolicy

Имя Описание Значение
applicationHealthPolicies Определяет схему политики работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных приложений, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере одно неработоспособное приложение, то состояние работоспособности оценивается как "Warning".
Это значение вычисляется путем деления числа неработоспособных приложений на общее число экземпляров приложения в кластере, за исключением приложений, типы которых указаны в ApplicationTypeHealthPolicyMap.
Расчет округляется: на небольшом количестве приложений допускается один сбой. Значение в процентах по умолчанию равняется нулю.		 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyNodes Максимально допустимый процент неработоспособных узлов, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных узлов, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных узлов, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере один неработоспособный узел, то состояние работоспособности оценивается как "Warning".
Это процентное значение вычисляется путем деления числа неработоспособных узлов за общее число узлов в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.

В крупных кластерах всегда есть отключенные узлы или узлы в состоянии восстановления. Следует учитывать это при настройке параметра.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Имя Описание Значение
maxPercentUnhealthyServices Максимальный процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным. INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeHealthPolicyMap

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

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
Развертывание кластера Ubuntu Service Fabric с 5 узлами

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 5 узлами под управлением Ubuntu на виртуальной машине Standard_D2_V2 размера.
Развертывание защищенного кластера с 5 узлами

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 5 узлами под управлением Windows Server 2019 Datacenter на виртуальной машине Standard_D2_v2 размера.
Развертывание безопасного кластера типа 3 узла с включенными группами безопасности сети

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 3 узлами под управлением Windows Server 2016 Data Center на виртуальных машинах Standard_D2 размера. Этот шаблон позволяет управлять входящим и исходящим сетевым трафиком с помощью групп безопасности сети.

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

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

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

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

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

{
  "type": "Microsoft.ServiceFabric/clusters",
  "apiVersion": "2020-12-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "addOnFeatures": [ "string" ],
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "certificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "clientCertificateCommonNames": [
      {
        "certificateCommonName": "string",
        "certificateIssuerThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clientCertificateThumbprints": [
      {
        "certificateThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clusterCodeVersion": "string",
    "diagnosticsStorageAccountConfig": {
      "blobEndpoint": "string",
      "protectedAccountKeyName": "string",
      "protectedAccountKeyName2": "string",
      "queueEndpoint": "string",
      "storageAccountName": "string",
      "tableEndpoint": "string"
    },
    "eventStoreServiceEnabled": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "isPrimary": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "reverseProxyCertificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "vmImage": "string"
  }
}

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

clusters

Имя Описание Значение
тип Тип ресурса Microsoft.ServiceFabric/clusters
версия_API Версия API ресурсов '2020-12-01-preview'
name имя ресурса. строка (обязательно)

Ограничение символов: 4–23

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы. Закачивается строчной буквой или цифрой.
location Расположение ресурса Azure. строка (обязательно)
tags Теги ресурсов Azure. Словарь имен и значений тегов. См . раздел Теги в шаблонах
properties Свойства ресурса кластера Свойства кластера

Свойства кластера

Имя Описание Значение
addOnFeatures Список дополнительных функций, которые необходимо включить в кластере. Массив строк, содержащий любой из:
BackupRestoreService
DnsService
RepairManager
ResourceMonitorService
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
сертификат Сертификат, используемый для защиты кластера. Предоставленный сертификат будет использоваться для обеспечения безопасности узла в кластере, SSL-сертификат для конечной точки управления кластером и клиента администратора по умолчанию. Описание сертификата
certificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
clientCertificateCommonNames Список сертификатов клиента, на которые ссылается общее имя, на которые разрешено управлять кластером. ClientCertificateCommonName[]
clientCertificateThumbprints Список сертификатов клиента, на которые ссылается отпечаток, на которые разрешено управлять кластером. ClientCertificateThumbprint[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство может быть установлено только в том случае, если параметр upgradeMode имеет значение "Вручную". Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. строка
diagnosticsStorageAccountConfig Сведения об учетной записи хранения для хранения журналов диагностики Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
managementEndpoint Конечная точка управления HTTP кластера. string (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
reliabilityLevel Уровень надежности задает реплика заданный размер системных служб. Узнайте о ReliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика задано значение 1. Этот параметр следует использовать только для тестовых кластеров.
— Бронзовый — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом реплика 5.
— Золотой — запуск системных служб с целевым числом реплика 7.
— Platinum — запуск системных служб с целевым числом реплика установленным числом 9.		 "Бронза"
"Золотой"
"Нет"
"Платина"
'Silver'
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. CertificateDescription
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
upgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric.

— Автоматический — кластер будет автоматически обновлен до последней версии среды выполнения Service Fabric, как только он станет доступен.
— Вручную — кластер не будет автоматически обновлен до последней версии среды выполнения Service Fabric. Кластер обновляется путем установки свойства clusterCodeVersion в кластерном ресурсе.		 "Автоматический"
"Manual"
vmImage Образ виртуальной машины VMSS настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка

ApplicationTypeVersionsCleanupPolicy

Имя Описание Значение
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения для сохранения. int (обязательно)

Ограничения:
Минимальное значение = 0

AzureActiveDirectory

Имя Описание Значение
clientApplication Идентификатор клиентского приложения Azure Active Directory. строка
clusterApplication Идентификатор приложения кластера Azure Active Directory. строка
tenantId Идентификатор клиента Azure Active Directory. строка

CertificateDescription

Имя Описание Значение
thumbprint Отпечаток первичного сертификата. string (обязательно)
thumbprintSecondary Отпечаток дополнительного сертификата. строка
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"Мой"
"Корень"
'TrustedPeople'
'TrustedPublisher'

ServerCertificateCommonNames

Имя Описание Значение
commonNames Список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonName[]
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"Мой"
"Root"
TrustedPeople
TrustedPublisher

ServerCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата сервера. строка (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата сервера. строка (обязательно)

ClientCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата клиента. строка (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата клиента. строка (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

ClientCertificateThumbprint

Имя Описание Значение
certificateThumbprint Отпечаток сертификата клиента. строка (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

DiagnosticsStorageAccountConfig

Имя Описание Значение
blobEndpoint Конечная точка BLOB-объекта учетной записи хранения Azure. строка (обязательно)
protectedAccountKeyName Защищенное диагностика имя ключа хранилища. строка (обязательно)
protectedAccountKeyName2 Вторичная защищенная диагностика имя ключа хранилища. Если один из ключей учетной записи хранения сменен, кластер откатится к использованию другого. строка
queueEndpoint Конечная точка очереди учетной записи хранения Azure. строка (обязательно)
storageAccountName Имя учетной записи хранения Azure. строка (обязательно)
tableEndpoint Конечная точка таблицы учетной записи хранения Azure. строка (обязательно)

SettingsSectionDescription

Имя Описание Значение
name Имя раздела параметров структуры. строка (обязательно)
параметры Коллекция параметров в разделе . SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

Имя Описание Значение
name Имя параметра параметра структуры. строка (обязательно)
значение Значение параметра параметра структуры. строка (обязательно)

NodeTypeDescription

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначил порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов у узла. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Порт конечной точки управления кластером TCP. int (обязательно)
durabilityLevel Уровень устойчивости типа узла. Узнайте о durabilityLevel.

- Бронза - нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры могут быть приостановлены на 10 минут для каждого определяемого пользователем типа.
— Золотой — задания инфраструктуры можно приостановить на 2 часа для каждого UD. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.		 "Бронза"
"Золотой"
'Silver'
ephemeralPorts Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как первичный. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
name Имя типа узла. string (обязательно)
свойства placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочая нагрузка). Свойства NodeTypeDescriptionPlacement
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount Количество узлов в типе узла. Это число должно соответствовать свойству емкости в соответствующем ресурсе VirtualMachineScaleSet. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

Свойства NodeTypeDescriptionPlacement

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

ClusterUpgradePolicy

Имя Описание Значение
deltaHealthPolicy Политика разностной работоспособности кластера, используемая при обновлении кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthCheckRetryTimeout Время, в течение которого требуется повторить оценку работоспособности, когда приложение или кластер неработоспособны до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
healthCheckStableDuration Период времени, в течение которого приложение или кластер должен оставаться работоспособным, прежде чем процесс обновления перейдет к следующему домену обновления. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. string (обязательно)
healthCheckWaitDuration Время ожидания после завершения обновления домена перед выполнением проверок работоспособности. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. string (обязательно)
healthPolicy Политика работоспособности кластера, используемая при обновлении кластера. ClusterHealthPolicy (обязательно)
upgradeDomainTimeout Время, в течение которого каждый домен обновления должен завершиться до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем. По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа. Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
upgradeTimeout Время, затраченное на общее обновление, до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)

ClusterUpgradeDeltaHealthPolicy

Имя Описание Значение
applicationDeltaHealthPolicies Определяет карту политики разностной работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей при обновлении кластера. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Максимальный допустимый процент снижения работоспособности приложений во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включаются в этот параметр.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyNodes Максимальный процент неработоспособных узлов, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes Максимальный процент неработоспособных узлов домена обновления, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов домена обновления в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку для всех доменов обновления, завершивших обновление, находится ли состояние этих доменов в допустимых пределах.
 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationDeltaHealthPolicyMap

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

ApplicationDeltaHealthPolicy

Имя Описание Значение
defaultServiceTypeDeltaHealthPolicy Разностная политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы при обновлении кластера. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Сопоставление с политикой разностной работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

Имя Описание Значение
maxPercentDeltaUnhealthyServices Максимальный допустимый процент снижения работоспособности служб во время обновления кластера.
Разница измеряется между состоянием служб в начале обновления и состоянием служб на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeDeltaHealthPolicyMap

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

ClusterHealthPolicy

Имя Описание Значение
applicationHealthPolicies Определяет карту политики работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных приложений, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере одно неработоспособное приложение, то состояние работоспособности оценивается как "Warning".
Это значение вычисляется путем деления числа неработоспособных приложений на общее число экземпляров приложения в кластере, за исключением приложений, типы которых указаны в ApplicationTypeHealthPolicyMap.
Расчет округляется: на небольшом количестве приложений допускается один сбой. Значение в процентах по умолчанию равняется нулю.		 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyNodes Максимально допустимый процент неработоспособных узлов, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных узлов, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных узлов, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере один неработоспособный узел, то состояние работоспособности оценивается как "Warning".
Это процентное значение вычисляется путем деления числа неработоспособных узлов за общее число узлов в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.

В крупных кластерах всегда есть отключенные узлы или узлы в состоянии восстановления. Следует учитывать это при настройке параметра.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Имя Описание Значение
maxPercentUnhealthyServices Максимальный процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным. INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeHealthPolicyMap

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

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
Развертывание кластера Ubuntu Service Fabric с 5 узлами

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 5 узлами под управлением Ubuntu на виртуальной машине Standard_D2_V2 размера.
Развертывание защищенного кластера с 5 узлами

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 5 узлами под управлением Windows Server 2019 Datacenter на виртуальной машине Standard_D2_v2 размера.
Развертывание безопасного кластера типа 3 узла с включенными группами безопасности сети

Развертывание в Azure 		Этот шаблон позволяет развернуть защищенный кластер Service Fabric с 3 узлами под управлением Windows Server 2016 Data Center на виртуальных машинах Standard_D2 размера. Этот шаблон позволяет управлять входящим и исходящим сетевым трафиком с помощью групп безопасности сети.

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2020-12-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      certificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      clientCertificateCommonNames = [
        {
          certificateCommonName = "string"
          certificateIssuerThumbprint = "string"
          isAdmin = bool
        }
      ]
      clientCertificateThumbprints = [
        {
          certificateThumbprint = "string"
          isAdmin = bool
        }
      ]
      clusterCodeVersion = "string"
      diagnosticsStorageAccountConfig = {
        blobEndpoint = "string"
        protectedAccountKeyName = "string"
        protectedAccountKeyName2 = "string"
        queueEndpoint = "string"
        storageAccountName = "string"
        tableEndpoint = "string"
      }
      eventStoreServiceEnabled = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          isPrimary = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      reverseProxyCertificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      vmImage = "string"
    }
  })
}

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

clusters

Имя Описание Значение
тип Тип ресурса "Microsoft.ServiceFabric/clusters@2020-12-01-preview"
name имя ресурса. строка (обязательно)

Ограничение символов: 4–23

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы. Закачивается строчной буквой или цифрой.
location Расположение ресурса Azure. строка (обязательно)
parent_id Чтобы выполнить развертывание в группе ресурсов, используйте идентификатор этой группы ресурсов. строка (обязательно)
tags Теги ресурсов Azure. Словарь имен и значений тегов.
properties Свойства ресурса кластера Свойства кластера

Свойства кластера

Имя Описание Значение
addOnFeatures Список дополнительных функций, которые необходимо включить в кластере. Массив строк, содержащий любой из:
BackupRestoreService
"DnsService"
RepairManager
ResourceMonitorService
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
сертификат Сертификат, используемый для защиты кластера. Предоставленный сертификат будет использоваться для обеспечения безопасности узла в кластере, SSL-сертификат для конечной точки управления кластером и клиента администратора по умолчанию. Описание сертификата
certificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
clientCertificateCommonNames Список сертификатов клиента, на которые ссылается общее имя, на которые разрешено управлять кластером. ClientCertificateCommonName[]
clientCertificateThumbprints Список сертификатов клиента, на которые ссылается отпечаток, на которые разрешено управлять кластером. ClientCertificateThumbprint[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство может быть установлено только в том случае, если параметр upgradeMode имеет значение "Вручную". Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. строка
diagnosticsStorageAccountConfig Сведения об учетной записи хранения для хранения журналов диагностики Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
managementEndpoint Конечная точка управления HTTP кластера. string (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
reliabilityLevel Уровень надежности задает реплика заданный размер системных служб. Узнайте о ReliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика задано значение 1. Этот параметр следует использовать только для тестовых кластеров.
— Бронзовый — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом реплика 5.
— Золотой — запуск системных служб с целевым числом реплика 7.
— Platinum — запуск системных служб с целевым числом реплика установленным числом 9.		 "Бронза"
"Золотой"
"None"
"Платина"
"Silver"
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. CertificateDescription
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
upgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric.

— Автоматический — кластер будет автоматически обновлен до последней версии среды выполнения Service Fabric, как только он станет доступен.
— Вручную — кластер не будет автоматически обновлен до последней версии среды выполнения Service Fabric. Кластер обновляется путем установки свойства clusterCodeVersion в кластерном ресурсе.		 "Автоматический"
"Вручную"
vmImage Образ виртуальной машины VMSS настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка

ApplicationTypeVersionsCleanupPolicy

Имя Описание Значение
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения для сохранения. int (обязательно)

Ограничения:
Минимальное значение = 0

AzureActiveDirectory

Имя Описание Значение
clientApplication Идентификатор клиентского приложения Azure Active Directory. строка
clusterApplication Идентификатор приложения кластера Azure Active Directory. строка
tenantId Идентификатор клиента Azure Active Directory. строка

CertificateDescription

Имя Описание Значение
thumbprint Отпечаток первичного сертификата. string (обязательно)
thumbprintSecondary Отпечаток дополнительного сертификата. строка
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"My"
"Root"
"TrustedPeople"
"TrustedPublisher"

ServerCertificateCommonNames

Имя Описание Значение
commonNames Список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonName[]
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"My"
"Root"
"TrustedPeople"
"TrustedPublisher"

ServerCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата сервера. string (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата сервера. string (обязательно)

ClientCertificateCommonName

Имя Описание Значение
certificateCommonName Общее имя сертификата клиента. string (обязательно)
certificateIssuerThumbprint Отпечаток издателя сертификата клиента. string (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

ClientCertificateThumbprint

Имя Описание Значение
certificateThumbprint Отпечаток сертификата клиента. string (обязательно)
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять в кластере только операции только для чтения. bool (обязательно)

DiagnosticsStorageAccountConfig

Имя Описание Значение
blobEndpoint Конечная точка BLOB-объекта учетной записи хранения Azure. string (обязательно)
protectedAccountKeyName Защищенное диагностика имя ключа хранилища. string (обязательно)
protectedAccountKeyName2 Дополнительный защищенный диагностика имя ключа хранилища. При смене одного из ключей учетной записи хранения кластер будет использовать другой. строка
queueEndpoint Конечная точка очереди учетной записи хранения Azure. string (обязательно)
storageAccountName Имя учетной записи хранения Azure. string (обязательно)
tableEndpoint Конечная точка таблицы учетной записи хранения Azure. string (обязательно)

SettingsSectionDescription

Имя Описание Значение
name Имя раздела параметров структуры. string (обязательно)
параметры Коллекция параметров в разделе. SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

Имя Описание Значение
name Имя параметра параметра структуры. string (обязательно)
значение Значение параметра параметра параметра fabric. string (обязательно)

NodeTypeDescription

Имя Описание Значение
applicationPorts Диапазон портов, из которых кластер назначает порт приложениям Service Fabric. EndpointRangeDescription
capacities Теги емкости, применяемые к узлам в типе узла, диспетчер кластерных ресурсов использует эти теги, чтобы понять, сколько ресурсов имеет узел. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Порт конечной точки управления кластером TCP. int (обязательно)
durabilityLevel Уровень устойчивости типа узла. Узнайте о Программе устойчивостиLevel.

- Бронза - нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры могут быть приостановлены на 10 минут для каждого определяемого пользователем типа.
— Золотой — задания инфраструктуры можно приостановить на 2 часа для каждого UD. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.		 "Бронза"
"Золотой"
"Silver"
ephemeralPorts Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как первичный. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
name Имя типа узла. string (обязательно)
свойства placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочая нагрузка). Свойства NodeTypeDescriptionPlacement
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount Количество узлов в типе узла. Это число должно соответствовать свойству емкости в соответствующем ресурсе VirtualMachineScaleSet. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

Свойства NodeTypeDescriptionPlacement

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

ClusterUpgradePolicy

Имя Описание Значение
deltaHealthPolicy Политика разностной работоспособности кластера, используемая при обновлении кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthCheckRetryTimeout Время, в течение которого требуется повторить оценку работоспособности, когда приложение или кластер неработоспособны до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
healthCheckStableDuration Период времени, в течение которого приложение или кластер должен оставаться работоспособным, прежде чем процесс обновления перейдет к следующему домену обновления. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. string (обязательно)
healthCheckWaitDuration Время ожидания после завершения обновления домена перед выполнением проверок работоспособности. Длительность может быть в формате чч:мм:сс или в формате d.hh:mm:ss.ms. string (обязательно)
healthPolicy Политика работоспособности кластера, используемая при обновлении кластера. ClusterHealthPolicy (обязательно)
upgradeDomainTimeout Время, в течение которого каждый домен обновления должен завершиться до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем. По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа. Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)
upgradeTimeout Время, затраченное на общее обновление, до отката обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms. string (обязательно)

ClusterUpgradeDeltaHealthPolicy

Имя Описание Значение
applicationDeltaHealthPolicies Определяет карту политики разностной работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей при обновлении кластера. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Максимальный допустимый процент снижения работоспособности приложений во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включаются в этот параметр.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyNodes Максимальный процент неработоспособных узлов, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.		 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes Максимальный процент неработоспособных узлов домена обновления, допускаемый во время обновления кластера.
Разница измеряется между состоянием узлов домена обновления в начале обновления и во время оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку для всех доменов обновления, завершивших обновление, находится ли состояние этих доменов в допустимых пределах.
 int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationDeltaHealthPolicyMap

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

ApplicationDeltaHealthPolicy

Имя Описание Значение
defaultServiceTypeDeltaHealthPolicy Разностная политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы при обновлении кластера. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Сопоставление с политикой разностной работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

Имя Описание Значение
maxPercentDeltaUnhealthyServices Максимальный допустимый процент снижения работоспособности служб во время обновления кластера.
Разница измеряется между состоянием служб в начале обновления и состоянием служб на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeDeltaHealthPolicyMap

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

ClusterHealthPolicy

Имя Описание Значение
applicationHealthPolicies Определяет карту политики работоспособности приложения, используемую для оценки работоспособности приложения или одной из его дочерних сущностей. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных приложений, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере одно неработоспособное приложение, то состояние работоспособности оценивается как "Warning".
Это значение вычисляется путем деления числа неработоспособных приложений на общее число экземпляров приложения в кластере, за исключением приложений, типы которых указаны в ApplicationTypeHealthPolicyMap.
Расчет округляется: на небольшом количестве приложений допускается один сбой. Значение в процентах по умолчанию равняется нулю.		 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyNodes Максимально допустимый процент неработоспособных узлов, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных узлов, это значение должно быть равно 10.

Это значение указывает максимально допустимый процент неработоспособных узлов, превышение которого вызывает состояние "Error" при оценке кластера.
Если процент учитывается, но имеется по крайней мере один неработоспособный узел, то состояние работоспособности оценивается как "Warning".
Это процентное значение вычисляется путем деления числа неработоспособных узлов за общее число узлов в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.

В крупных кластерах всегда есть отключенные узлы или узлы в состоянии восстановления. Следует учитывать это при настройке параметра.
 INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Имя Описание Значение
maxPercentUnhealthyServices Максимальный процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным. INT

Ограничения:
Минимальное значение = 0
Максимальное значение = 100

ServiceTypeHealthPolicyMap

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