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


Кластеры Microsoft.ServiceFabric

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

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

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

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

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

resource symbolicname 'Microsoft.ServiceFabric/clusters@2023-11-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    addOnFeatures: [
      'string'
    ]
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
      maxUnusedVersionsToKeep: int
    }
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
      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'
    }
    enableHttpGatewayExclusiveAuthMode: bool
    eventStoreServiceEnabled: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
            name: 'string'
            value: 'string'
          }
        ]
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    infrastructureServiceManager: bool
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        httpGatewayTokenAuthEndpointPort: int
        isPrimary: bool
        isStateless: bool
        multipleAvailabilityZones: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    notifications: [
      {
        isEnabled: bool
        notificationCategory: 'WaveProgress'
        notificationLevel: 'string'
        notificationTargets: [
          {
            notificationChannel: 'string'
            receivers: [
              'string'
            ]
          }
        ]
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    reverseProxyCertificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    sfZonalUpgradeMode: 'string'
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
            considerWarningAsError: bool
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            maxPercentUnhealthyDeployedApplications: int
            serviceTypeHealthPolicyMap: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
            considerWarningAsError: bool
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            maxPercentUnhealthyDeployedApplications: int
            serviceTypeHealthPolicyMap: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      monitoringPolicy: {
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeReplicaSetCheckTimeout: 'string'
    }
    upgradeMode: 'string'
    upgradePauseEndTimestampUtc: 'string'
    upgradePauseStartTimestampUtc: 'string'
    upgradeWave: 'string'
    vmImage: 'string'
    vmssZonalUpgradeMode: 'string'
    waveUpgradePaused: bool
  }
}

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

clusters

