Sdílet prostřednictvím

Vytvoření prostředí ze šablony Azure Developer CLI

V tomto článku vytvoříte nové prostředí z existující šablony kompatibilní s Azure Developer CLI (azd) pomocí azd. Naučíte se konfigurovat prostředí nasazení Azure (ADE) a azd spolupracovat na zřizování infrastruktury aplikací a nasazování kódu aplikace do nové infrastruktury.

Pokud se chcete seznámit s klíčovými koncepty spolupráce azd a ADE, přečtěte si téma Použití Azure Developer CLI s prostředími nasazení Azure.

Požadavky

  • Vytvoření a konfigurace vývojového centra pomocí projektu, typů prostředí a katalogu Jako doprovodné materiály použijte následující článek:

Připojení katalogu Microsoftu pro rychlý start

Microsoft poskytuje katalog rychlých startů, který obsahuje sadu kompatibilních azd šablon, které můžete použít k vytváření prostředí. Katalog rychlých startů můžete připojit k vývojovému centru při vytváření nebo ho přidat později. Katalog rychlých startů obsahuje sadu šablon, které můžete použít k vytváření prostředí.

Prozkoumání azd kompatibilní šablony

Existující kompatibilní šablonu můžete použít azd k vytvoření nového prostředí nebo můžete do úložiště přidat soubor azure.yaml. V této části prozkoumáte existující azd kompatibilní šablonu.

azd zřizování pro prostředí závisí na kurátorovaných šablonách z katalogu. Šablony v katalogu můžou přiřazovat značky zřízeným prostředkům Azure, abyste mohli přidružit služby App Services v souboru azure.yaml nebo prostředky explicitně zadat. V tomto příkladu jsou prostředky explicitně zadány.

Další informace o označování prostředků najdete v tématu Označování prostředků pro prostředí nasazení Azure.

  1. Na webu Azure Portal přejděte do vývojového centra.

  2. V nabídce vlevo v části Konfigurace prostředí vyberte Katalogy a zkopírujte adresu URL pro rychlý start clone katalogu.

    Snímek obrazovky webu Azure Portal zobrazující katalogy připojené k vývojovému centru se zvýrazněnou adresou URL klonování

  3. Pokud chcete zobrazit katalog rychlých startů na GitHubu, vložte adresu URL klonování do adresního řádku a stiskněte Enter. Nebo můžete použít následující adresu URL: katalog Microsoftu pro rychlý start.

  4. V úložišti GitHub přejděte do složky Environment-Definitions/ARMTemplates/Function-App-with-Cosmos_AZD-template .

  5. Otevřete soubor environment.yaml. Na konci souboru uvidíte povolená úložiště, která obsahují ukázkový zdrojový kód aplikace.

    Snímek obrazovky úložiště GitHub se zvýrazněným souborem environment.yaml se zvýrazněnými zdrojovými šablonami

  6. https://github.com/azure-samples/todo-python-mongo-swa-func Zkopírujte adresu URL úložiště a přejděte do úložiště na GitHubu.

  7. V kořenovém adresáři úložiště otevřete soubor azure.yaml .

  8. V souboru azure.yaml se v části služby zobrazí webové služby a služby rozhraní API definované v šabloně.

Poznámka:

Ne všechny azd kompatibilní katalogy používají strukturu propojených šablon zobrazený v příkladu. Jeden katalog můžete použít pro všechna vaše prostředí zahrnutím souboru azure.yaml. Použití více katalogů a úložišť kódu umožňuje větší flexibilitu při konfiguraci zabezpečeného přístupu pro techniky platformy a vývojáře.

Pokud pracujete s vlastní definicí katalogu a prostředí, můžete v kořenovém adresáři úložiště vytvořit soubor azure.yaml. Pomocí souboru azure.yaml definujte služby, které chcete nasadit do prostředí.

Vytvoření prostředí z existující šablony

K vytvoření nového prostředí použijte existující azd kompatibilní šablonu.

Příprava na práci s azd

Když pracujete azd poprvé, je potřeba provést několik jednorázových úloh nastavení. Mezi tyto úlohy patří instalace Azure Developer CLI, přihlášení k účtu Azure a povolení azd podpory pro prostředí nasazení Azure.

Instalace rozšíření Azure Developer CLI

