Kurz: Nasazení projektu .NET Aspire pomocí Azure Developer CLI

Azure Developer CLI (azd) umožňuje nasadit .NET Aspire projekty pomocí GitHub Akcí nebo Azure kanálů DevOps tím, že automaticky nakonfiguruje požadovaná nastavení ověřování a prostředí. Tento článek vás provede procesem vytvoření a nasazení projektu .NET Aspire na Azure Container Apps pomocí azd. Seznámíte se s následujícími koncepty:

• Prozkoumání fungování integrace azd s projekty .NET.NET Aspire
• Vytvoření a konfigurace úložiště GitHub nebo Azure DevOps pro projekt .NET Aspire pomocí azd
• Monitorování a prozkoumání pracovního postupu akcí GitHub nebo Azure spouštění kanálů DevOps a nasazení Azure

Požadavky

Pokud chcete pracovat s .NET.NET Aspire, potřebujete místně nainstalovat následující:

• .NET 8.0 nebo .NET 9.0
• Modul runtime kontejneru kompatibilní s OCI, například:
  • Docker Desktop nebo Podman. Pro více informací, viz běhové prostředí kontejneru.
• Integrované vývojové prostředí (IDE) nebo editor kódu, například:
  • Visual Studio 2022 verze 17.9 nebo novější (volitelné)
  • Visual Studio Code (volitelné)
    • C# Dev Kit: Rozšíření (volitelné)
  • JetBrains Rider s .NET.NET Aspire plug-inem (volitelné)

Další informace najdete v tématu .NET.NET Aspire nastavení a nástrojea .NET.NET Aspire SDK.

• Vytvořte Azure organizaci DevOps nebo zvolte existující organizaci.
• Vytvořte Azure DevOps PAT (Personal Access Token) a uložte ho pro pozdější použití. Nakonfigurujte token s následujícími oprávněními:
  • Fondy agentů (čtení, správa)
  • Sestavení (čtení a spuštění)
  • Kód (plný)
  • Projekt a tým (číst, psát a spravovat)
  • Uvolnění (čtení, zápis, spouštění a správa)
  • Připojení služeb (čtení, dotazování a správa)

Musíte mít také Azure Developer CLInainstalované místně (verze 1.5.1 nebo vyšší). Mezi běžné možnosti instalace patří:

Windows

winget install microsoft.azd

brew tap azure/azd && brew install azd

Linux

curl -fsSL https://aka.ms/install-azd.sh | bash

Vytvořte řešení .NET.NET Aspire

Jako výchozí bod se v tomto článku předpokládá, že jste vytvořili řešení .NET.NET Aspire ze šablony .NET.NET Aspire Starter Application. Další informace najdete v tématu Rychlý start: Vytvoření první .NET.NET Aspire aplikace.

Inicializovat šablonu

1. Otevřete nové okno terminálu a přejděte příkazem cd do adresáře řešení .NET.NET Aspire.

2. Spuštěním příkazu azd init inicializovat projekt pomocí azd, který zkontroluje místní adresářovou strukturu a určí typ aplikace.

   azd init
   

   Další informace o příkazu azd init naleznete v tématu azd init.

3. Vyberte Použít kód v aktuálním adresáři, když azd zobrazí výzvu se dvěma možnostmi inicializace aplikace.

   ? How do you want to initialize your app?  [Use arrows to move, type to filter]
   > Use code in the current directory
     Select a template
   

4. Po kontrole adresáře azd zobrazí výzvu k potvrzení, že našel správný projekt .NET.NET AspireAppHost. Vyberte možnost Potvrdit a pokračovat v inicializaci mojí aplikace.

   Detected services:
   
     .NET (Aspire)
     Detected in: D:\source\repos\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj
   
   azd will generate the files necessary to host your app on Azure using Azure Container Apps.
   
   ? Select an option  [Use arrows to move, type to filter]
   > Confirm and continue initializing my app
     Cancel and exit
   