Имя Описание Значение
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
enableHttpGatewayExclusiveAuthMode Если значение равно true, проверка подлинности на основе маркеров не разрешена в HttpGatewayEndpoint. Это необходимо для поддержки TLS версии 1.3 и выше. Если используется проверка подлинности на основе маркеров, необходимо определить HttpGatewayTokenAuthEndpointPort. bool
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
infrastructureServiceManager Указывает, включен ли диспетчер служб инфраструктуры. bool
managementEndpoint Конечная точка управления HTTP кластера. строка (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
Уведомления Указывает список каналов уведомлений для событий кластера. Уведомление[]
reliabilityLevel Уровень надежности задает реплика размер набора системных служб. Сведения о reliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика набором 1. Этот параметр следует использовать только для тестовых кластеров.
— Bronze — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом наборов реплика 5.
— Gold — запуск системных служб с целевым числом реплика набором 7.
— Platinum — запуск системных служб с целевым числом реплика набором 9.
"Бронза"
"Золотой"
"Нет"
"Платиновый"
"Серебряный"
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. Описание сертификата
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
sfZonalUpgradeMode Это свойство управляет логическим группированием виртуальных машин в доменах обновления. Это свойство нельзя изменить, если тип узла с несколькими Зонами доступности уже присутствует в кластере. Иерархический
"Parallel"
UpgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric. "Автоматический"
"Manual"
upgradePauseEndTimestampUtc Указывает дату и время приостановки автоматического обновления версий среды выполнения в кластере в течение определенного периода времени в кластере (UTC). строка
upgradePauseStartTimestampUtc Указывает дату и время начала автоматического обновления версий среды выполнения в кластере в течение определенного периода времени в кластере (UTC). строка
upgradeWave Указывает, когда будут применены обновления новой версии среды выполнения кластера после их выпуска. По умолчанию — Wave0. Применяется, только если для upgradeMode задано значение "Автоматически". 'Wave0'
'Wave1'
'Wave2'
vmImage Образ виртуальной машины VMSS был настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка
vmssZonalUpgradeMode Это свойство определяет режим обновления для масштабируемого набора виртуальных машин. Он является обязательным при добавлении типа узла с несколькими Зоны доступности. Иерархический
"Parallel"
waveUpgradePaused Логическое значение для приостановки автоматического обновления версий среды выполнения в кластере. bool

ApplicationTypeVersionsCleanupPolicy

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

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

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

AzureActiveDirectory

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

Описание сертификата

Имя Описание Значение
thumbprint Отпечаток основного сертификата. строка (обязательно)
thumbprintSecondary Отпечаток вторичного сертификата. строка
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
AuthRoot
CertificateAuthority
"Запрещено"
"Мой"
"Root"
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[] (обязательно)
name Имя раздела параметров структуры. строка (обязательно)
параметры Коллекция параметров в разделе . SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

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

NodeTypeDescription

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

— Бронза — нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры можно приостановить на 10 минут для каждого определяемого пользователем типа.
— Gold — задания инфраструктуры могут быть приостановлены в течение 2 часов для каждого определяемого пользователем типа. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.
"Бронза"
"Золотой"
"Серебряный"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
httpGatewayTokenAuthEndpointPort Порт, используемый для HTTPS-подключений к кластеру на основе проверки подлинности маркеров. Не может быть задан тот же порт, что и HttpGatewayEndpoint. INT
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как основной. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multipleAvailabilityZones Указывает, включен ли тип узла для поддержки нескольких зон. bool
name Имя типа узла. строка (обязательно)
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount VMInstanceCount должно иметь значение от 1 до n, где n указывает количество экземпляров виртуальных машин, соответствующих этому типу узла. VMInstanceCount = 0 можно выполнить только в следующих сценариях: NodeType является вторичным типом узла. Устойчивость = Bronze или Устойчивость >= Bronze и InfrastructureServiceManager = true. Если VMInstanceCount = 0, предполагает, что виртуальные машины для этого nodeType не будут использоваться для первоначального вычисления размера кластера. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

Свойства NodeTypeDescriptionPlacement

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

Уведомление

Имя Описание Значение
isEnabled Указывает, включено ли уведомление. bool (обязательно)
notificationCategory Категория уведомления. "WaveProgress" (обязательно)
notificationLevel Уровень уведомления. "Все"
"Критический" (обязательно)
notificationTargets Список целевых объектов, которые подписываются на уведомление. NotificationTarget[] (обязательно)

NotificationTarget

Имя Описание Значение
notificationChannel Канал уведомлений указывает тип получателей, подписанных на уведомление, как пользователь, так и подписка. EmailSubscription
EmailUser (обязательно)
Приемники Список целевых объектов, которые подписываются на уведомление. string[] (обязательно)

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 (обязательно)
deltaHealthPolicy Политика разностной работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthPolicy Политика работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterHealthPolicy
monitoringPolicy Политика мониторинга кластера описывает параметры для мониторинга обновления в режиме мониторинга. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем.
По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа.
Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms.
Это значение должно находиться в диапазоне от 00:00:00 до 49710.06:28:15 (32-разрядное целое число без знака в секундах)
строка

ClusterUpgradeDeltaHealthPolicy

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

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

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyApplications Максимально допустимый процент снижения работоспособности приложений, разрешенный во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включены в этот параметр.
ПРИМЕЧАНИЕ. Это значение перезапишет значение, указанное в свойствах. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications
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
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

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

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

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

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

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

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap
considerWarningAsError Указывает, учитываются ли предупреждения с той же степенью серьезности, что и ошибки. bool (обязательно)
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Максимальный допустимый процент неработоспособных развернутых приложений. Допустимые значения : байтовые значения от нуля до 100.
Процент представляет максимальный допустимый процент развернутых приложений, которые могут быть неработоспособными до того, как приложение будет считаться ошибкой.
Это вычисляется путем деления числа неработоспособных развернутых приложений на количество узлов, на которых приложение в настоящее время развернуто в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.
int (обязательно)
serviceTypeHealthPolicyMap Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyPartitionsPerService Максимально допустимый процент неработоспособных секций на службу.

Процент представляет максимальный допустимый процент секций, которые могут быть неработоспособными до того, как служба будет считаться ошибкой.
Если процент учитывается, но есть по крайней мере одна неработоспособная секция, работоспособность оценивается как Предупреждение.
Процент вычисляется путем деления числа неработоспособных секций на общее число секций в службе.
Вычисление округляется до , чтобы допускать один сбой на небольшом количестве секций.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyReplicasPerPartition Максимально допустимый процент неработоспособных реплик на секцию.

Процент представляет максимальный допустимый процент реплик, которые могут быть неработоспособными до того, как секция будет считаться ошибкой.
Если процент учитывается, но есть по крайней мере один неработоспособный реплика, работоспособность оценивается как предупреждение.
Процент вычисляется путем деления числа неработоспособных реплик на общее количество реплик в секции.
Вычисление округляется до , чтобы допускать один сбой на небольшом количестве реплик.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyServices Максимально допустимый процент неработоспособных служб.

Процент представляет максимальный допустимый процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибкой.
Если процент учитывается, но есть хотя бы одна неработоспособная служба, работоспособность оценивается как Предупреждение.
Это вычисляется путем деления числа неработоспособных служб определенного типа службы на общее количество служб конкретного типа службы.
Вычисление округляется до , чтобы допускать один сбой в небольшом количестве служб.
int (обязательно)

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

ServiceTypeHealthPolicyMap

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

ClusterMonitoringPolicy

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

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

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

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

Развертывание в 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": "2023-11-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "addOnFeatures": [ "string" ],
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int",
      "maxUnusedVersionsToKeep": "int"
    },
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string",
      "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"
    },
    "enableHttpGatewayExclusiveAuthMode": "bool",
    "eventStoreServiceEnabled": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string",
            "name": "string",
            "value": "string"
          }
        ],
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string",
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "infrastructureServiceManager": "bool",
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int",
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int",
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "httpGatewayTokenAuthEndpointPort": "int",
        "isPrimary": "bool",
        "isStateless": "bool",
        "multipleAvailabilityZones": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "notifications": [
      {
        "isEnabled": "bool",
        "notificationCategory": "WaveProgress",
        "notificationLevel": "string",
        "notificationTargets": [
          {
            "notificationChannel": "string",
            "receivers": [ "string" ]
          }
        ]
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "reverseProxyCertificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "sfZonalUpgradeMode": "string",
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            },
            "considerWarningAsError": "bool",
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "maxPercentUnhealthyDeployedApplications": "int",
            "serviceTypeHealthPolicyMap": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int",
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string",
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            },
            "considerWarningAsError": "bool",
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "maxPercentUnhealthyDeployedApplications": "int",
            "serviceTypeHealthPolicyMap": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int",
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "monitoringPolicy": {
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeReplicaSetCheckTimeout": "string"
    },
    "upgradeMode": "string",
    "upgradePauseEndTimestampUtc": "string",
    "upgradePauseStartTimestampUtc": "string",
    "upgradeWave": "string",
    "vmImage": "string",
    "vmssZonalUpgradeMode": "string",
    "waveUpgradePaused": "bool"
  }
}

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