Při instalaci azdazd se nástroje instalují v azd oboru, nikoli v globálním měřítku, a pokud jsou odinstalovány, odeberou azd se. V editoru Visual Studio Code můžete nainstalovat azd z příkazového řádku nebo v sadě Visual Studio.

Pokud chcete povolit funkce Azure Developer CLI v editoru Visual Studio Code, nainstalujte rozšíření Azure Developer CLI. Na panelu aktivit vyberte ikonu Rozšíření, vyhledejte Azure Developer CLI a pak vyberte Nainstalovat.

Snímek obrazovky editoru Visual Studio Code s příkazem Přihlásit se na paletě příkazů

Přihlášení pomocí Azure Developer CLI

Přístup k prostředkům Azure získáte přihlášením. Když zahájíte přihlášení, otevře se okno prohlížeče a vyzve vás, abyste se přihlásili k Azure. Po přihlášení se v terminálu zobrazí zpráva, že jste přihlášení k Azure.

Přihlaste se k azd používání palety příkazů:

Snímek obrazovky editoru Visual Studio Code zobrazující podokno Rozšíření se zvýrazněným rozhraním příkazového řádku pro vývojáře Azure a zvýrazněnou možností Instalace

Výstup příkazů vydaných z palety příkazů se zobrazí v terminálu azd dev jako v následujícím příkladu:

Snímek obrazovky s terminálem pro vývojáře AZD a stisknutím libovolné klávesy zprávu zavřete.

Povolení azd podpory pro ADE

Pokud platform.type je nastavená hodnota devcenter, veškerý azd stav vzdáleného prostředí a zřizování používá komponenty dev Center. azd používá jednu ze šablon infrastruktury definovaných v katalogu dev center pro zřizování prostředků. V této konfiguraci se složka infra v místních šablonách nepoužívá.

Snímek obrazovky editoru Visual Studio Code s příkazem Povolit podporu na paletě příkazů

Vytvoření nového prostředí

Teď jste připraveni vytvořit prostředí pro práci. Začnete s existující šablonou. ADE definuje infrastrukturu pro vaši aplikaci a azd šablona poskytuje vzorový kód aplikace.

  1. V editoru Visual Studio Code otevřete prázdnou složku.

  2. Otevřete paletu příkazů, zadejte init Azure Developer CLI a pak v seznamu vyberte Azure Developer CLI (azd): init.

    Snímek obrazovky s paletou příkazů editoru Visual Studio Code se zvýrazněnou možností Azure Developer CLI (azd): init

  3. V seznamu šablon vyberte Function-App-with-Cosmos_AZD-template.

    Snímek obrazovky s paletou příkazů editoru Visual Studio Code se zvýrazněným seznamem šablon, zvýrazněnou aplikací funkcí

  4. azd V terminálu zadejte název prostředí.

    Snímek obrazovky s terminálem Azure Developer zobrazující výzvu k zadání nového názvu prostředí

  5. Vyberte projekt.

    Snímek obrazovky s terminálem Azure Developer a výzvou k výběru projektu

  6. Vyberte definici prostředí.

    Snímek obrazovky terminálu Azure Developer s výzvou k výběru definice prostředí

    azd vytvoří prostředky projektu, včetně souboru azure.yaml v kořenovém adresáři projektu.

Konfigurace devcenter

Nastavení pro vývojová centra můžete definovat azd tak, abyste je nemuseli při každé aktualizaci prostředí zadávat. V tomto příkladu definujete názvy katalogu, vývojového centra a projektu, které používáte pro své prostředí.

  1. V editoru Visual Studio Code přejděte do souboru azure.yaml v kořenovém adresáři projektu.

  2. Do souboru azure.yaml přidejte následující nastavení:

    platform:
    type: devcenter
    config:
        catalog: MS-cat
        name: Contoso-DevCenter
        project: Contoso-Dev-project

    Snímek obrazovky se souborem azure.yaml se zvýrazněným nastavením dev Center

Další informace o nastaveních, která můžete konfigurovat, najdete v tématu Konfigurace nastavení dev center.

Zřízení prostředí

Můžete použít azd ke zřízení a nasazení prostředků do prostředí nasazení pomocí příkazů jako azd up nebo azd provision.

Další informace o zřizování prostředí najdete v tématu Práce s prostředími nasazení Azure.

Související obsah

  • Last updated on