5. Zadejte název prostředí, který se používá k pojmenování zřízených prostředků v Azure a správě různých prostředí, jako jsou dev a prod.

   Generating files to run your app on Azure:
   
     (✓) Done: Generating ./azure.yaml
     (✓) Done: Generating ./next-steps.md
   
   SUCCESS: Your app is ready for the cloud!
   You can provision and deploy your app to Azure by running the azd up command in this directory. For more information on configuring your app, see ./next-steps.md
   

azd vygeneruje řadu souborů a umístí je do pracovního adresáře. Tyto soubory:

• azure.yaml: Popisuje služby aplikace, například projekt .NET Aspire AppHost, a mapuje je na Azure prostředky.
• .azure/config.json: Konfigurační soubor, který informuje azd, jaké je aktuální aktivní prostředí.
• .azure/aspireazddev/.env: Obsahuje přepisy specifické pro prostředí.

Vytvořte úložiště GitHub a pipeline

Azure Developer CLI umožňuje automaticky vytvářet kanály CI/CD se správnými konfiguracemi a oprávněními ke zřizování a nasazování prostředků do Azure. azd můžete také vytvořit úložiště GitHub pro vaši aplikaci, pokud ještě neexistuje.

1. Spuštěním příkazu azd pipeline config nakonfigurujte kanál nasazení a bezpečně ho připojte k Azure:

   azd pipeline config
   

2. Vyberte předplatné, do které chcete zřídit a nasadit prostředky aplikace.

3. Vyberte umístění Azure, které chcete použít pro zdroje.

4. Po zobrazení výzvy, zda chcete vytvořit nové úložiště Git v adresáři, zadejte y a stiskněte Enter.

   Poznámka

   Vytvoření úložiště GitHub vyžaduje, abyste byli přihlášeni k GitHub. Existuje několik výběrů, které se liší podle vašich preferencí. Po přihlášení se zobrazí výzva k vytvoření nového úložiště v aktuálním adresáři.

5. Vyberte Vytvořit nové privátní úložiště GitHub a nakonfigurujte vzdálené úložiště Git.

6. Zadejte název podle svého výběru pro nové úložiště GitHub nebo stiskněte enter a použijte výchozí název. azd vytvoří v GitHub nové úložiště a nakonfiguruje ho s potřebnými tajnými kódy potřebnými k ověření v Azure.

   

7. Zadejte a, abyste pokračovali, až vás azd vyzve k potvrzení a nasdílení místních změn, čímž se spustí nakonfigurovaný pipeline.

Prozkoumání pracovního postupu a nasazení akcí GitHub

1. Přejděte do nového úložiště GitHub pomocí výstupu odkazu azd.

2. Pokud chcete zobrazit pracovní postupy úložiště, vyberte kartu Akce. Měl by se zobrazit nový pracovní postup spuštěný nebo již dokončený. Výběrem pracovního postupu zobrazíte kroky úlohy a podrobnosti v protokolech spuštění. Například můžete rozbalit kroky, jako Nainstalovat .NET.NET Aspire Pracovní zátěž nebo Nasadit aplikaci, abyste mohli vidět podrobnosti o dokončené akci.

   

3. Vyberte Nasadit aplikaci, kterým rozbalíte protokoly pro tento krok. Měli byste vidět dvě adresy URL koncového bodu vytištěné pro apiservice a webfrontend. Výběrem některého z těchto odkazů je otevřete na jiné kartě prohlížeče a prozkoumejte nasazenou aplikaci.

   

Blahopřejeme! Úspěšně jste nasadili projekt .NET Aspire pomocí Azure Developer CLI a akcí GitHub.

Vytvoření úložiště a kanálu DevOps Azure

Důležitý

Jak je uvedeno v požadavcích, budete muset vytvořit organizaci Azure DevOps nebo vybrat existující organizaci, abyste dokončili následující kroky. Budete také muset vytvořit token PAT (Personal Access Token) s oprávněními uvedenými v požadavcích.