clusters

Имя Описание Значение
тип Тип ресурса Microsoft.ServiceFabric/clusters
версия_API Версия API ресурсов '2023-11-01-preview'
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
enableHttpGatewayExclusiveAuthMode Если значение равно true, проверка подлинности на основе маркеров не разрешена в точке HttpGatewayEndpoint. Это необходимо для поддержки TLS версии 1.3 и выше. Если используется проверка подлинности на основе маркеров, необходимо определить HttpGatewayTokenAuthEndpointPort. bool
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
infrastructureServiceManager Указывает, включен ли диспетчер служб инфраструктуры. bool
managementEndpoint Конечная точка управления HTTP кластера. string (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
Уведомления Указывает список каналов уведомлений для событий кластера. Уведомление[]
reliabilityLevel Уровень надежности задает реплика заданный размер системных служб. Узнайте о ReliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика задано значение 1. Этот параметр следует использовать только для тестовых кластеров.
— Бронзовый — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом реплика 5.
— Золотой — запуск системных служб с целевым числом реплика 7.
— Platinum — запуск системных служб с целевым числом реплика установленным числом 9.
"Бронза"
"Золотой"
"Нет"
"Платина"
'Silver'
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. CertificateDescription
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
sfZonalUpgradeMode Это свойство управляет логическим группированием виртуальных машин в доменах обновления. Это свойство нельзя изменить, если тип узла с несколькими Зонами доступности уже присутствует в кластере. "Иерархическая"
"Parallel"
upgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric. "Автоматический"
"Manual"
upgradePauseEndTimestampUtc Указывает дату и время приостановки автоматического обновления версий среды выполнения в кластере в течение определенного периода времени в кластере (в формате UTC). строка
upgradePauseStartTimestampUtc Указывает дату и время начала автоматического обновления версий среды выполнения в кластере на определенный период времени в кластере (UTC). строка
upgradeWave Указывает, когда будут применяться обновления новой версии среды выполнения кластера после их выпуска. По умолчанию — Wave0. Применяется, только если параметр upgradeMode имеет значение "Автоматически". 'Wave0'
'Wave1'
'Wave2'
vmImage Образ виртуальной машины VMSS настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка
vmssZonalUpgradeMode Это свойство определяет режим обновления для масштабируемого набора виртуальных машин. Он является обязательным при добавлении типа узла с несколькими Зоны доступности. "Иерархическая"
"Parallel"
waveUpgradePaused Логическое значение для приостановки автоматического обновления версий среды выполнения в кластере. bool

ApplicationTypeVersionsCleanupPolicy

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

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

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

AzureActiveDirectory

Имя Описание Значение
clientApplication Идентификатор клиентского приложения Azure Active Directory. строка
clusterApplication Идентификатор приложения кластера Azure Active Directory. строка
tenantId Идентификатор клиента Azure Active Directory. строка
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 Общее имя сертификата сервера. строка (обязательно)
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[] (обязательно)
name Имя раздела параметров структуры. строка (обязательно)
параметры Коллекция параметров в разделе . SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

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

NodeTypeDescription

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

— Бронза — нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры можно приостановить на 10 минут для каждого определяемого пользователем типа.
— Gold — задания инфраструктуры могут быть приостановлены в течение 2 часов для каждого определяемого пользователем типа. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.
"Бронза"
"Золотой"
"Серебряный"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
httpGatewayTokenAuthEndpointPort Порт, используемый для HTTPS-подключений к кластеру на основе проверки подлинности маркеров. Не может быть задан тот же порт, что и HttpGatewayEndpoint. INT
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как основной. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multipleAvailabilityZones Указывает, включен ли тип узла для поддержки нескольких зон. bool
name Имя типа узла. строка (обязательно)
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount VMInstanceCount должно иметь значение от 1 до n, где n указывает количество экземпляров виртуальных машин, соответствующих этому типу узла. VMInstanceCount = 0 можно выполнить только в следующих сценариях: NodeType является вторичным типом узла. Устойчивость = Bronze или Устойчивость >= Bronze и InfrastructureServiceManager = true. Если VMInstanceCount = 0, предполагает, что виртуальные машины для этого nodeType не будут использоваться для первоначального вычисления размера кластера. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

NodeTypeDescriptionPlacementProperties

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

Уведомление

Имя Описание Значение
isEnabled Указывает, включено ли уведомление. bool (обязательно)
notificationCategory Категория уведомления. WaveProgress (обязательно)
notificationLevel Уровень уведомления. "Все"
"Критический" (обязательно)
notificationTargets Список целевых объектов, которые подписываются на уведомление. NotificationTarget[] (обязательно)

NotificationTarget

Имя Описание Значение
notificationChannel Канал уведомлений указывает тип получателей, подписанных на уведомление, как пользователь, так и подписка. EmailSubscription
EmailUser (обязательно)
Приемники Список целевых объектов, которые подписываются на уведомление. string[] (обязательно)

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 (обязательно)
deltaHealthPolicy Политика разностной работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthPolicy Политика работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterHealthPolicy
monitoringPolicy Политика мониторинга кластера описывает параметры для мониторинга обновления в режиме мониторинга. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем.
По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа.
Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть как в формате чч:мм:сс, так и в формате d.чч:мм:ss.ms.
Это значение должно находиться в диапазоне от 00:00:00 до 49710.06:28:15 (32-разрядное целое число без знака в секундах).
строка

ClusterUpgradeDeltaHealthPolicy

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

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

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyApplications Максимально допустимый процент снижения работоспособности приложений, разрешенный во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включены в этот параметр.
ПРИМЕЧАНИЕ. Это значение перезапишет значение, указанное в свойствах. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications
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
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

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

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

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

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

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

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap
considerWarningAsError Указывает, учитываются ли предупреждения с той же степенью серьезности, что и ошибки. bool (обязательно)
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Максимальный допустимый процент неработоспособных развернутых приложений. Допустимыми значениями являются значения байтов от нуля до 100.
Процент представляет максимальный допустимый процент развернутых приложений, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным.
Это вычисляется путем деления числа неработоспособных развернутых приложений на количество узлов, на которых в настоящее время развернуто приложение в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.
int (обязательно)
serviceTypeHealthPolicyMap Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyPartitionsPerService Максимально допустимый процент неработоспособных секций на службу.

Процент представляет максимальный допустимый процент секций, которые могут быть неработоспособными до того, как служба будет считаться ошибочной.
Если процент учитывается, но есть по крайней мере одна неработоспособная секция, работоспособность оценивается как Предупреждение.
Процент вычисляется путем деления числа неработоспособных секций на общее число секций в службе.
Вычисление округляется до , чтобы допускать один сбой в небольшом количестве секций.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyReplicasPerPartition Максимально допустимый процент неработоспособных реплик на секцию.

Процент представляет максимальный допустимый процент реплик, которые могут быть неработоспособными до того, как секция будет считаться ошибкой.
Если процент учитывается, но есть по крайней мере один неработоспособный реплика, работоспособность оценивается как Предупреждение.
Процент вычисляется путем деления числа неработоспособных реплик на общее число реплик в секции.
Вычисление округляется до , чтобы допускать один сбой на небольшом количестве реплик.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyServices Максимально допустимый процент неработоспособных служб.

Процент представляет максимальный допустимый процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным.
Если процент учитывается, но есть хотя бы одна неработоспособная служба, работоспособность оценивается как Предупреждение.
Это вычисляется путем деления числа неработоспособных служб конкретного типа на общее количество служб конкретного типа.
Вычисление округляется до , чтобы допускать один сбой в небольшом количестве служб.
int (обязательно)

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

ServiceTypeHealthPolicyMap

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

ClusterMonitoringPolicy

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

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

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

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

Развертывание в 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@2023-11-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
        maxUnusedVersionsToKeep = int
      }
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
        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"
      }
      enableHttpGatewayExclusiveAuthMode = bool
      eventStoreServiceEnabled = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
              name = "string"
              value = "string"
            }
          ]
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      infrastructureServiceManager = bool
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          httpGatewayTokenAuthEndpointPort = int
          isPrimary = bool
          isStateless = bool
          multipleAvailabilityZones = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      notifications = [
        {
          isEnabled = bool
          notificationCategory = "WaveProgress"
          notificationLevel = "string"
          notificationTargets = [
            {
              notificationChannel = "string"
              receivers = [
                "string"
              ]
            }
          ]
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      reverseProxyCertificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      sfZonalUpgradeMode = "string"
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
              considerWarningAsError = bool
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              maxPercentUnhealthyDeployedApplications = int
              serviceTypeHealthPolicyMap = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
              considerWarningAsError = bool
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              maxPercentUnhealthyDeployedApplications = int
              serviceTypeHealthPolicyMap = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        monitoringPolicy = {
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeReplicaSetCheckTimeout = "string"
      }
      upgradeMode = "string"
      upgradePauseEndTimestampUtc = "string"
      upgradePauseStartTimestampUtc = "string"
      upgradeWave = "string"
      vmImage = "string"
      vmssZonalUpgradeMode = "string"
      waveUpgradePaused = bool
    }
  })
}

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

