Microsoft. ServiceFabric managedClusters 2023-02-01-preview

Bicep erőforrás definíciója

A managedClusters erőforrástípus a következő célműveletekkel telepíthető:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Használati példák

Bicep minták

Alapvető példa az erőforráscsoport üzembe helyezésére.

param location string = 'westeurope'
@description('The administrator username for the Service Fabric managed cluster')
param adminUsername string
@secure()
@description('The administrator password for the Service Fabric managed cluster')
param adminPassword string
param resourceName string = 'acctest0001'

resource managedCluster 'Microsoft.ServiceFabric/managedClusters@2021-05-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard'
  }
  properties: {
    addonFeatures: [
      'DnsService'
    ]
    adminPassword: adminPassword
    adminUserName: adminUsername
    clientConnectionPort: 12345
    clusterUpgradeCadence: 'Wave0'
    dnsName: resourceName
    httpGatewayConnectionPort: 23456
    loadBalancingRules: [
      {
        backendPort: 8000
        frontendPort: 443
        probeProtocol: 'http'
        probeRequestPath: '/'
        protocol: 'tcp'
      }
    ]
    networkSecurityRules: [
      {
        access: 'allow'
        destinationAddressPrefixes: [
          '0.0.0.0/0'
        ]
        destinationPortRanges: [
          '443'
        ]
        direction: 'inbound'
        name: 'rule443-allow-fe'
        priority: 1000
        protocol: 'tcp'
        sourceAddressPrefixes: [
          '0.0.0.0/0'
        ]
        sourcePortRanges: [
          '1-65535'
        ]
      }
    ]
  }
  tags: {
    Test: 'value'
  }
}

Erőforrás formátuma

Microsoft.ServiceFabric/managedClusters erőforrás létrehozásához add hozzá a következő Bicep-et a sablonodhoz.

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2023-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    addonFeatures: [
      'string'
    ]
    adminPassword: 'string'
    adminUserName: 'string'
    allowRdpAccess: bool
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    auxiliarySubnets: [
      {
        enableIpv6: bool
        name: 'string'
        networkSecurityGroupId: 'string'
        privateEndpointNetworkPolicies: 'string'
        privateLinkServiceNetworkPolicies: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    clientConnectionPort: int
    clients: [
      {
        commonName: 'string'
        isAdmin: bool
        issuerThumbprint: 'string'
        thumbprint: 'string'
      }
    ]
    clusterCodeVersion: 'string'
    clusterUpgradeCadence: 'string'
    clusterUpgradeMode: 'string'
    dnsName: 'string'
    enableAutoOSUpgrade: bool
    enableIpv6: bool
    enableServicePublicIP: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: int
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    loadBalancingRules: [
      {
        backendPort: int
        frontendPort: int
        loadDistribution: 'string'
        probePort: int
        probeProtocol: 'string'
        probeRequestPath: 'string'
        protocol: 'string'
      }
    ]
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefix: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRange: 'string'
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefix: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRange: 'string'
        sourcePortRanges: [
          'string'
        ]
      }
    ]
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Tulajdonságértékek

Microsoft.ServiceFabric/managedClusters

Név Leírás Érték
hely Azure erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
tulajdonságok A felügyelt fürt erőforrás-tulajdonságai ManagedClusterProperties
cikkazonosító (SKU) A felügyelt fürt termékváltozata termékváltozat (kötelező)
címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

ApplicationTypeVersionsCleanupPolicy

Név Leírás Érték
maxUnusedVersionsToKeep A nem használt verziók száma alkalmazástípusonként megtartandó. Int

Korlátok:
Minimális érték = 0 (kötelező)

AzureActiveDirectory

Név Leírás Érték
clientApplication Az Azure Active Directory ügyfélalkalmazás-azonosítója. karakterlánc
clusterApplication Az Azure Active Directory-fürtalkalmazás azonosítója. karakterlánc
bérlőazonosító Az Azure Active Directory bérlőazonosítója. karakterlánc

Ügyfélbizonyítvány

Név Leírás Érték
köznév A tanúsítvány általános neve. karakterlánc
isAdmin Azt jelzi, hogy az ügyféltanúsítvány rendelkezik-e rendszergazdai hozzáféréssel a fürthöz. A nem rendszergazdai ügyfelek csak olvasási műveleteket hajthatnak végre a fürtön. bool (kötelező)
issuerThumbprint A tanúsítvány kiállítói ujjlenyomata. Csak a CommonName használatával együtt használható. karakterlánc
ujjlenyomat Tanúsítvány ujjlenyomata. karakterlánc

IP-címcímke

Név Leírás Érték
ipTagType Az IP-címke típusa. sztring (kötelező)
címke Az IP-címke értéke. sztring (kötelező)

LoadBalancingRule