Azure Developer CLI umožňuje automaticky vytvářet kanály se správnými konfiguracemi a oprávněními ke zřizování a nasazování prostředků do Azure. azd může také vytvořit úložiště Azure Pipelines pro vaši aplikaci, pokud ještě neexistuje.

1. Spuštěním příkazu azd pipeline config nakonfigurujte kanál nasazení a bezpečně ho připojte k Azure. Místo výchozí konfigurace --provider azdo Akcí zahrňte možnost Azure, abyste použili kanály GitHub.

   azd pipeline config --provider azdo
   

2. Vyberte předplatné, do které chcete zřídit a nasadit prostředky aplikace.

3. Vyberte umístění Azure, které chcete použít pro zdroje.

4. Vložte osobní přístupový token, který jste vytvořili dříve.

5. Zadejte Azure název organizace DevOps, který jste vytvořili nebo vybrali.

6. Po zobrazení výzvy k vytvoření nového úložiště v aktuálním adresáři zadejte y a stiskněte Enter.

7. Po zobrazení výzvy ke konfiguraci git remote vyberte Vytvořit nový Azure Projekt DevOps.

8. Zadejte jedinečný název vašeho výběru pro nové úložiště, například aspireazd. azd vytvoří v úložištích Azure nové úložiště a nakonfiguruje ho s potřebnými tajnými kódy potřebnými k ověření v Azure.

   

9. Zadejte a, abyste pokračovali, až vás azd vyzve k potvrzení a nasdílení místních změn, čímž se spustí nakonfigurovaný pipeline.

Prozkoumejte řetězec a nasazenou aplikaci

1. Přejděte na nový tok dat Azure pomocí odkazu na stav, který je poskytován výstupem azd.

   

2. Výběrem dokončeného běhu kanálu zobrazíte souhrn.

   

3. Výběrem odkazu na úlohu v dolní části zobrazení přejděte na podrobnosti úlohy.

   

4. Na stránce podrobností úlohy se zobrazuje stav všech jednotlivých fází. Vyberte Zřízení infrastruktury, chcete-li zobrazit protokoly pro tuto fázi, které podrobně popisují všechny kroky zřizování dokončené azd. Na spodní části protokolů si poznamenejte konečnou zprávu o stavu a odkaz na zřízenou skupinu prostředků Azure.

5. Vyberte odkaz v dolní části výstupních protokolů zřizování a přejděte do nové skupiny prostředků Azure.

   

   Poznámka

   Můžete také přejít přímo do nové skupiny prostředků tak, že ji vyhledáte na portálu Azure. Název vaší skupiny prostředků bude název prostředí s předponou azd, který jste zadali pro rg-.

6. Vyberte webfrontend kontejnerovou aplikaci, která hostuje veřejně přístupnou část webu.

7. Na stránce Podrobnosti webového rozhraní vyberte odkaz Adresa Url aplikace a otevřete svůj web v prohlížeči.

Důležitý

Pokud při prohlížení webu v prohlížeči dojde k 403 Forbidden chybě, ujistěte se, že jsou nastavení příchozího přístupu správně nakonfigurovaná. Na stránce aplikace webfrontend na portálu Azure přejděte na Ingress v levém navigačním panelu. Ujistěte se, že Příchozí přenos dat je nastaven na Příjem provozu odkudkoli a uložte změny.

Blahopřejeme! Úspěšně jste nasadili projekt .NET Aspire pomocí kanálů Azure Developer CLI a Azure.

Uvolnění prostředků

Spuštěním následujícího příkazu rozhraní příkazového řádku Azure odstraňte skupinu prostředků, pokud už nepotřebujete Azure prostředky, které jste vytvořili. Odstraněním skupiny prostředků se odstraní také prostředky obsažené v této skupině.

az group delete --name <your-resource-group-name>

Další informace najdete v tématu Vyčištění prostředků v Azure.