clusters

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

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

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

Начинается со строчной буквы. Закачивается строчной буквой или цифрой.
location Расположение ресурса Azure. string (обязательно)
parent_id Для развертывания в группе ресурсов используйте идентификатор этой группы ресурсов. 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
enableHttpGatewayExclusiveAuthMode Если значение равно true, проверка подлинности на основе маркеров не разрешена в точке HttpGatewayEndpoint. Это необходимо для поддержки TLS версии 1.3 и выше. Если используется проверка подлинности на основе маркеров, необходимо определить HttpGatewayTokenAuthEndpointPort. bool
eventStoreServiceEnabled Указывает, включена ли служба хранилища событий. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
infrastructureServiceManager Указывает, включен ли диспетчер служб инфраструктуры. bool
managementEndpoint Конечная точка управления HTTP кластера. string (обязательно)
nodeTypes Список типов узлов в кластере. NodeTypeDescription[] (обязательно)
Уведомления Указывает список каналов уведомлений для событий кластера. Уведомление[]
reliabilityLevel Уровень надежности задает реплика заданный размер системных служб. Узнайте о ReliabilityLevel.

— Нет — запустите системные службы с целевым числом реплика задано значение 1. Этот параметр следует использовать только для тестовых кластеров.
— Бронзовый — запуск системных служб с целевым числом реплика набором 3. Этот параметр следует использовать только для тестовых кластеров.
— Silver — запуск системных служб с целевым числом реплика 5.
— Золотой — запуск системных служб с целевым числом реплика 7.
— Platinum — запуск системных служб с целевым числом реплика установленным числом 9.
"Бронза"
"Золотой"
"None"
"Платина"
"Silver"
reverseProxyCertificate Сертификат сервера, используемый обратным прокси-сервером. CertificateDescription
reverseProxyCertificateCommonNames Описывает список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonNames
sfZonalUpgradeMode Это свойство управляет логическим группированием виртуальных машин в доменах обновления. Это свойство нельзя изменить, если тип узла с несколькими Зонами доступности уже присутствует в кластере. "Иерархическая"
"Parallel"
upgradeDescription Политика, используемая при обновлении кластера. ClusterUpgradePolicy
upgradeMode Режим обновления кластера при наличии новой версии среды выполнения Service Fabric. "Автоматический"
"Вручную"
upgradePauseEndTimestampUtc Указывает дату и время приостановки автоматического обновления версий среды выполнения в кластере в течение определенного периода времени в кластере (в формате UTC). строка
upgradePauseStartTimestampUtc Указывает дату и время начала автоматического обновления версий среды выполнения в кластере на определенный период времени в кластере (UTC). строка
upgradeWave Указывает, когда будут применяться обновления новой версии среды выполнения кластера после их выпуска. По умолчанию — Wave0. Применяется, только если параметр upgradeMode имеет значение "Автоматически". "Wave0"
"Wave1"
"Wave2"
vmImage Образ виртуальной машины VMSS настроен с помощью . Можно использовать универсальные имена, такие как Windows или Linux. строка
vmssZonalUpgradeMode Это свойство определяет режим обновления для масштабируемого набора виртуальных машин. Он является обязательным при добавлении типа узла с несколькими Зоны доступности. "Иерархическая"
"Parallel"
waveUpgradePaused Логическое значение для приостановки автоматического обновления версий среды выполнения в кластере. bool

