Erőforrás-deklaráció a Bicepben

  • Cikk

Ez a cikk azt a szintaxist ismerteti, amelyet az erőforrás Bicep-fájlhoz való hozzáadásához használ. Egy Bicep-fájlban legfeljebb 800 erőforrás található. További információ: Sablonkorlátok.

Nyilatkozat

Adjon hozzá egy erőforrás-deklarációt a resource kulcsszó használatával. Beállítja az erőforrás szimbolikus nevét. A szimbolikus név nem ugyanaz, mint az erőforrás neve. A szimbolikus névvel hivatkozhat az erőforrásra a Bicep-fájl más részeiben.

resource <symbolic-name> '<full-type-name>@<api-version>' = {
  <resource-properties>
}

A tárfiók deklarációja tehát a következőkkel kezdődhet:

resource stg 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  ...
}

A szimbolikus nevek megkülönböztetik a kis- és nagybetűket. Betűket, számokat és aláhúzásokat (_) tartalmazhatnak. Nem kezdődhetnek számmal. Az erőforrások neve nem lehet ugyanaz, mint egy paraméter, változó vagy modul.

Az elérhető erőforrástípusokért és verzióért lásd: Bicep-erőforrás-referencia. A Bicep nem támogatja apiProfileaz Azure Resource Manager-sablonokban (ARM-sablonok) elérhető JSON-t. A Bicep bővíthetőségi szolgáltatói erőforrásait is definiálhatja. További információ: Bicep bővíthetőségi Kubernetes-szolgáltató.

Az erőforrások feltételes üzembe helyezéséhez használja a szintaxist if . További információ: Feltételes üzembe helyezés a Bicepben.

resource <symbolic-name> '<full-type-name>@<api-version>' = if (condition) {
  <resource-properties>
}

Ha egy erőforrás egynél több példányát szeretné üzembe helyezni, használja a szintaxist for . A dekorátor használatával batchSize megadhatja, hogy a példányok sorosan vagy párhuzamosan legyenek-e üzembe helyezve. További információ: Iteratív hurkok a Bicepben.

@batchSize(int) // optional decorator for serial deployment
resource <symbolic-name> '<full-type-name>@<api-version>' = [for <item> in <collection>: {
  <properties-to-repeat>
}]

Az erőforrás tulajdonságainak szintaxisával tömböt is for létrehozhat.

resource <symbolic-name> '<full-type-name>@<api-version>' = {
  properties: {
    <array-property>: [for <item> in <collection>: <value-to-repeat>]
  }
}

Erőforrás neve

Minden erőforrásnak van egy neve. Az erőforrás nevének beállításakor ügyeljen az erőforrásnevek szabályaira és korlátozásaira.

resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' = {
  name: 'examplestorage'
  ...
}

A nevet általában egy paraméterre állítja, hogy az üzembe helyezés során különböző értékeket adjon meg.

@minLength(3)
@maxLength(24)
param storageAccountName string

resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' = {
  name: storageAccountName
  ...
}

Hely

Sok erőforrásnak helyre van szüksége. Az intellisense vagy a sablonhivatkozás segítségével meghatározhatja, hogy az erőforrásnak szüksége van-e egy helyre. Az alábbi példa egy, a tárfiókhoz használt helyparamétert ad hozzá.

resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' = {
  name: 'examplestorage'
  location: 'eastus'
  ...
}

A helyet általában egy paraméterre állítja be, hogy különböző helyeken is üzembe helyezhesse azokat.

param location string = resourceGroup().location

resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' = {
  name: 'examplestorage'
  location: location
  ...
}

A különböző erőforrástípusok különböző helyeken támogatottak. Az Azure-szolgáltatások támogatott helyeinek lekéréséhez lásd: Régiónként elérhető termékek. Az erőforrástípus támogatott helyeinek lekéréséhez használja a Azure PowerShell vagy az Azure CLI-t.

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes `
  | Where-Object ResourceTypeName -eq batchAccounts).Locations

Címkék

Az üzembe helyezés során címkéket alkalmazhat egy erőforrásra. A címkék segítségével logikusan rendszerezheti az üzembe helyezett erőforrásokat. Példák a címkék megadásának különböző módjaira: ARM-sabloncímkék.

Azure-erőforrások felügyelt identitásai

Egyes erőforrások támogatják az Azure-erőforrások felügyelt identitását. Ezek az erőforrások rendelkeznek egy identitásobjektummal az erőforrás-deklaráció gyökérszintjén.

Használhat rendszer által hozzárendelt vagy felhasználó által hozzárendelt identitásokat is.

Az alábbi példa bemutatja, hogyan konfigurálhat rendszer által hozzárendelt identitást egy Azure Kubernetes Service fürthöz.

resource aks 'Microsoft.ContainerService/managedClusters@2020-09-01' = {
  name: clusterName
  location: location
  tags: tags
  identity: {
    type: 'SystemAssigned'
  }

A következő példa bemutatja, hogyan konfigurálhat felhasználó által hozzárendelt identitást egy virtuális géphez.

param userAssignedIdentity string

resource vm 'Microsoft.Compute/virtualMachines@2020-06-01' = {
  name: vmName
  location: location
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '${userAssignedIdentity}': {}
    }
  }

Erőforrás-specifikus tulajdonságok

Az előző tulajdonságok a legtöbb erőforrástípus esetében általánosak. Az értékek beállítása után be kell állítania az üzembe helyezendő erőforrástípusra jellemző tulajdonságokat.

Intellisense- vagy Bicep-erőforrás-referencia használatával állapítsa meg, hogy mely tulajdonságok érhetők el, és melyekre van szükség. Az alábbi példa egy tárfiók fennmaradó tulajdonságait állítja be.

resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' = {
  name: 'examplestorage'
  location: 'eastus'
  sku: {
    name: 'Standard_LRS'
    tier: 'Standard'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

Következő lépések