Név Leírás Érték
háttér-port A végpont belső kapcsolataihoz használt port. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
elülső port A külső végpont portja. Minden szabály portszámainak egyedinek kell lenniük a Load Balancer-on belül. Az elfogadható értékek 1 és 65534 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
loadDistribution A szabály terheléselosztási szabályzata. karakterlánc
probePort A terheléselosztási szabály által használt próbaport. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534
szondaProtokoll a terheléselosztási szabály által használt terheléselosztó-mintavételre mutató hivatkozás. "http"
"https"
"tcp" (kötelező)
szondaRequestPath A mintavételi kérelem elérési útja. Csak HTTP-/HTTPS-mintavételekhez támogatott. karakterlánc
protokoll A terheléselosztási szabály által használt átviteli protokollra mutató hivatkozás. "tcp"
"udp" (kötelező)

ManagedClusterProperties

Név Leírás Érték
addonJellemzők A fürtön engedélyezendő bővítményfunkciók listája. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
rendszergazdaJelszó Virtuális gép rendszergazdai felhasználói jelszava. szál

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
adminisztrátor felhasználónév Virtuális gép rendszergazdai felhasználóneve. sztring (kötelező)
allowRdpAccess Ha ezt igaz értékre állítja, az RDP hozzáférést biztosít a virtuális géphez. Az alapértelmezett NSG-szabály megnyitja az RDP-portot az internet felé, amely felülbírálható egyéni hálózati biztonsági szabályokkal. A beállítás alapértelmezett értéke hamis. Bool
applicationTypeVersionsCleanupPolicy A nem használt verziók törlésére használt szabályzat. ApplicationTypeVersionsCleanupPolicy
kiegészítőSubnetek A fürt kiegészítő alhálózatai. alhálózati[]
azureActiveDirectory A fürt AAD-hitelesítési beállításai. AzureActiveDirectory
clientConnectionPort A fürthöz való ügyfélkapcsolatokhoz használt port. Int
Ügyfelek A fürt kezeléséhez engedélyezett ügyféltanúsítványok. Ügyféltanúsítvány[]
clusterCodeVersion A fürt Service Fabric-futtatókörnyezetének verziója. Ez a tulajdonság akkor szükséges, ha clusterUpgradeMode "Kézi" értékre van állítva. Az új fürtökhöz elérhető Service Fabric-verziók listájának lekéréséhez használja ClusterVersion API. A meglévő fürtök elérhető verziójának listájának lekéréséhez használja elérhetőClusterVersions. karakterlánc
clusterUpgradeCadence Azt jelzi, hogy mikor lesznek alkalmazva az új fürt futtatókörnyezeti verziófrissítései a kiadásuk után. Alapértelmezés szerint a Wave0. Csak akkor érvényes, ha clusterUpgradeMode értéke "Automatikus". 'Hullám0'
'Hullám1'
"2. hullám"
clusterUpgradeMode A fürt frissítési módja, ha új Service Fabric-futtatókörnyezeti verzió érhető el. "Automatikus"
"Kézi"
dnsnév A fürt dns-neve. sztring (kötelező)
enableAutoOSUpgrade Ennek igaz értékre állítása lehetővé teszi az operációs rendszer automatikus frissítését a legújabb verziójú platform operációs rendszer lemezképével létrehozott csomóponttípusokhoz. A beállítás alapértelmezett értéke hamis. Bool
enableIpv6 Ha ezt igaz értékre állítja, IPv6-címteret hoz létre a fürt által használt alapértelmezett virtuális hálózathoz. Ez a beállítás nem módosítható a fürt létrehozása után. A beállítás alapértelmezett értéke hamis. Bool
enableServicePublicIP Ha ezt igaz értékre állítja, az IPv4-címet az IPv6-cím ServicePublicIP-címeként fogja összekapcsolni. Csak akkor állítható true (Igaz) értékre, ha az IPv6 engedélyezve van a fürtön. Bool
fabricSettings A fürt konfigurálásához tartozó egyéni hálóbeállítások listája. SettingsSectionDescription[]
httpGatewayConnectionPort A fürt HTTP-kapcsolataihoz használt port. Int
ipCímkék A fürt alapértelmezett nyilvános IP-címéhez társított IP-címkék listája. IPTag[]
loadBalancingSzabályok A fürt nyilvános terheléselosztójára alkalmazott terheléselosztási szabályok. Terheléselosztási szabály[]
networkSecurityRules Egyedi hálózati biztonsági szabályok, amelyeket a klaszter Virtual Network-én alkalmaznak. Hálózati biztonsági szabály[]
serviceEndpoints A fürt alhálózatainak szolgáltatásvégpontjai. Szolgáltatás-végpont[]
alhálózati azonosító Ha meg van adva, a fürt csomóponttípusai az alapértelmezett virtuális hálózat helyett ebben az alhálózatban jönnek létre. A rendszer a fürthöz megadott networkSecurityRules is alkalmazza erre az alhálózatra. Ez a beállítás nem módosítható a fürt létrehozása után. karakterlánc
useCustomVnet Új fürtök esetén ez a paraméter azt jelzi, hogy saját virtuális hálózatot használ, de az alhálózat csomóponttípus szintjén van megadva; és az ilyen fürtök esetében az alhálózatazonosító tulajdonság szükséges a csomóponttípusokhoz. Bool
zónaszintű rugalmasság Azt jelzi, hogy a fürt rendelkezik-e zónarugalmasságokkal. Bool
zonalUpdateMode Az Az-fürtök frissítési módját jelzi. "Gyors"
"Standard"