ApplicationTypeVersionsCleanupPolicy

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

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

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

AzureActiveDirectory

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

Описание сертификата

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

ServerCertificateCommonNames

Имя Описание Значение
commonNames Список сертификатов сервера, на которые ссылается общее имя, которые используются для защиты кластера. ServerCertificateCommonName[]
x509StoreName Расположение локального хранилища сертификатов. "Адресная книга"
"AuthRoot"
CertificateAuthority
"Запрещено"
"My"
"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[] (обязательно)
name Имя раздела параметров структуры. строка (обязательно)
параметры Коллекция параметров в разделе . SettingsParameterDescription[] (обязательно)

SettingsParameterDescription

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

NodeTypeDescription

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

— Бронза — нет привилегий. Это значение по умолчанию.
— Silver — задания инфраструктуры можно приостановить на 10 минут для каждого определяемого пользователем типа.
— Gold — задания инфраструктуры могут быть приостановлены в течение 2 часов для каждого определяемого пользователем типа. Устойчивость Gold можно включить только для номеров SKU виртуальных машин полных узлов, например D15_V2, G5 и т. д.
"Бронза"
"Золотой"
"Silver"
эфемерные порты Диапазон временных портов, с которыми должны быть настроены узлы этого типа. EndpointRangeDescription
httpGatewayEndpointPort Порт конечной точки управления кластером HTTP. int (обязательно)
httpGatewayTokenAuthEndpointPort Порт, используемый для HTTPS-подключений к кластеру на основе проверки подлинности маркеров. Не может быть задан тот же порт, что и HttpGatewayEndpoint. INT
isPrimary Тип узла, на котором будут выполняться системные службы. Только один тип узла должен быть помечен как основной. Тип первичного узла нельзя удалить или изменить для существующих кластеров. bool (обязательно)
isStateless Указывает, может ли тип узла размещать только рабочие нагрузки без отслеживания состояния. bool
multipleAvailabilityZones Указывает, включен ли тип узла для поддержки нескольких зон. bool
name Имя типа узла. строка (обязательно)
placementProperties Теги размещения, применяемые к узлам в типе узла, которые можно использовать, чтобы указать, где должны выполняться определенные службы (рабочие нагрузки). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Конечная точка, используемая обратным прокси-сервером. INT
vmInstanceCount VMInstanceCount должно иметь значение от 1 до n, где n указывает количество экземпляров виртуальных машин, соответствующих этому типу узла. VMInstanceCount = 0 можно выполнить только в следующих сценариях: NodeType является вторичным типом узла. Устойчивость = Bronze или Устойчивость >= Bronze и InfrastructureServiceManager = true. Если VMInstanceCount = 0, предполагает, что виртуальные машины для этого nodeType не будут использоваться для первоначального вычисления размера кластера. int (обязательно)

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

