Prozkoumejte azd up pracovní postup

Azure Developer CLI (azd) umožňuje zřizovat a nasazovat prostředky aplikace v Azure pouze pomocí jediného příkazu.azd up Tato příručka obsahuje podrobný rozpis azd up a způsob korelace různých fází tohoto příkazu pracovního postupu se strukturou azd šablony.

Postupujte podle šablony

V následujících částech se používají příklady ze hello-azd šablony k předvedení různých azd konceptů a vzorů. Postup můžete sledovat inicializací šablony na místním počítači:

azd init -t hello-azd

Další informace o zahájení práce s azd a šablonou hello-azd najdete v článku Rychlý start: Nasazení šablony Azure Developer CLI.

Základní koncepty

Při práci se šablonou azd můžete pomocí příkazu zřídit a nasadit prostředky aplikace v Azure azd up . Spusťte příkaz z okna terminálu, které je otevřené ve složce šablony:

azd up

azd up je navržený tak, abyste mohli opakovaně spouštět příkaz při vývoji aplikace a nové změny se nasazují přírůstkově. Příkaz zahájí výkonný pracovní postup, který v podstatě zahrnuje tři konkrétní fáze:

1. Balení: Připraví kód aplikace a závislosti pro nasazení.
2. Zřizování: Vytvoří a nakonfiguruje potřebné prostředky Azure vyžadované aplikací pomocí souborů infrastruktury jako kódu.
3. Nasazení: Nasadí zabalenou aplikaci do zřízených prostředků Azure.

Každou z těchto fází můžete také spouštět jednotlivě pomocí příslušného příkazu, ale azd up poskytuje obálku pro usnadnění práce, která zjednodušuje celkový proces. Každá fáze hraje důležitou roli při zajištění hladkého a automatizovaného procesu nasazení. Fáze pracovního postupu můžete ovlivnit azd up pomocí konfigurací v souboru šablony azure.yaml . Následující části podrobněji probíjí jednotlivé fáze.

Fáze balení

Fáze balení je prvním krokem pracovního azd up postupu. Během této fáze:

• Kód aplikace je připravený k nasazení. V závislosti na programovacím jazyce, se kterým je aplikace šablony sestavená, může balení zahrnovat sestavení nebo kompilaci aplikace, sdružování závislostí nebo vytváření nasazovacích artefaktů, jako jsou Docker obrazy.
• Struktura azd šablony obvykle obsahuje src složku, ve které se nachází kód aplikace. Vytváření skriptů nebo konfiguračních souborů (například Souboru Dockerfile) může ovlivnit způsob zabalení aplikace.
• Soubor azure.yaml obsahuje mapování konfigurace, které říkají azd , kde se nachází kód aplikace a jaký jazyk používá, aby azd ho mohl správně zabalit.
• Tato fáze zajišťuje, že je aplikace v nasaditelném stavu před přechodem na další krok.

Proces balení můžete spustit samostatně mimo azd up pomocí příkazu azd package.

azd package

Příklady konfigurací balení

azd může zabalit aplikace vytvořené různými jazyky různými způsoby. Pokud například vaše aplikace používá kontejnerizovaný přístup, azd může šablona obsahovat Dockerfile v adresáři aplikace src . Fáze balení vytvoří image Dockeru pro aplikaci na základě tohoto souboru. Tyto konfigurace se spravují prostřednictvím azure.yaml souboru.

Představte si například následující strukturu projektu a konfigurace úvodní šablony hello-azd :

Na předchozím obrázku soubor azure.yaml :

• Definuje kód v src adresáři jako aplikaci v jazyce C#.
• Určuje umístění souboru Dockerfile, které se má použít k sestavení image kontejneru aplikace.

Když spustíte azd up (nebo azd package), Azure Developer CLI použije tuto kombinaci konfigurací k sestavení a zabalení kódu aplikace v src adresáři jako image kontejneru .NET. Pokud nebyl nakonfigurovaný soubor Dockerfile, azd mohl by také zabalit aplikaci .NET pomocí standardního procesu publikování .NET.

Fáze zřizování