Hálózatbiztonsági Szabály

Név Leírás Érték
hozzáférés A hálózati forgalom engedélyezett vagy megtagadva. "engedélyezés"
"deny" (kötelező)
leírás Hálózati biztonsági szabály leírása. karakterlánc
destinationAddressPrefix A célcím előtagja. CIDR vagy cél IP-tartomány. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. karakterlánc
destinationAddressPrefixes A célcímelőtagok. CIDR- vagy cél IP-tartományok. karakterlánc[]
destinationPortRange a célportot vagy tartományt. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
destinationPortRanges A célporttartományok. karakterlánc[]
irány Hálózati biztonsági szabály iránya. "bejövő"
"kimenő" (kötelező)
név Hálózati biztonsági szabály neve. sztring (kötelező)
elsőbbség A szabály prioritása. Az érték 1000 és 3000 közötti lehet. Az ezen tartományon kívüli értékek a Service Fabric ManagerCluster erőforrás-szolgáltató számára vannak fenntartva. A prioritási számnak egyedinek kell lennie a gyűjtemény minden szabályához. Minél alacsonyabb a prioritási szám, annál magasabb a szabály prioritása. Int

Korlátok:
Minimális érték = 1000
Maximális érték = 3000 (kötelező)
protokoll Ez a szabály a hálózati protokollra vonatkozik. "Áh"
"ESP"
"http"
"https"
"ICMP"
"tcp"
"udp" (kötelező)
sourceAddressPrefix A CIDR vagy a forrás IP-tartománya. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. Ha ez egy bejövő szabály, meghatározza, hogy honnan származik a hálózati forgalom. karakterlánc
sourceAddressPrefixes A CIDR vagy a forrás IP-tartományai. karakterlánc[]
sourcePortRange A forrásport vagy -tartomány. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
sourcePortRanges A forrásporttartományok. karakterlánc[]

Erőforrás címkék

Név Leírás Érték

Szolgáltatás-végpont

Név Leírás Érték
helyek Helyek listája. karakterlánc[]
szolgáltatás A végpontszolgáltatás típusa. sztring (kötelező)

SettingsParameterDescription

Név Leírás Érték
név A hálóbeállítás paraméterneve. sztring (kötelező)
érték A hálóbeállítás paraméterértéke. sztring (kötelező)

SettingsSectionDescription

Név Leírás Érték
név A hálóbeállítások szakaszneve. sztring (kötelező)
paraméterek A szakasz paramétereinek gyűjteménye. SettingsParameterDescription[] (kötelező)

termékazonosító (SKU)

Név Leírás Érték
név Termékváltozat neve. "Alapszintű"
"Standard" (kötelező)

Alhálózat

Név Leírás Érték
enableIpv6 Azt jelzi, hogy a wether engedélyezi-e az Ipv6-ot, vagy sem. Ha nincs megadva, ugyanazzal a konfigurációval fog rendelkezni, mint a fürt. Bool
név Alhálózat neve. sztring (kötelező)
networkSecurityGroupId A hálózati biztonsági csoport teljes erőforrás-azonosítója. karakterlánc
privateEndpointNetworkPolicies Hálózati szabályzatok alkalmazásának engedélyezése vagy letiltása az alhálózat privát végpontján. "letiltva"
"engedélyezve"
privateLinkServiceNetworkPolicies Hálózati házirendek engedélyezése vagy letiltása az alhálózat privát kapcsolati szolgáltatásában. "letiltva"
"engedélyezve"

ARM-sablon erőforrásdefiníciója

A managedClusters erőforrástípus a következő célműveletekkel telepíthető:

Használati példák

Erőforrás formátuma