EndpointRangeDescription

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

NodeTypeDescriptionCapacities

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

NodeTypeDescriptionPlacementProperties

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

Уведомление

Имя Описание Значение
isEnabled Указывает, включено ли уведомление. bool (обязательно)
notificationCategory Категория уведомления. "WaveProgress" (обязательно)
notificationLevel Уровень уведомления. "All"
"Критический" (обязательно)
notificationTargets Список целевых объектов, которые подписываются на уведомление. NotificationTarget[] (обязательно)

NotificationTarget

Имя Описание Значение
notificationChannel Канал уведомлений указывает тип получателей, подписываемых на уведомление: пользователь или подписка. "EmailSubscription"
"EmailUser" (обязательно)
Приемники Список целевых объектов, которые подписываются на уведомление. string[] (обязательно)

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. строка (обязательно)
deltaHealthPolicy Политика разностной работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterUpgradeDeltaHealthPolicy
forceRestart Если значение равно true, процессы принудительно перезапускаются во время обновления, даже если версия кода не изменилась (обновление изменяет только конфигурацию или данные). bool
healthPolicy Политика работоспособности кластера определяет политику работоспособности, используемую для оценки работоспособности кластера во время обновления кластера. ClusterHealthPolicy
monitoringPolicy Политика мониторинга кластера описывает параметры для мониторинга обновления в режиме мониторинга. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Максимальный период времени, на протяжении которого можно блокировать обработку домена обновления и не допустить потери доступности в случае возникновения непредвиденных проблем.
По истечении времени ожидания обработка домена обновления будет выполняться независимо от проблем с потерей доступа.
Время ожидания сбрасывается при запуске каждого домена обновления. Время ожидания может быть в формате чч:мм:сс или в формате d.чч:мм:сс.ms.
Это значение должно находиться в диапазоне от 00:00:00 до 49710.06:28:15 (32-разрядное целое число без знака в секундах)
строка

