Delen via

Azure Developer CLI gebruiken met Azure Deployment Environments

  • Artikel

In dit artikel leert u meer over Azure Developer CLI (azd) en hoe het werkt met Azure Deployment Environments (ADE) om de toepassingsinfrastructuur in te richten en toepassingscode te implementeren in de nieuwe infrastructuur.

De Azure Developer CLI (azd) is een opensource-opdrachtregelprogramma dat ontwikkelaarsvriendelijke opdrachten biedt die zijn toegewezen aan belangrijke fasen in uw werkstroom. U kunt lokaal op uw computer installeren azd of gebruiken in andere omgevingen.

Met ADE kunt u omgevingen maken op basis van een omgevingsdefinitie in een catalogus die is gekoppeld aan uw ontwikkelaarscentrum. Door toe te voegen azd, kunt u uw toepassingscode implementeren in de nieuwe infrastructuur.

Hoe werkt azd het met ADE?

azd werkt met ADE om u in staat te stellen omgevingen te maken van waaruit u werkt.

Met ADE en azdkunnen individuele ontwikkelaars die werken met een unieke infrastructuur en code die ze willen uploaden naar de cloud een omgeving maken vanuit een lokale map. Ze kunnen een azd omgeving inrichten en hun code naadloos implementeren.

Op schaal kunt u met behulp van ADE en azd samen ontwikkelaars een manier bieden om app-infrastructuur en code te maken. Uw team kan meerdere ADE-omgevingen maken op basis van dezelfde azd compatibele omgevingsdefinitie en code inrichten in de cloud op een consistente manier.

Sjablonen begrijpen azd

De Azure Developer CLI-opdrachten zijn ontworpen voor gebruik met gestandaardiseerde sjablonen. Elke sjabloon is een codeopslagplaats die voldoet aan specifieke bestands- en mapconventies. De sjablonen bevatten de assets azd die nodig zijn om een Azure Deployment Environment-omgeving in te richten. Wanneer u een opdracht als volgt azd upuitvoert, gebruikt het hulpprogramma de sjabloonassets om verschillende werkstroomstappen uit te voeren, zoals het inrichten of implementeren van resources in Azure.

Hier volgt een typische sjabloonstructuur:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Alle azd sjablonen bevatten de volgende assets:

  • infra-map - De inframap wordt niet gebruikt in azd met ADE. Het bevat alle Bicep- of Terraform-infrastructuur als codebestanden voor de azd-sjabloon. ADE biedt de infrastructuur als codebestanden voor de azd sjabloon. U hoeft deze bestanden niet op te nemen in uw azd sjabloon.

  • azure.yaml-bestand : een configuratiebestand dat een of meer services in uw project definieert en deze toe wijst aan Azure-resources voor implementatie. U kunt bijvoorbeeld een API-service en een webfront-endservice definiëren, elk met kenmerken die deze toewijzen aan verschillende Azure-resources voor implementatie.

  • .azure-map : bevat essentiële Azure-configuraties en omgevingsvariabelen, zoals de locatie voor het implementeren van resources of andere abonnementsgegevens.

  • src-map : bevat alle broncode van de implementeerbare app. Sommige azd sjablonen bieden alleen infrastructuurassets en laten de src-map leeg zodat u uw eigen toepassingscode kunt toevoegen.

De meeste azd sjablonen bevatten desgewenst ook een of meer van de volgende mappen:

  • .devcontainer-map : hiermee kunt u een Dev Container-omgeving instellen voor uw toepassing. Dit is een algemene benadering van de ontwikkelomgeving die niet specifiek is voor azd.

  • .github-map : bevat de CI/CD-werkstroombestanden voor GitHub Actions. Dit is de standaard CI/CD-provider voor azd.

  • .azdo folder - Als u besluit Azure Pipelines te gebruiken voor CI/CD, definieert u de werkstroomconfiguratiebestanden in deze map.

azd compatibele catalogi

Catalogussen met Azure Deployment Environments bestaan uit omgevingsdefinities: IaC-sjablonen die de infrastructuurbronnen definiëren die zijn ingericht voor een implementatieomgeving. Azure Developer CLI maakt gebruik van omgevingsdefinities in de catalogus die is gekoppeld aan het ontwikkelaarscentrum om nieuwe omgevingen in te richten.

Notitie

Momenteel werkt Azure Developer CLI met ARM-sjablonen die zijn opgeslagen in de ontwikkelaarscentrumcatalogus van Azure Deployment Environments.

Voor een juiste ondersteuning van bepaalde Azure Compute-services vereist Azure Developer CLI meer configuratie-instellingen in de IaC-sjabloon. U moet bijvoorbeeld app-servicehosts taggen met specifieke informatie, zodat azd u weet hoe u de hosts kunt vinden en de app erop kunt implementeren.

Hier ziet u een lijst met ondersteunde Azure-services: Ondersteunde Azure-rekenservices (host).

Uw ADE-catalogus compatibel maken met azd

Als u uw ontwikkelteams azd met ADE wilt inschakelen, moet u een omgevingsdefinitie maken in uw catalogus die compatibel is met azd. U kunt een nieuwe azdcompatibele omgevingsdefinitie maken of u kunt een bestaande omgevingsdefinitie gebruiken uit de ontwikkelaarscentrumcatalogus van Azure Deployment Environments. Als u ervoor kiest om een bestaande omgevingsdefinitie te gebruiken, moet u enkele wijzigingen aanbrengen om deze compatibel te maken met azd.

De wijzigingen omvatten:

  • Als u een bestaande azd sjabloon wijzigt, verwijdert u de infra map. ADE gebruikt de volgende bestanden om de infrastructuur te maken:
    • ARM-sjabloon (azuredeploy.json.)
    • Configuratiebestand dat parameters definieert (environment.yaml of manifest.yaml)
  • Tag resources in azure.yaml met specifieke informatie, zodat azd u weet hoe u de hosts kunt vinden en de app erop kunt implementeren.
  • Configureer instellingen voor ontwikkelaarscentrums, zoals omgevingsvariabelen, azd omgevingsconfiguratie, azd projectconfiguratie en gebruikersconfiguratie.

Zie Uw project compatibel maken met Azure Developer CLI voor meer informatie over het compatibel azdmaken van uw ADE-omgevingsdefinitie.

Ondersteuning inschakelen azd in ADE

Als u ondersteuning met ADE wilt inschakelen azd , moet u het op platform.type devcenter instellen. Met deze configuratie kunt azd u gebruikmaken van nieuwe dev center-onderdelen voor de status en inrichting van de externe omgeving. Dit betekent dat de inframap in uw sjablonen effectief wordt genegeerd. In plaats daarvan azd gebruikt u een van de infrastructuursjablonen die zijn gedefinieerd in uw ontwikkelaarscentrumcatalogus voor het inrichten van resources.

Voer de volgende opdracht uit om ondersteuning in te schakelen azd :

 azd config set platform.type devcenter

Opdrachten azd verkennen

Wanneer de functie van het ontwikkelaarscentrum is ingeschakeld, wordt het standaardgedrag van enkele algemene azd-opdrachten gewijzigd om met deze externe omgevingen te werken. Zie Werken met Azure-implementatieomgevingen voor meer informatie.

Gerelateerde inhoud