Microsoft.ServiceFabric/managedClusters erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2023-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addonFeatures": [ "string" ],
    "adminPassword": "string",
    "adminUserName": "string",
    "allowRdpAccess": "bool",
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "auxiliarySubnets": [
      {
        "enableIpv6": "bool",
        "name": "string",
        "networkSecurityGroupId": "string",
        "privateEndpointNetworkPolicies": "string",
        "privateLinkServiceNetworkPolicies": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "clientConnectionPort": "int",
    "clients": [
      {
        "commonName": "string",
        "isAdmin": "bool",
        "issuerThumbprint": "string",
        "thumbprint": "string"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterUpgradeCadence": "string",
    "clusterUpgradeMode": "string",
    "dnsName": "string",
    "enableAutoOSUpgrade": "bool",
    "enableIpv6": "bool",
    "enableServicePublicIP": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "int",
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "loadBalancingRules": [
      {
        "backendPort": "int",
        "frontendPort": "int",
        "loadDistribution": "string",
        "probePort": "int",
        "probeProtocol": "string",
        "probeRequestPath": "string",
        "protocol": "string"
      }
    ],
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefix": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRange": "string",
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefix": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRange": "string",
        "sourcePortRanges": [ "string" ]
      }
    ],
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Tulajdonságértékek

Microsoft.ServiceFabric/managedClusters

Név Leírás Érték
apiVersion Az API verziója '2023-02-01-preview"
hely Azure erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
tulajdonságok A felügyelt fürt erőforrás-tulajdonságai ManagedClusterProperties
cikkazonosító (SKU) A felügyelt fürt termékváltozata termékváltozat (kötelező)
címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.ServiceFabric/managedClusters"

ApplicationTypeVersionsCleanupPolicy

Név Leírás Érték
maxUnusedVersionsToKeep A nem használt verziók száma alkalmazástípusonként megtartandó. Int

Korlátok:
Minimális érték = 0 (kötelező)

AzureActiveDirectory

Név Leírás Érték
clientApplication Az Azure Active Directory ügyfélalkalmazás-azonosítója. karakterlánc
clusterApplication Az Azure Active Directory-fürtalkalmazás azonosítója. karakterlánc
bérlőazonosító Az Azure Active Directory bérlőazonosítója. karakterlánc

Ügyfélbizonyítvány

Név Leírás Érték
köznév A tanúsítvány általános neve. karakterlánc
isAdmin Azt jelzi, hogy az ügyféltanúsítvány rendelkezik-e rendszergazdai hozzáféréssel a fürthöz. A nem rendszergazdai ügyfelek csak olvasási műveleteket hajthatnak végre a fürtön. bool (kötelező)
issuerThumbprint A tanúsítvány kiállítói ujjlenyomata. Csak a CommonName használatával együtt használható. karakterlánc
ujjlenyomat Tanúsítvány ujjlenyomata. karakterlánc

IP-címcímke

Név Leírás Érték
ipTagType Az IP-címke típusa. sztring (kötelező)
címke Az IP-címke értéke. sztring (kötelező)

LoadBalancingRule

Név Leírás Érték
háttér-port A végpont belső kapcsolataihoz használt port. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
elülső port A külső végpont portja. Minden szabály portszámainak egyedinek kell lenniük a Load Balancer-on belül. Az elfogadható értékek 1 és 65534 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
loadDistribution A szabály terheléselosztási szabályzata. karakterlánc
probePort A terheléselosztási szabály által használt próbaport. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534
szondaProtokoll a terheléselosztási szabály által használt terheléselosztó-mintavételre mutató hivatkozás. "http"
"https"
"tcp" (kötelező)
szondaRequestPath A mintavételi kérelem elérési útja. Csak HTTP-/HTTPS-mintavételekhez támogatott. karakterlánc
protokoll A terheléselosztási szabály által használt átviteli protokollra mutató hivatkozás. "tcp"
"udp" (kötelező)

ManagedClusterProperties

Név Leírás Érték
addonJellemzők A fürtön engedélyezendő bővítményfunkciók listája. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
rendszergazdaJelszó Virtuális gép rendszergazdai felhasználói jelszava. szál

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
adminisztrátor felhasználónév Virtuális gép rendszergazdai felhasználóneve. sztring (kötelező)
allowRdpAccess Ha ezt igaz értékre állítja, az RDP hozzáférést biztosít a virtuális géphez. Az alapértelmezett NSG-szabály megnyitja az RDP-portot az internet felé, amely felülbírálható egyéni hálózati biztonsági szabályokkal. A beállítás alapértelmezett értéke hamis. Bool
applicationTypeVersionsCleanupPolicy A nem használt verziók törlésére használt szabályzat. ApplicationTypeVersionsCleanupPolicy
kiegészítőSubnetek A fürt kiegészítő alhálózatai. alhálózati[]
azureActiveDirectory A fürt AAD-hitelesítési beállításai. AzureActiveDirectory
clientConnectionPort A fürthöz való ügyfélkapcsolatokhoz használt port. Int
Ügyfelek A fürt kezeléséhez engedélyezett ügyféltanúsítványok. Ügyféltanúsítvány[]
clusterCodeVersion A fürt Service Fabric-futtatókörnyezetének verziója. Ez a tulajdonság akkor szükséges, ha clusterUpgradeMode "Kézi" értékre van állítva. Az új fürtökhöz elérhető Service Fabric-verziók listájának lekéréséhez használja ClusterVersion API. A meglévő fürtök elérhető verziójának listájának lekéréséhez használja elérhetőClusterVersions. karakterlánc
clusterUpgradeCadence Azt jelzi, hogy mikor lesznek alkalmazva az új fürt futtatókörnyezeti verziófrissítései a kiadásuk után. Alapértelmezés szerint a Wave0. Csak akkor érvényes, ha clusterUpgradeMode értéke "Automatikus". 'Hullám0'
'Hullám1'
"2. hullám"
clusterUpgradeMode A fürt frissítési módja, ha új Service Fabric-futtatókörnyezeti verzió érhető el. "Automatikus"
"Kézi"
dnsnév A fürt dns-neve. sztring (kötelező)
enableAutoOSUpgrade Ennek igaz értékre állítása lehetővé teszi az operációs rendszer automatikus frissítését a legújabb verziójú platform operációs rendszer lemezképével létrehozott csomóponttípusokhoz. A beállítás alapértelmezett értéke hamis. Bool
enableIpv6 Ha ezt igaz értékre állítja, IPv6-címteret hoz létre a fürt által használt alapértelmezett virtuális hálózathoz. Ez a beállítás nem módosítható a fürt létrehozása után. A beállítás alapértelmezett értéke hamis. Bool
enableServicePublicIP Ha ezt igaz értékre állítja, az IPv4-címet az IPv6-cím ServicePublicIP-címeként fogja összekapcsolni. Csak akkor állítható true (Igaz) értékre, ha az IPv6 engedélyezve van a fürtön. Bool
fabricSettings A fürt konfigurálásához tartozó egyéni hálóbeállítások listája. SettingsSectionDescription[]
httpGatewayConnectionPort A fürt HTTP-kapcsolataihoz használt port. Int
ipCímkék A fürt alapértelmezett nyilvános IP-címéhez társított IP-címkék listája. IPTag[]
loadBalancingSzabályok A fürt nyilvános terheléselosztójára alkalmazott terheléselosztási szabályok. Terheléselosztási szabály[]
networkSecurityRules Egyedi hálózati biztonsági szabályok, amelyeket a klaszter Virtual Network-én alkalmaznak. Hálózati biztonsági szabály[]
serviceEndpoints A fürt alhálózatainak szolgáltatásvégpontjai. Szolgáltatás-végpont[]
alhálózati azonosító Ha meg van adva, a fürt csomóponttípusai az alapértelmezett virtuális hálózat helyett ebben az alhálózatban jönnek létre. A rendszer a fürthöz megadott networkSecurityRules is alkalmazza erre az alhálózatra. Ez a beállítás nem módosítható a fürt létrehozása után. karakterlánc
useCustomVnet Új fürtök esetén ez a paraméter azt jelzi, hogy saját virtuális hálózatot használ, de az alhálózat csomóponttípus szintjén van megadva; és az ilyen fürtök esetében az alhálózatazonosító tulajdonság szükséges a csomóponttípusokhoz. Bool
zónaszintű rugalmasság Azt jelzi, hogy a fürt rendelkezik-e zónarugalmasságokkal. Bool
zonalUpdateMode Az Az-fürtök frissítési módját jelzi. "Gyors"
"Standard"

Hálózatbiztonsági Szabály

Név Leírás Érték
hozzáférés A hálózati forgalom engedélyezett vagy megtagadva. "engedélyezés"
"deny" (kötelező)
leírás Hálózati biztonsági szabály leírása. karakterlánc
destinationAddressPrefix A célcím előtagja. CIDR vagy cél IP-tartomány. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. karakterlánc
destinationAddressPrefixes A célcímelőtagok. CIDR- vagy cél IP-tartományok. karakterlánc[]
destinationPortRange a célportot vagy tartományt. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
destinationPortRanges A célporttartományok. karakterlánc[]
irány Hálózati biztonsági szabály iránya. "bejövő"
"kimenő" (kötelező)
név Hálózati biztonsági szabály neve. sztring (kötelező)
elsőbbség A szabály prioritása. Az érték 1000 és 3000 közötti lehet. Az ezen tartományon kívüli értékek a Service Fabric ManagerCluster erőforrás-szolgáltató számára vannak fenntartva. A prioritási számnak egyedinek kell lennie a gyűjtemény minden szabályához. Minél alacsonyabb a prioritási szám, annál magasabb a szabály prioritása. Int

Korlátok:
Minimális érték = 1000
Maximális érték = 3000 (kötelező)
protokoll Ez a szabály a hálózati protokollra vonatkozik. "Áh"
"ESP"
"http"
"https"
"ICMP"
"tcp"
"udp" (kötelező)
sourceAddressPrefix A CIDR vagy a forrás IP-tartománya. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. Ha ez egy bejövő szabály, meghatározza, hogy honnan származik a hálózati forgalom. karakterlánc
sourceAddressPrefixes A CIDR vagy a forrás IP-tartományai. karakterlánc[]
sourcePortRange A forrásport vagy -tartomány. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
sourcePortRanges A forrásporttartományok. karakterlánc[]

Erőforrás címkék

Név Leírás Érték

Szolgáltatás-végpont

Név Leírás Érték
helyek Helyek listája. karakterlánc[]
szolgáltatás A végpontszolgáltatás típusa. sztring (kötelező)

SettingsParameterDescription

Név Leírás Érték
név A hálóbeállítás paraméterneve. sztring (kötelező)
érték A hálóbeállítás paraméterértéke. sztring (kötelező)

SettingsSectionDescription

Név Leírás Érték
név A hálóbeállítások szakaszneve. sztring (kötelező)
paraméterek A szakasz paramétereinek gyűjteménye. SettingsParameterDescription[] (kötelező)

termékazonosító (SKU)

Név Leírás Érték
név Termékváltozat neve. "Alapszintű"
"Standard" (kötelező)

Alhálózat

Név Leírás Érték
enableIpv6 Azt jelzi, hogy a wether engedélyezi-e az Ipv6-ot, vagy sem. Ha nincs megadva, ugyanazzal a konfigurációval fog rendelkezni, mint a fürt. Bool
név Alhálózat neve. sztring (kötelező)
networkSecurityGroupId A hálózati biztonsági csoport teljes erőforrás-azonosítója. karakterlánc
privateEndpointNetworkPolicies Hálózati szabályzatok alkalmazásának engedélyezése vagy letiltása az alhálózat privát végpontján. "letiltva"
"engedélyezve"
privateLinkServiceNetworkPolicies Hálózati házirendek engedélyezése vagy letiltása az alhálózat privát kapcsolati szolgáltatásában. "letiltva"
"engedélyezve"

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A managedClusters erőforrástípus a következő célműveletekkel telepíthető:

  • Erőforráscsoportok Az API verziók megváltoztatott tulajdonságainak listájáért lásd: Változásnapló.

Használati példák

Terraform minták

Alapvető példa az erőforráscsoport üzembe helyezésére.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "admin_username" {
  type        = string
  description = "The administrator username for the Service Fabric managed cluster"
}

variable "admin_password" {
  type        = string
  description = "The administrator password for the Service Fabric managed cluster"
  sensitive   = true
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "managedCluster" {
  type      = "Microsoft.ServiceFabric/managedClusters@2021-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addonFeatures = [
        "DnsService",
      ]
      adminPassword             = var.admin_password
      adminUserName             = var.admin_username
      clientConnectionPort      = 12345
      clusterUpgradeCadence     = "Wave0"
      dnsName                   = var.resource_name
      httpGatewayConnectionPort = 23456
      loadBalancingRules = [
        {
          backendPort      = 8000
          frontendPort     = 443
          probeProtocol    = "http"
          probeRequestPath = "/"
          protocol         = "tcp"
        },
      ]
      networkSecurityRules = [
        {
          access = "allow"
          destinationAddressPrefixes = [
            "0.0.0.0/0",
          ]
          destinationPortRanges = [
            "443",
          ]
          direction = "inbound"
          name      = "rule443-allow-fe"
          priority  = 1000
          protocol  = "tcp"
          sourceAddressPrefixes = [
            "0.0.0.0/0",
          ]
          sourcePortRanges = [
            "1-65535",
          ]
        },
      ]
    }
    sku = {
      name = "Standard"
    }
    tags = {
      Test = "value"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Erőforrás formátuma

Microsoft.ServiceFabric/managedClusters erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2023-02-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      auxiliarySubnets = [
        {
          enableIpv6 = bool
          name = "string"
          networkSecurityGroupId = "string"
          privateEndpointNetworkPolicies = "string"
          privateLinkServiceNetworkPolicies = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      clientConnectionPort = int
      clients = [
        {
          commonName = "string"
          isAdmin = bool
          issuerThumbprint = "string"
          thumbprint = "string"
        }
      ]
      clusterCodeVersion = "string"
      clusterUpgradeCadence = "string"
      clusterUpgradeMode = "string"
      dnsName = "string"
      enableAutoOSUpgrade = bool
      enableIpv6 = bool
      enableServicePublicIP = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = int
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      loadBalancingRules = [
        {
          backendPort = int
          frontendPort = int
          loadDistribution = "string"
          probePort = int
          probeProtocol = "string"
          probeRequestPath = "string"
          protocol = "string"
        }
      ]
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefix = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRange = "string"
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefix = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRange = "string"
          sourcePortRanges = [
            "string"
          ]
        }
      ]
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
    sku = {
      name = "string"
    }
  }
}

Tulajdonságértékek

Microsoft.ServiceFabric/managedClusters

Név Leírás Érték
hely Azure erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
tulajdonságok A felügyelt fürt erőforrás-tulajdonságai ManagedClusterProperties
cikkazonosító (SKU) A felügyelt fürt termékváltozata termékváltozat (kötelező)
címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.ServiceFabric/managedClusters@2023-02-01-preview"

ApplicationTypeVersionsCleanupPolicy

Név Leírás Érték
maxUnusedVersionsToKeep A nem használt verziók száma alkalmazástípusonként megtartandó. Int

Korlátok:
Minimális érték = 0 (kötelező)

AzureActiveDirectory

Név Leírás Érték
clientApplication Az Azure Active Directory ügyfélalkalmazás-azonosítója. karakterlánc
clusterApplication Az Azure Active Directory-fürtalkalmazás azonosítója. karakterlánc
bérlőazonosító Az Azure Active Directory bérlőazonosítója. karakterlánc

Ügyfélbizonyítvány

Név Leírás Érték
köznév A tanúsítvány általános neve. karakterlánc
isAdmin Azt jelzi, hogy az ügyféltanúsítvány rendelkezik-e rendszergazdai hozzáféréssel a fürthöz. A nem rendszergazdai ügyfelek csak olvasási műveleteket hajthatnak végre a fürtön. bool (kötelező)
issuerThumbprint A tanúsítvány kiállítói ujjlenyomata. Csak a CommonName használatával együtt használható. karakterlánc
ujjlenyomat Tanúsítvány ujjlenyomata. karakterlánc

IP-címcímke

Név Leírás Érték
ipTagType Az IP-címke típusa. sztring (kötelező)
címke Az IP-címke értéke. sztring (kötelező)

LoadBalancingRule

Név Leírás Érték
háttér-port A végpont belső kapcsolataihoz használt port. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
elülső port A külső végpont portja. Minden szabály portszámainak egyedinek kell lenniük a Load Balancer-on belül. Az elfogadható értékek 1 és 65534 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534 (kötelező)
loadDistribution A szabály terheléselosztási szabályzata. karakterlánc
probePort A terheléselosztási szabály által használt próbaport. Az elfogadható értékek 1 és 65535 között vannak. Int

Korlátok:
Minimális érték = 1
Maximális érték = 65534
szondaProtokoll a terheléselosztási szabály által használt terheléselosztó-mintavételre mutató hivatkozás. "http"
"https"
"tcp" (kötelező)
szondaRequestPath A mintavételi kérelem elérési útja. Csak HTTP-/HTTPS-mintavételekhez támogatott. karakterlánc
protokoll A terheléselosztási szabály által használt átviteli protokollra mutató hivatkozás. "tcp"
"udp" (kötelező)

ManagedClusterProperties

Név Leírás Érték
addonJellemzők A fürtön engedélyezendő bővítményfunkciók listája. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
rendszergazdaJelszó Virtuális gép rendszergazdai felhasználói jelszava. szál

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
adminisztrátor felhasználónév Virtuális gép rendszergazdai felhasználóneve. sztring (kötelező)
allowRdpAccess Ha ezt igaz értékre állítja, az RDP hozzáférést biztosít a virtuális géphez. Az alapértelmezett NSG-szabály megnyitja az RDP-portot az internet felé, amely felülbírálható egyéni hálózati biztonsági szabályokkal. A beállítás alapértelmezett értéke hamis. Bool
applicationTypeVersionsCleanupPolicy A nem használt verziók törlésére használt szabályzat. ApplicationTypeVersionsCleanupPolicy
kiegészítőSubnetek A fürt kiegészítő alhálózatai. alhálózati[]
azureActiveDirectory A fürt AAD-hitelesítési beállításai. AzureActiveDirectory
clientConnectionPort A fürthöz való ügyfélkapcsolatokhoz használt port. Int
Ügyfelek A fürt kezeléséhez engedélyezett ügyféltanúsítványok. Ügyféltanúsítvány[]
clusterCodeVersion A fürt Service Fabric-futtatókörnyezetének verziója. Ez a tulajdonság akkor szükséges, ha clusterUpgradeMode "Kézi" értékre van állítva. Az új fürtökhöz elérhető Service Fabric-verziók listájának lekéréséhez használja ClusterVersion API. A meglévő fürtök elérhető verziójának listájának lekéréséhez használja elérhetőClusterVersions. karakterlánc
clusterUpgradeCadence Azt jelzi, hogy mikor lesznek alkalmazva az új fürt futtatókörnyezeti verziófrissítései a kiadásuk után. Alapértelmezés szerint a Wave0. Csak akkor érvényes, ha clusterUpgradeMode értéke "Automatikus". 'Hullám0'
'Hullám1'
"2. hullám"
clusterUpgradeMode A fürt frissítési módja, ha új Service Fabric-futtatókörnyezeti verzió érhető el. "Automatikus"
"Kézi"
dnsnév A fürt dns-neve. sztring (kötelező)
enableAutoOSUpgrade Ennek igaz értékre állítása lehetővé teszi az operációs rendszer automatikus frissítését a legújabb verziójú platform operációs rendszer lemezképével létrehozott csomóponttípusokhoz. A beállítás alapértelmezett értéke hamis. Bool
enableIpv6 Ha ezt igaz értékre állítja, IPv6-címteret hoz létre a fürt által használt alapértelmezett virtuális hálózathoz. Ez a beállítás nem módosítható a fürt létrehozása után. A beállítás alapértelmezett értéke hamis. Bool
enableServicePublicIP Ha ezt igaz értékre állítja, az IPv4-címet az IPv6-cím ServicePublicIP-címeként fogja összekapcsolni. Csak akkor állítható true (Igaz) értékre, ha az IPv6 engedélyezve van a fürtön. Bool
fabricSettings A fürt konfigurálásához tartozó egyéni hálóbeállítások listája. SettingsSectionDescription[]
httpGatewayConnectionPort A fürt HTTP-kapcsolataihoz használt port. Int
ipCímkék A fürt alapértelmezett nyilvános IP-címéhez társított IP-címkék listája. IPTag[]
loadBalancingSzabályok A fürt nyilvános terheléselosztójára alkalmazott terheléselosztási szabályok. Terheléselosztási szabály[]
networkSecurityRules Egyedi hálózati biztonsági szabályok, amelyeket a klaszter Virtual Network-én alkalmaznak. Hálózati biztonsági szabály[]
serviceEndpoints A fürt alhálózatainak szolgáltatásvégpontjai. Szolgáltatás-végpont[]
alhálózati azonosító Ha meg van adva, a fürt csomóponttípusai az alapértelmezett virtuális hálózat helyett ebben az alhálózatban jönnek létre. A rendszer a fürthöz megadott networkSecurityRules is alkalmazza erre az alhálózatra. Ez a beállítás nem módosítható a fürt létrehozása után. karakterlánc
useCustomVnet Új fürtök esetén ez a paraméter azt jelzi, hogy saját virtuális hálózatot használ, de az alhálózat csomóponttípus szintjén van megadva; és az ilyen fürtök esetében az alhálózatazonosító tulajdonság szükséges a csomóponttípusokhoz. Bool
zónaszintű rugalmasság Azt jelzi, hogy a fürt rendelkezik-e zónarugalmasságokkal. Bool
zonalUpdateMode Az Az-fürtök frissítési módját jelzi. "Gyors"
"Standard"

Hálózatbiztonsági Szabály

Név Leírás Érték
hozzáférés A hálózati forgalom engedélyezett vagy megtagadva. "engedélyezés"
"deny" (kötelező)
leírás Hálózati biztonsági szabály leírása. karakterlánc
destinationAddressPrefix A célcím előtagja. CIDR vagy cél IP-tartomány. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. karakterlánc
destinationAddressPrefixes A célcímelőtagok. CIDR- vagy cél IP-tartományok. karakterlánc[]
destinationPortRange a célportot vagy tartományt. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
destinationPortRanges A célporttartományok. karakterlánc[]
irány Hálózati biztonsági szabály iránya. "bejövő"
"kimenő" (kötelező)
név Hálózati biztonsági szabály neve. sztring (kötelező)
elsőbbség A szabály prioritása. Az érték 1000 és 3000 közötti lehet. Az ezen tartományon kívüli értékek a Service Fabric ManagerCluster erőforrás-szolgáltató számára vannak fenntartva. A prioritási számnak egyedinek kell lennie a gyűjtemény minden szabályához. Minél alacsonyabb a prioritási szám, annál magasabb a szabály prioritása. Int

Korlátok:
Minimális érték = 1000
Maximális érték = 3000 (kötelező)
protokoll Ez a szabály a hálózati protokollra vonatkozik. "Áh"
"ESP"
"http"
"https"
"ICMP"
"tcp"
"udp" (kötelező)
sourceAddressPrefix A CIDR vagy a forrás IP-tartománya. A *csillag az összes forrás IP-címhez is használható. Az alapértelmezett címkék, például a "VirtualNetwork", az "AzureLoadBalancer" és az "Internet" is használhatók. Ha ez egy bejövő szabály, meghatározza, hogy honnan származik a hálózati forgalom. karakterlánc
sourceAddressPrefixes A CIDR vagy a forrás IP-tartományai. karakterlánc[]
sourcePortRange A forrásport vagy -tartomány. Egész szám vagy 0 és 65535 közötti tartomány. A *csillag az összes portnak megfeleltethető. karakterlánc
sourcePortRanges A forrásporttartományok. karakterlánc[]

Erőforrás címkék

Név Leírás Érték

Szolgáltatás-végpont

Név Leírás Érték
helyek Helyek listája. karakterlánc[]
szolgáltatás A végpontszolgáltatás típusa. sztring (kötelező)

SettingsParameterDescription

Név Leírás Érték
név A hálóbeállítás paraméterneve. sztring (kötelező)
érték A hálóbeállítás paraméterértéke. sztring (kötelező)

SettingsSectionDescription

Név Leírás Érték
név A hálóbeállítások szakaszneve. sztring (kötelező)
paraméterek A szakasz paramétereinek gyűjteménye. SettingsParameterDescription[] (kötelező)

termékazonosító (SKU)

Név Leírás Érték
név Termékváltozat neve. "Alapszintű"
"Standard" (kötelező)

Alhálózat

Név Leírás Érték
enableIpv6 Azt jelzi, hogy a wether engedélyezi-e az Ipv6-ot, vagy sem. Ha nincs megadva, ugyanazzal a konfigurációval fog rendelkezni, mint a fürt. Bool
név Alhálózat neve. sztring (kötelező)
networkSecurityGroupId A hálózati biztonsági csoport teljes erőforrás-azonosítója. karakterlánc
privateEndpointNetworkPolicies Hálózati szabályzatok alkalmazásának engedélyezése vagy letiltása az alhálózat privát végpontján. "letiltva"
"engedélyezve"
privateLinkServiceNetworkPolicies Hálózati házirendek engedélyezése vagy letiltása az alhálózat privát kapcsolati szolgáltatásában. "letiltva"
"engedélyezve"