Definování prostředků

Dokončeno

Soubory Bicep jsou vámi vytvořené soubory, které definují prostředky Azure určené k nasazení.

Vaše společnost hraček potřebuje, abyste vytvořili opakovaně použitelný soubor Bicep pro uvedení produktů. Tento soubor musí nasadit účet úložiště Azure a prostředky služby Azure App Service, které se použijí k marketingu každého nového produktu během jeho spuštění.

V této lekci se dozvíte, jak definovat prostředek v souboru Bicep, jak fungují názvy prostředků a jak můžete vytvářet prostředky, které spolu vzájemně souvisejí.

Poznámka:

Příkazy v této lekci jsou znázorněny pro ilustraci konceptů. Zatím nespouštět příkazy. Brzy si procvičíte, co se tady naučíte.

Definování prostředku

Hlavní věc, kterou budete dělat se soubory Bicep, je definovat prostředky Azure. Tady je příklad toho, jak v Bicep vypadá typická definice prostředků. Tento příklad vytvoří účet úložiště s názvem toylaunchstorage.

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'toylaunchstorage'
  location: 'westus3'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

Pojďme se podrobněji podívat na některé klíčové části této definice prostředku:

• Klíčové resource slovo na začátku říká Bicep, že se chystáte definovat prostředek.

• V dalším kroku dáte prostředku symbolický název. V příkladu je storageAccountsymbolický název zdroje . Symbolické názvy se v rámci Bicep používají k odkazování na prostředek, ale v Azure se nikdy nezobrazí.

• Microsoft.Storage/storageAccounts@2022-09-01 je typ prostředku a verze rozhraní API prostředku. Microsoft.Storage/storageAccounts informuje Bicep, že deklarujete účet úložiště Azure. Datum 2022-09-01 je verze rozhraní API služby Azure Storage, které Bicep používá při vytváření prostředku.

  Návod

  Rozšíření Bicep pro Visual Studio Code vám pomůže najít typy prostředků a verze rozhraní API pro prostředky, které vytvoříte. Pokud znáte šablony ARM, mějte na paměti, že verze rozhraní API odpovídá verzi, kterou byste tam použili.

• Musíte deklarovat název prostředku, což je název, který bude přiřazen účtu úložiště v Azure. Název prostředku nastavíte pomocí klíčového name slova.

  Důležité

  Symbolické názvy se používají jenom v souboru Bicep a nezobrazují se v Azure. Názvy prostředků se zobrazují v Azure.

• Potom nastavíte další podrobnosti o prostředku, jako je jeho umístění, skladová položka (cenová úroveň) a druh prostředku. Existují také vlastnosti, které můžete definovat, které se pro každý typ prostředku liší. Různé verze rozhraní API můžou také představovat různé vlastnosti. V tomto příkladu nastavujeme úroveň přístupu účtu úložiště na Hotúroveň přístupu .

Návod

Názvy prostředků často obsahují pravidla, která musíte dodržovat, například maximální délku, povolené znaky a jedinečnost ve všech Azure. Požadavky na názvy prostředků se pro každý typ prostředku Azure liší. Než je přidáte do souboru Bicep, nezapomeňte porozumět omezením a požadavkům na pojmenování.

Co se stane, když prostředky vzájemně závisejí?

Soubor Bicep obvykle obsahuje několik prostředků. Často potřebujete prostředek, který bude záviset na jiném prostředku. Možná budete muset extrahovat některé informace z jednoho prostředku, abyste mohli definovat jiné. Pokud nasazujete webovou aplikaci, budete muset před přidáním aplikace vytvořit serverovou infrastrukturu. Tyto relace se nazývají závislosti.

Budete muset nasadit aplikaci služby App Service pro soubor Bicep, který pomůže uvést na trh produkt hračky, ale abyste mohli vytvořit aplikaci App Service, musíte nejprve vytvořit plán služby App Service. Plán služby App Service představuje prostředky hostující server a deklaruje se jako v tomto příkladu:

resource appServicePlan 'Microsoft.Web/serverFarms@2023-12-01' = {
  name: 'toy-product-launch-plan'
  location: 'westus3'
  sku: {
    name: 'F1'
  }
}

Tato definice prostředku říká Bicep, že chcete nasadit plán služby App Service s typem Microsoft.Web/serverFarmsprostředku. Zdroj plánu má název toy-product-launch-plana nasadí se do oblasti USA – západ 3. Používá cenovou skladovou položku F1, což je úroveň Free služby App Service.

Teď, když jste deklarovali plán služby App Service, je dalším krokem deklarace aplikace:

resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
  name: 'toy-product-launch-1'
  location: 'westus3'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

Tento soubor Bicep dává Azure pokyn k hostování aplikace v plánu, který jste vytvořili. Všimněte si, že definice plánu obsahuje symbolický název plánu služby App Service na tomto řádku: serverFarmId: appServicePlan.id. Tento řádek znamená, že Bicep získá ID prostředku plánu App Service prostřednictvím vlastnosti id. V podstatě říkáme: ID serverové farmy této aplikace je ID plánu služby App Service definovaného dříve.

Návod

V Azure je ID prostředku jedinečným identifikátorem pro každý prostředek. ID prostředku zahrnuje ID předplatného Azure, název skupiny prostředků a název prostředku spolu s dalšími informacemi.

Deklarováním prostředku aplikace s vlastností, která odkazuje na symbolický název plánu, Azure rozumí implicitní závislosti mezi aplikací app Service a plánem. Když nasadí prostředky, Azure zajistí, že plán plně nasadí, než začne nasazovat aplikaci.