ClusterUpgradeDeltaHealthPolicy

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

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

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentDeltaUnhealthyApplications Максимально допустимый процент снижения работоспособности приложений, разрешенный во время обновления кластера.
Разница измеряется между состоянием приложений в начале обновления и состоянием приложений на момент оценки работоспособности.
После завершения обновления каждый домен обновления выполняет проверку того, находится ли общее состояние доменов обновления в допустимых пределах. Системные службы не включены в этот параметр.
ПРИМЕЧАНИЕ. Это значение перезапишет значение, указанное в свойствах. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications
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
maxPercentUnhealthyApplications Максимально допустимый процент неработоспособных приложений, по достижении которого отображается сообщение об ошибке. Например, чтобы разрешить 10 % неработоспособных приложений, это значение должно быть равно 10.

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

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

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

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

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

ApplicationHealthPolicyMap

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

ApplicationHealthPolicy

Имя Описание Значение
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap
considerWarningAsError Указывает, учитываются ли предупреждения с той же степенью серьезности, что и ошибки. bool (обязательно)
defaultServiceTypeHealthPolicy Политика работоспособности, используемая по умолчанию для оценки работоспособности типа службы. ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Максимальный допустимый процент неработоспособных развернутых приложений. Допустимыми значениями являются значения байтов от нуля до 100.
Процент представляет максимальный допустимый процент развернутых приложений, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным.
Это вычисляется путем деления числа неработоспособных развернутых приложений на количество узлов, на которых в настоящее время развернуто приложение в кластере.
Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию равняется нулю.
int (обязательно)
serviceTypeHealthPolicyMap Сопоставление с политикой работоспособности типа службы по имени типа службы. Сопоставление является пустым по умолчанию. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

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

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyPartitionsPerService Максимально допустимый процент неработоспособных секций на службу.

