V tomto rychlém startu se dozvíte, jak zřídit a nasadit prostředky aplikace do Azure pomocí azd Azure Developer CLI () a jenom několika azd příkazů.
azd Šablony jsou standardní úložiště kódu, která zahrnují zdrojový kód vaší aplikace a azd soubory konfigurace a infrastruktury pro zřizování prostředků Azure. Další informace o azd šablonách a o tom, jak můžou urychlit proces zřizování a nasazení Azure, najdete v tématu Co jsou šablony Azure Developer CLI?
Výběr a nasazení šablony
V následujících krocích použijete následující šablonu ke zřízení a nasazení aplikace v Azure:
Šablonu, která odpovídá vašim preferencím, můžete také vybrat z webu galerie šablon Awesome AZD . Bez ohledu na to, kterou šablonu použijete, skončíte kódem šablony ve vývojovém prostředí a budete moct spouštět příkazy pro sestavení, opětovné nasazení a monitorování aplikace v Azure.
Pokračujte výběrem upřednostňovaného prostředí:
Místní vývojové prostředí je skvělou volbou pro tradiční vývojové pracovní postupy. Úložiště šablon naklonujete do svého zařízení a spustíte příkazy proti místní instalaci azd.
Požadavky
Inicializace projektu
V Průzkumník souborů nebo terminálu vytvořte nový prázdný adresář a změňte ho na něj.
azd init Spusťte příkaz a zadejte šablonu, kterou chcete použít jako parametr:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Po zobrazení výzvy zadejte název prostředí, například azdquickstart, který nastaví předponu pojmenování pro skupinu prostředků, která se vytvoří pro uložení prostředků Azure.
Co je název azdprostředí?
Po zadání prostředí azd naklonuje projekt šablony do počítače a inicializuje projekt.
Zřízení a nasazení prostředků aplikace
azd auth login Spusťte příkaz a azd spustíte prohlížeč, abyste mohli dokončit proces přihlášení.
azd auth login
azd up Spusťte příkaz:
azd up
Po přihlášení k Azure se zobrazí výzva k zadání následujících informací:
| Parametr |
Popis |
Azure Location |
Umístění Azure, ve kterém budou vaše prostředky nasazeny. |
Azure Subscription |
Předplatné Azure, ve kterém se vaše prostředky nasadí. |
Vyberte požadované hodnoty a stiskněte enter. Příkaz azd up za vás zpracovává následující úlohy pomocí konfiguračních souborů šablony a souborů infrastruktury:
- Vytvoří a nakonfiguruje všechny potřebné prostředky Azure (
azd provisionvčetně:
- Zásady přístupu a role pro váš účet
- Komunikace mezi službami se spravovanými identitami
- Balíčky a nasadí kód (
azd deploy)
azd up Po úspěšném dokončení příkazu se v rozhraní příkazového řádku zobrazí dva odkazy pro zobrazení prostředků vytvořených:
- Aplikace toDo API
- Front-end webové aplikace toDo
Poznámka:
Můžete volat azd up tolikrát, kolikrát chcete zřizovat a nasazovat aktualizace do aplikace.
Nasazení může selhat kvůli neplněným prostředkům ve vybrané oblasti. Vzhledem k tomu, že se jedná o rychlý start, je bezpečné adresář odstranit .azure a zkusit to azd up znovu. Po zobrazení výzvy vyberte jinou oblast. V pokročilejším scénáři můžete selektivně upravovat soubory v adresáři .azure a měnit oblast.
Azure Developer CLI poskytuje rozšíření editoru Visual Studio Code, které zjednodušuje práci s funkcemi azd . Ke spouštění azd příkazů můžete například použít rozhraní palety příkazů. Abyste mohli dokončit kroky dopředu, budete muset nainstalovat rozšíření Azure Developer CLI pro Visual Studio Code.
Instalace rozšíření Azure Developer CLI
Otevřete Visual Studio Code.
V nabídce Zobrazení vyberte Rozšíření.
Do vyhledávacího pole zadejte Azure Developer CLI.
Vyberte Nainstalovat a počkejte na dokončení procesu instalace.
Inicializace nové aplikace
Otevřete prázdný adresář v editoru Visual Studio Code.
V nabídce Zobrazení vyberte Paleta příkazů....
Vyhledejte Azure Developer CLI (azd): Initialize app (init) příkaz a stiskněte enter. Příkaz azd up dává azd pokyn ke zřízení a nasazení prostředků aplikace.
Zvolte pracovní postup Vybrat šablonu .
Vyhledejte webovou aplikaci React s rozhraním API Node.js a MongoDB v šabloně Azure a stisknutím klávesy Enter ji vyberte.
Visual Studio Code naklonuje azd šablonu. Šablona obsahuje infrastrukturu infra jako soubory kódu ve složce a ukázkovou aplikaci ve src složce. Soubory infraštruktury jako kódu zajišťují potřebné prostředky na Azure, které aplikace vyžaduje při nasazení.
Vyhledejte webovou aplikaci React s rozhraním PYTHON API a MongoDB v šabloně Azure a stisknutím klávesy Enter ji vyberte.
Visual Studio Code naklonuje azd šablonu. Šablona obsahuje infrastrukturu infra jako soubory kódu ve složce a ukázkovou aplikaci ve src složce. Infrastruktura jako soubory kódu zřizují požadované prostředky v Azure vyžadované aplikací při nasazení.
Vyhledejte webovou aplikaci React s rozhraním API jazyka C# a MongoDB v šabloně Azure a stisknutím klávesy Enter ji vyberte.
Visual Studio Code naklonuje azd šablonu. Šablona obsahuje infrastrukturu infra jako soubory kódu ve složce a ukázkovou aplikaci ve src složce. Soubory infrastruktury jako kódu zřídí požadované prostředky na Azure, které jsou potřeba pro aplikaci při jejím nasazení.
Vyhledejte kontejnerizovanou webovou aplikaci React pomocí rozhraní Java API a MongoDB v šabloně Azure a stisknutím klávesy Enter ji vyberte.awesome-azd.
Visual Studio Code naklonuje šablonu azd. Šablona obsahuje infrastrukturu infra jako soubory kódu ve složce a ukázkovou aplikaci ve src složce. Infrastruktura jako soubory kódu zřizují požadované prostředky v Azure vyžadované aplikací při nasazení.
Po naklonování šablony visual Studio Code otevře terminál s výzvou k zadání názvu prostředí. Zadejte krátký název svého výběru, například azdvscode , a stiskněte enter.
Enter a new environment name: [? for help] azdvscode
Název prostředí ovlivňuje pojmenování prostředků zřízených v Azure a vytvoří složku v .azure adresáři šablony pro uložení určitých nastavení prostředí.
Zřízení a nasazení prostředků aplikace
Otevřete paletu příkazů a vyhledejte Azure Developer CLI (azd): Package, Provision and Deploy(up) příkaz a stiskněte enter. Příkaz azd up dává azd pokyn ke zřízení a nasazení prostředků aplikace.
Visual Studio Code otevře okno terminálu, ve kterém se zobrazí průběh procesu zřizování a nasazení.
azd používá nastavení předplatného a umístění, které jste vybrali během init procesu při nasazování prostředků.
Poznámka:
Proces zřizování a nasazení může trvat několik minut.
Po dokončení procesu nasazení vyberte odkaz ve výstupním okně poskytovaném pomocí azd, abyste spustili svůj web v prohlížeči.
Codespaces jsou skvělou volbou pro vývojáře, kteří dávají přednost práci v kontejnerizovaných cloudových prostředích a vyhněte se místní instalaci nástrojů nebo závislostí.
Nastavení codespace
- Nad seznamem souborů klepněte na tlačítko Použít tuto šablonu>Otevřít v codespace.
S Codespaces jsou pro vás nainstalované všechny požadavky, včetně azd rozšíření Visual Studio Code.
Spustit šablonu
Po vytvoření Codespace klikněte pravým tlačítkem na azure.yaml v kořenovém adresáři. V možnostech vyberte (zřiďte prostředky a nasaďte kód do Azure).
Po spuštění azd up příkazu se zobrazí výzva k zadání následujících informací a přihlášení pomocí webového prohlížeče a ověřovacího kódu:
| Parametr |
Popis |
Environment Name |
Předpona pro skupinu prostředků, která se vytvoří pro uložení všech prostředků Azure. Co je název azdprostředí? Vždy můžete vytvořit nové prostředí pomocí azd env newnástroje . |
Azure Location |
Umístění Azure, ve kterém budou vaše prostředky nasazeny. |
Azure Subscription |
Předplatné Azure, ve kterém se vaše prostředky nasadí. |
Dokončení tohoto procesu může nějakou dobu trvat, protože azd up příkaz zpracovává následující úlohy:
- Vytvoří a nakonfiguruje všechny potřebné prostředky Azure (
azd provision).
- Konfiguruje zásady přístupu a role pro váš účet.
- Implementuje komunikaci mezi službami se spravovanými identitami.
- Balíčky a nasadí kód (
azd deploy).
Po zadání potřebných parametrů a azd up dokončení příkazu se v terminálu CodeSpaces zobrazí dva odkazy webu Azure Portal pro zobrazení vytvořených prostředků:
- Aplikace toDo API
- Front-end webové aplikace toDo
Co se stalo?
Po úspěšném dokončení azd up příkazu:
- Prostředky
README.md šablony byly zřízeny pro předplatné Azure, které jste zadali po spuštění azd up. Tyto prostředky Azure teď můžete zobrazit prostřednictvím webu Azure Portal.
- Aplikace byla sestavena a nasazena do Azure. Pomocí výstupu
azd up adresy URL webové aplikace z příkazu můžete přejít do plně funkční aplikace.
Poznámka:
- Aplikaci můžete zřizovat
azd up i nasazovat tolikrát, kolikrát chcete.
- Spuštění a ladění, které vyžaduje spuštění webového prohlížeče, se v současné době nepodporuje kvůli známému omezení u GitHub Codespaces. Pro lepší prostředí doporučujeme používat Codespaces v Desktopu.
DevContainer je image Dockeru, která obsahuje všechny požadavky, které potřebujete k práci se šablonou azd na místním počítači. Jsou skvělou volbou pro vývojáře, kteří dávají přednost kontejnerizovaným prostředím, která stále běží na místním zařízení místo cloudové služby, jako je GitHub Codespaces.
Požadavky
Inicializace projektu
Otevřete terminál, vytvořte nový prázdný adresář a změňte ho na něj.
Spuštěním následujícího příkazu inicializujete projekt:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Po spuštění azd init příkazu se zobrazí výzva k zadání následujících informací:
| Parametr |
Popis |
Environment Name |
Předpona pro skupinu prostředků, která se vytvoří pro uložení všech prostředků Azure. Co je název azdprostředí? Vždy můžete vytvořit nové prostředí pomocí azd env newnástroje . |
Otevření devContaineru
- Otevřete projekt v editoru VS Code.
- Stiskněte klávesu F1 a zvolte:
Remote-Containers: Rebuild and Reopen in Container
Příkaz Spustit up
Spusťte následující příkaz:
azd up
Po spuštění azd up příkazu se zobrazí výzva k zadání následujících informací:
| Parametr |
Popis |
Azure Location |
Umístění Azure, ve kterém budou vaše prostředky nasazeny. |
Azure Subscription |
Předplatné Azure, ve kterém se vaše prostředky nasadí. |
Spuštění azd up příkazu může nějakou dobu trvat, protože provede následující kroky:
- Vytvoří a nakonfiguruje všechny potřebné prostředky Azure (
azd provisionvčetně:
- Zásady přístupu a role pro váš účet
- Komunikace mezi službami se spravovanými identitami
- Balíčky a nasadí kód (
azd deploy)
Po zadání nezbytných parametrů a azd up dokončení příkazu se v rozhraní příkazového řádku zobrazí dva odkazy na azure Portal pro zobrazení vytvořených prostředků:
- Aplikace toDo API
- Front-end webové aplikace toDo
Poznámka:
Aplikaci můžete spustit azd up tolikrát, kolikrát chcete zřídit a nasadit do stejné oblasti a se stejnými konfiguračními hodnotami, které jste zadali při prvním spuštění.
Vyčištění prostředků
Pokud už prostředky vytvořené v tomto článku nepotřebujete, spusťte následující příkaz a spusťte aplikaci:
azd down
Pokud chcete znovu nasadit jinou oblast, odstraňte .azure adresář před dalším spuštěním azd up . V pokročilejším scénáři můžete selektivně upravovat soubory v adresáři .azure a měnit oblast.
Požádat o pomoc
Informace o tom, jak vytvořit chybu, požádat o pomoc nebo navrhnout novou funkci pro Azure Developer CLI, najdete na stránce pro řešení potíží a podporu .
Další kroky