Fáze zřizování vytvoří a nakonfiguruje požadované prostředky Azure pro vaši aplikaci. Vaše aplikace může například vyžadovat instanci služby Azure App Service k hostování samotné aplikace a účet úložiště Azure k uložení nahraných souborů. Fáze zřizování používá soubory infrastruktury jako kódu (IaC) zahrnuté v šabloně k definování prostředků.

Mezi klíčovými body, kterým je třeba porozumět ohledně fáze zřizování, patří:

1. azd podporuje Bicep i Terraform pro úlohy infrastruktury prostřednictvím kódu.
2. Ve výchozím nastavení jsou soubory infrastruktury jako kódu uloženy ve infra složce, ale toto umístění je možné přizpůsobit.
3. azd hledá soubor main.bicep nebo main.tf, které budou fungovat jako hlavní soubor orchestrace procesu IaC.

Proces zřizování můžete také spustit samostatně mimo azd up pomocí příkazu azd provision:

azd provision

Příklady konfigurací zřizování

Ve složce infra soubor main.bicep obecně definuje prostředky Azure, které azd by se měly pro aplikaci vytvořit. Podívejte se na následující fragment kódu z main.bicephello-azd úvodní šablony:

// ...omitted code for other resource configurations

// Create an Azure Cosmos DB account
module cosmos 'app/cosmos.bicep' = {
  name: 'cosmos'
  scope: rg
  params: {
    userPrincipalId: principalId
    managedIdentityId: identity.outputs.principalId
  }
}

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      { name: 'attachments' }
    ]
  }
}

// Container apps environment and registry
module containerAppsEnv './core/host/container-apps.bicep' = {
  name: 'container-apps'
  scope: rg
  params: {
    name: 'app'
    containerAppsEnvironmentName: !empty(containerAppsEnvName) ? containerAppsEnvName : '${abbrs.appManagedEnvironments}${resourceToken}'
    containerRegistryName: !empty(containerRegistryName) ? containerRegistryName : '${abbrs.containerRegistryRegistries}${resourceToken}'
    location: location
  }
}

// ...omitted code for other resource configurations

Pomocí předchozího kódu Bicep azd vytvoří následující prostředky:

• Instance Služby Azure Cosmos DB pro ukládání dat odeslaných prostřednictvím aplikace
• Účet Azure Storage pro ukládání nahraných obrázků
• Aplikace kontejneru Azure pro hostování aplikace

Fáze nasazení

Fáze nasazení je posledním krokem pracovního azd up postupu. Během této fáze:

• Artefakty aplikace vytvořené během fáze balení aplikace se nasazují na zřízené prostředky Azure.
• azd používá konfigurační soubory v šabloně, například azure.yaml, k určení způsobu nasazení aplikace.
• Proměnné prostředí a připojovací řetězce jsou nakonfigurované tak, aby zajistily, že aplikace může pracovat se zřízenými prostředky.

Proces nasazení můžete také spustit samostatně mimo azd up pomocí příkazu azd deploy.

azd deploy

Ukázkové konfigurace nasazení

azure.yaml Uvnitř souboru můžete určit, která služba v projektu se má nasadit do kterého prostředku Azure. Představte si například následující konfigurace úvodní šablony hello-azd :

metadata:
  template: hello-azd-dotnet
name: azd-starter
services:
  aca:
    project: ./src # The location of the service source code
    language: csharp
    host: containerapp # The provisioned resource to deploy the service to
    docker:
      path: ./Dockerfile

Předchozí kód dává pokyn azd k nasazení artefaktů zabalených z kódu ve složce src do containerapp, které bylo vytvořeno během fáze zřizování. Můžete také definovat více služeb a namapovat je na jiného hostitele.

Závěr

Pracovní azd up postup zjednodušuje proces nasazování aplikací do Azure automatizací fází balení, zřizování a nasazení. Vývojáři můžou zajistit konzistentní a efektivní proces nasazení tím, že budou dodržovat azd strukturu šablon. Bez ohledu na to, jestli nasazujete jednoduchou webovou aplikaci nebo složitou architekturu mikroslužeb, azd up příkaz zjednodušuje cestu z kódu do cloudu.