Процент представляет максимальный допустимый процент секций, которые могут быть неработоспособными до того, как служба будет считаться ошибочной.
Если процент учитывается, но есть по крайней мере одна неработоспособная секция, работоспособность оценивается как Предупреждение.
Процент вычисляется путем деления числа неработоспособных секций на общее число секций в службе.
Вычисление округляется до , чтобы допускать один сбой в небольшом количестве секций.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyReplicasPerPartition Максимально допустимый процент неработоспособных реплик на секцию.

Процент представляет максимальный допустимый процент реплик, которые могут быть неработоспособными до того, как секция будет считаться ошибкой.
Если процент учитывается, но есть по крайней мере один неработоспособный реплика, работоспособность оценивается как Предупреждение.
Процент вычисляется путем деления числа неработоспособных реплик на общее число реплик в секции.
Вычисление округляется до , чтобы допускать один сбой на небольшом количестве реплик.
int (обязательно)

Ограничения:
Минимальное значение = 0
Максимальное значение = 100
maxPercentUnhealthyServices Максимально допустимый процент неработоспособных служб.

Процент представляет максимальный допустимый процент служб, которые могут быть неработоспособными до того, как приложение будет считаться ошибочным.
Если процент учитывается, но есть хотя бы одна неработоспособная служба, работоспособность оценивается как Предупреждение.
Это вычисляется путем деления числа неработоспособных служб конкретного типа на общее количество служб конкретного типа.
Вычисление округляется до , чтобы допускать один сбой в небольшом количестве служб.
int (обязательно)

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

ServiceTypeHealthPolicyMap

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

ClusterMonitoringPolicy

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