Zelfstudie: Omgevingen implementeren in CI/CD met behulp van Azure Pipelines

In deze zelfstudie leert u hoe u Azure Deployment Environments (ADE) integreert in uw CI/CD-pijplijn van Azure Pipelines.

Continue integratie en continue levering (CI/CD) is een softwareontwikkelingsbenadering waarmee teams het proces van het bouwen, testen en implementeren van softwarewijzigingen kunnen automatiseren. Met CI/CD kunt u softwarewijzigingen vaker en met meer vertrouwen vrijgeven.

Voordat u aan deze zelfstudie begint, moet u vertrouwd raken met resources en concepten voor implementatieomgevingen door belangrijke concepten voor Azure Deployment Environments te bekijken.

In deze zelfstudie leert u het volgende:

• Een Opslagplaats voor Azure-opslagplaatsen maken en configureren
• Verbinding maken de catalogus naar uw ontwikkelaarscentrum
• Serviceverbinding configureren
• Een pipeline maken
• Een omgeving maken
• De CI/CD-pijplijn testen

Vereisten

• Een Azure-account met een actief abonnement.
  • Gratis een account maken
• Eigenaarsmachtigingen voor het Azure-abonnement.
• Een Azure DevOps-abonnement.
  • Gratis een account maken
  • Een Azure DevOps-organisatie en -project.
• Azure-implementatieomgevingen.
  • Ontwikkelaarscentrum en project.
  • Voorbeeldcatalogus die is gekoppeld aan het ontwikkelaarscentrum.

Een Opslagplaats voor Azure-opslagplaatsen maken en configureren

1. Meld u aan bij uw Azure DevOps-organisatie (https://dev.azure.com/<your-organization>) en selecteer uw project. Vervang de tijdelijke aanduiding voor tekst <your-organization> door de project-id.
2. Selecteer Opslagplaatsbestanden>.
3. Selecteer Importeren in Een opslagplaats importeren.
4. Selecteer of voer het volgende in in Een Git-opslagplaats importeren:
   • Type opslagplaats: Git
   • Kloon-URL: https://github.com/Azure/deployment-environments

Omgevingstypen configureren

Omgevingstypen definiëren de verschillende typen omgevingen die uw ontwikkelteams kunnen implementeren. U kunt verschillende instellingen toepassen voor elk omgevingstype. U maakt omgevingstypen op het niveau van het ontwikkelaarscentrum en verwijst naar het projectniveau.

Ontwikkelcentrumomgevingstypen maken:

1. Meld u aan bij het Azure-portaal.

2. Selecteer uw ontwikkelaarscentrum in Dev Centers.

3. Selecteer omgevingstypen in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Maken.

4. Gebruik de volgende stappen om drie omgevingstypen te maken: Sandbox, FunctionApp, WebApp. Voer bij Omgevingstype maken de volgende gegevens in en selecteer vervolgens Toevoegen.

   Naam	Weergegeven als
   Naam	Voer een naam in voor het omgevingstype.
   Tags	Voer een tagnaam en een tagwaarde in.

5. Controleer of het omgevingstype is toegevoegd door uw Azure Portal-meldingen te controleren.

Projectomgevingstypen maken:

1. Selecteer projecten in het linkermenu onder Beheren en selecteer vervolgens het project dat u wilt gebruiken.

2. Selecteer omgevingstypen in het linkermenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

3. Gebruik de volgende stappen om de drie omgevingstypen toe te voegen: Sandbox, FunctionApp, WebApp. Voer bij Omgevingstype toevoegen aan <projectnaam> de volgende gegevens in of selecteer deze:

   Naam	Weergegeven als
   Type	Selecteer een omgevingstype op ontwikkelaarscentrumniveau om het specifieke project in te schakelen.
   Implementatieabonnement	Selecteer het abonnement waarin de omgeving wordt gemaakt.
   Implementatie-identiteit	Selecteer een door het systeem toegewezen identiteit of een door de gebruiker toegewezen beheerde identiteit om implementaties uit te voeren namens de gebruiker.
   Machtigingen voor rol(s) voor omgevingsbronnen voor omgevingsbronnen: rol(s) voor het maken van omgevingsbronnen>	Selecteer de rollen om toegang te verlenen tot de omgevingsbronnen.
   Machtigingen voor omgevingsbronnen>Aanvullende toegang	Selecteer de gebruikers of Microsoft Entra-groepen die u wilt toewijzen aan specifieke rollen in de omgevingsbronnen.
   Tags	Voer een tagnaam en een tagwaarde in. Deze tags worden toegepast op alle resources die worden gemaakt als onderdeel van de omgeving.

4. Controleer of het omgevingstype is toegevoegd door uw Azure Portal-meldingen te controleren.

Een serviceverbinding configureren

In Azure Pipelines maakt u een serviceverbinding in uw Azure DevOps-project voor toegang tot resources in uw Azure-abonnement. Wanneer u de serviceverbinding maakt, maakt Azure DevOps een Microsoft Entra-service-principalobject.

1. Meld u aan bij uw Azure DevOps-organisatie (https://dev.azure.com/<your-organization>) en selecteer uw project. Vervang de tijdelijke aanduiding voor tekst <your-organization> door de project-id.

2. Selecteer Serviceverbindingen> met Project-instellingen>+ Nieuwe serviceverbinding.

3. Selecteer in het deelvenster Nieuwe serviceverbinding de Azure Resource Manager en selecteer vervolgens Volgende.

4. Selecteer de verificatiemethode service-principal (automatisch) en selecteer vervolgens Volgende.

5. Voer de details van de serviceverbinding in en selecteer Opslaan om de serviceverbinding te maken.

   Veld	Waarde
   Bereikniveau	Abonnement.
   Abonnement	Selecteer het Azure-abonnement dat als host fungeert voor uw ontwikkelaarscentrumresource.
   Resourcegroep	Selecteer de resourcegroep die uw ontwikkelaarscentrumresource bevat.
   Serviceverbindingsnaam	Voer een unieke naam in voor de serviceverbinding.
   Toegangsmachtigingen verlenen aan alle pijplijnen	Geselecteerd.

6. Selecteer in de lijst met serviceverbindingen de service die u eerder hebt gemaakt en selecteer vervolgens Service-principal beheren. Azure Portal wordt geopend in een afzonderlijk browsertabblad en toont de details van de service-principal.

7. Kopieer in Azure Portal de waarde van de weergavenaam . U gebruikt deze waarde in de volgende stap om machtigingen te verlenen voor het uitvoeren van belastingstests aan de service-principal.

De serviceverbinding toegang verlenen tot het ADE-project

Azure Deployment Environments maakt gebruik van op rollen gebaseerd toegangsbeheer om machtigingen te verlenen voor het uitvoeren van specifieke activiteiten op uw ADE-resource. Als u wijzigingen wilt aanbrengen vanuit een CI/CD-pijplijn, verleent u de gebruikersrol Implementatieomgevingen aan de service-principal.

1. Ga in Azure Portal naar uw ADE-project.
2. Selecteer Toegangsbeheer (IAM)>Roltoewijzing toevoegen.>
3. Selecteer op het tabblad Rol de optie Implementatieomgevingengebruiker in de lijst met functierollen.
4. Selecteer leden selecteren op het tabblad Leden en gebruik vervolgens de weergavenaam die u eerder hebt gekopieerd om de service-principal te doorzoeken.
5. Selecteer de service-principal en selecteer vervolgens Selecteren.
6. Selecteer Op het tabblad Beoordelen en toewijzen de optie Beoordelen en toewijzen om de roltoewijzing toe te voegen.

U kunt nu de serviceverbinding in uw Azure Pipelines-werkstroomdefinitie gebruiken voor toegang tot uw ADE-omgevingen.

Uw account toegang verlenen tot het ADE-project

Als u omgevingen wilt weergeven die zijn gemaakt door andere gebruikers, inclusief de serviceverbinding, moet u uw account leestoegang verlenen tot het ADE-project.

1. Ga in Azure Portal naar uw ADE-project.
2. Selecteer Toegangsbeheer (IAM)>Roltoewijzing toevoegen.>
3. Selecteer op het tabblad Rol de optie Lezer implementatieomgevingen in de lijst met functierollen.
4. Selecteer leden selecteren op het tabblad Leden en zoek naar uw eigen account.
5. Selecteer uw account in de lijst en selecteer vervolgens Selecteren.
6. Selecteer Op het tabblad Beoordelen en toewijzen de optie Beoordelen en toewijzen om de roltoewijzing toe te voegen.

U kunt nu de omgevingen bekijken die zijn gemaakt door uw Azure Pipelines-werkstroom.

Een pijplijn configureren

Bewerk het azure-pipelines.yml bestand in uw Opslagplaats voor Azure-opslagplaatsen om uw pijplijn aan te passen.

In de pijplijn definieert u de stappen voor het maken van de omgeving. In deze pijplijn definieert u de stappen voor het maken van de omgeving als een taak. Dit is een reeks stappen die opeenvolgend als een eenheid worden uitgevoerd.

Als u de pijplijn wilt aanpassen, gaat u als volgende te werk:

• Geef de service-Verbinding maken ie op die moet worden gebruikt en de pijplijn maakt gebruik van de Azure CLI om de omgeving te maken.
• Gebruik een Inline-script om een Azure CLI-opdracht uit te voeren waarmee de omgeving wordt gemaakt.

De Azure CLI is een opdrachtregelprogramma dat een set opdrachten biedt voor het werken met Azure-resources. Zie az devcenter voor meer Azure CLI-opdrachten.

1. Selecteer Repos>Files in uw Azure DevOps-project.

2. Selecteer azure-pipelines.yml het bestand in het deelvenster Bestanden in de .ado map.

3. Bewerk in het azure-pipelines.yml bestand de bestaande inhoud met de volgende code:

   • Vervang <AzureServiceConnectionName> door de naam van de serviceverbinding die u eerder hebt gemaakt.

   • Vervang in de Inline scriptvolgende tijdelijke aanduidingen elk van de volgende tijdelijke aanduidingen door waarden die geschikt zijn voor uw Azure-omgeving:

     Tijdelijke aanduiding	Weergegeven als
     <dev-center-name>	De naam van uw ontwikkelaarscentrum.
     <project-name>	De naam van uw project.
     <catalog-name>	De naam van uw catalogus.
     <environment-definition-name>	Niet wijzigen. Definieert de omgevingsdefinitie die wordt gebruikt.
     <environment-type>	Het omgevingstype.
     <environment-name>	Geef een naam op voor uw nieuwe omgeving.
     <parameters>	Niet wijzigen. Verwijst naar het json-bestand dat parameters voor de omgeving definieert.

4. Selecteer Doorvoeren om uw wijzigingen op te slaan.

5. Voer in het deelvenster Doorvoerwijzigingen een doorvoerbericht in en selecteer Doorvoeren.

Een omgeving maken met behulp van een pijplijn

Vervolgens voert u de pijplijn uit om de ADE-omgeving te maken.

1. Selecteer Pijplijnen in uw Azure DevOps-project.
2. Selecteer de pijplijn die u eerder hebt gemaakt en selecteer vervolgens Pijplijn uitvoeren.
3. U kunt de voortgang van de pijplijnuitvoering controleren door de naam van de pijplijn te selecteren en vervolgens Uitvoeringen te selecteren. Selecteer de uitvoering om de details van de pijplijnuitvoering weer te geven.
4. U kunt ook de voortgang van het maken van de omgeving in Azure Portal controleren door uw ontwikkelaarscentrum te selecteren, uw project te selecteren en vervolgens Omgevingen te selecteren.

U kunt deze taak overal invoegen in een CI-pijplijn (Continuous Integration) en/of een CD-pijplijn (Continuous Delivery). Ga aan de slag met de documentatie voor Azure Pipelines voor meer informatie over het maken en beheren van pijplijnen.

Resources opschonen

Wanneer u klaar bent met de resources die u in deze zelfstudie hebt gemaakt, kunt u ze verwijderen om kosten te voorkomen.

Gebruik de volgende opdracht om de omgeving te verwijderen die u in deze zelfstudie hebt gemaakt:

az devcenter dev environment delete --dev-center <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes

Gerelateerde inhoud

• De Azure CLI-extensie voor devcenter installeren
• Een omgeving maken en openen met behulp van de Azure CLI
• Documentatie voor Microsoft Dev Box en Azure Deployment Environments in Azure CLI