Zelfstudie: Continue integratie van ARM-sjablonen met Azure Pipelines

Artikel
06/30/2023

In de vorige zelfstudie hebt u een gekoppelde sjabloon geïmplementeerd. In deze zelfstudie leert u hoe u Azure Pipelines kunt gebruiken om voortdurend ARM-sjabloonprojecten (Azure Resource Manager) te bouwen en implementeren.

Azure DevOps biedt ontwikkelaarsdiensten om teams te ondersteunen bij het plannen van werk, het samenwerken aan codeontwikkeling en het bouwen en implementeren van toepassingen. Ontwikkelaars kunnen werken in de cloud met behulp van Azure DevOps-services. Azure DevOps biedt een geïntegreerde set functies die u via uw webbrowser of IDE-client kunt openen. Azure Pipelines is een van deze functies. Azure-pijplijnen is een volledig uitgeruste service voor continue integratie (CI) en continue levering (CD). Het werkt met uw favoriete Git-provider en kan worden geïmplementeerd in de meeste belangrijke cloudservices. Vervolgens kunt u het bouwen, testen en implementeren van uw code automatiseren naar Microsoft Azure, Google Cloud Platform of Amazon Web Services.

Notitie

Kies een projectnaam. Wanneer u de zelfstudie doorloopt, vervangt u een van de ARMPipelineProj door uw projectnaam. Deze projectnaam wordt gebruikt om resourcenamen te genereren. Een van de resources is een opslagaccount. Opslagaccountnamen moeten tussen 3 en 24 tekens lang zijn en mogen alleen getallen en kleine letters bevatten. De naam moet uniek zijn. De opslagaccountnaam in de sjabloon is de projectnaam met achteraan toegevoegd: store. De projectnaam moet tussen 3 en 11 tekens lang zijn. De projectnaam moet dus voldoen aan de vereisten voor de opslagaccountnaam en minder dan 11 tekens lang zijn.

Deze zelfstudie bestaat uit de volgende taken:

Een GitHub-opslagplaats voorbereiden
Een Azure DevOps-project maken
Een Azure-pijplijn maken
De implementatie van de pijplijn controleren
De sjabloon bijwerken en opnieuw implementeren
Resources opschonen

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Vereisten

U hebt het volgende nodig om dit artikel te voltooien:

Een GitHub-account, dat u gebruikt om een opslagplaats voor uw sjablonen te maken. Als u geen account hebt, kunt u er gratis een maken. Zie GitHub-opslagplaatsen maken voor meer informatie over het gebruik van GitHub-opslagplaatsen.
Installeer Git. In deze zelfstudie-instructie gebruikt u Git Bash of Git Shell. Zie Install Git (Engelstalig) voor instructies.
Een Azure DevOps-organisatie. Als u geen account hebt, kunt u er gratis een maken. Zie Een organisatie-of projectverzameling maken.
(optioneel) Visual Studio Code met de extensie Resource Manager Tools. Zie quickstart: ARM-sjablonen maken met Visual Studio Code.

Een GitHub-opslagplaats voorbereiden

GitHub wordt gebruikt voor het opslaan van de broncode van uw project, inclusief Resource Manager-sjablonen. Zie opslagplaatsen die worden ondersteund door Azure DevOps voor andere ondersteunde opslagplaatsen.

Een GitHub-opslagplaats maken

Als u geen GitHub-account hebt, raadpleegt u Vereisten.

Meld u aan bij GitHub.
Selecteer uw accountafbeelding in de rechterbovenhoek en selecteer vervolgens Your repositories (Uw opslagplaatsen).
Selecteer New (Nieuw), een groene knop.
Geef een naam voor de opslagplaats op in Repository name. Bijvoorbeeld ARMPipeline-opslagplaats. Vergeet niet om armpipeline te vervangen door de naam van uw project. U kunt Public (Openbaar) of Private (Privé) selecteren voor deze zelfstudie. Selecteer vervolgens Create repository (Opslagplaats maken).
Noteer de URL. De URL van de opslagplaats heeft de volgende indeling: https://github.com/[YourAccountName]/[YourRepositoryName].

Deze opslagplaats wordt een externe opslagplaatsgenoemd. Alle ontwikkelaars van hetzelfde project kunnen hun eigen lokale opslagplaats klonen en de wijzigingen samenvoegen in de externe opslagplaats.

De externe opslagplaats klonen

Open Git Shell of Git Bash. Zie Vereisten.
Controleer of uw huidige map GitHub is.
Voer de volgende opdracht uit:
```
git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
cd [YourGitHubRepositoryName]
mkdir create_web_app
cd create_web_app
pwd
```
Vervang door [YourAccountName] de naam van uw GitHub-account en vervang deze door [YourGitHubRepositoryName] de naam van de opslagplaats die u in de vorige procedure hebt gemaakt.

De create_web_app map is de map waarin de sjabloon is opgeslagen. Met pwd de opdracht wordt het pad naar de map weergegeven. In de volgende procedure slaat u de sjabloon op in het pad.

Een quickstart-sjabloon downloaden

In plaats van de sjablonen te maken, kunt u de sjablonen downloaden en opslaan in de map create_web_app .

Zowel de mapnaam als de bestandsnamen worden gebruikt zoals ze zijn in de pijplijn. Als u deze namen wijzigt, moet u de namen die worden gebruikt in de pijplijn bijwerken.

De sjabloon naar de externe opslagplaats pushen

Het bestand azuredeploy.json is toegevoegd aan de lokale opslagplaats. Vervolgens uploadt u de sjabloon naar de externe opslagplaats.

Open Git Shell of Git Bash, als u dat nog niet gedaan hebt.
Wijzig de map in de map create_web_app in uw lokale opslagplaats.
Controleer of het bestand azuredeploy.json zich in de map bevindt.
Voer de volgende opdracht uit:
```
git add .
git commit -m "Add web app templates."
git push origin main
```
Er kan een waarschuwing over LF worden weergegeven. U kunt de waarschuwing negeren. Hoofd is de hoofdvertakking. Doorgaans maakt u een branch (vertakking) voor elke update. Om de zelfstudie te vereenvoudigen gebruikt u de hoofdvertakking rechtstreeks.
Blader in een browser naar uw GitHub-opslagplaats. De URL is https://github.com/[YourAccountName]/[YourGitHubRepository]. U ziet de create_web_app map en de twee bestanden in de map.
Selecteer azuredeploy.json om de sjabloon te openen.
Selecteer de knop Raw (Onbewerkt). De URL begint met https://raw.githubusercontent.com.
Maak een kopie van de URL. U moet deze waarde opgeven wanneer u de pijplijn verderop in de zelfstudie configureert.

U hebt een GitHub-opslagplaats gemaakt en de sjablonen naar de opslagplaats geüpload.

Een DevOps-project maken

Er is een DevOps-organisatie vereist voordat u kunt doorgaan met de volgende procedure. Als u er nog geen hebt, raadpleegt u Vereisten.

Aanmelden bij Azure DevOps.
Selecteer een DevOps-organisatie aan de linkerkant en selecteer vervolgens Nieuw project. Als u nog geen projecten hebt, wordt de pagina voor het maken van een project automatisch geopend.
Voer de volgende waarden in:
- Projectnaam: Voer een projectnaam in. U kunt de projectnaam gebruiken die u aan het begin van de zelfstudie hebt gekozen.
- Zichtbaarheid: Selecteer Privé.
Gebruik de standaardwaarden voor de overige eigenschappen.
Selecteer Maken.

Maak een serviceverbinding die wordt gebruikt voor het implementeren van projecten in Azure.

Selecteer Projectinstellingen onder in het menu links.
Selecteer Serviceverbindingen onder Pijplijnen.
Selecteer Serviceverbinding maken, Selecteer Azure Resource Manager en selecteer vervolgens Volgende.
Selecteer Service-principal (automatisch) en selecteer vervolgens Volgende.
Voer de volgende waarden in:
- Bereikniveau: selecteer Abonnement.
- Abonnement: selecteer uw abonnement.
- Resourcegroep: laat deze leeg.
- Verbindingsnaam: voer een naam voor de verbinding in. Bijvoorbeeld ARMPipeline-conn. Noteer deze naam. U hebt deze nodig bij het maken van de pijplijn.
- Verleen toegang tot alle pijplijnen. (geselecteerd)
Selecteer Opslaan.

Een pipeline maken

U hebt nu de volgende taken voltooid. Als u de vorige secties hebt overgeslagen omdat u bekend bent met GitHub en DevOps, moet u deze taken voltooien voordat u verdergaat.

Maak een GitHub-opslagplaats en sla de sjablonen op in de map create_web_app in de opslagplaats.
Maak een DevOps-project en maak een Azure Resource Manager-serviceverbinding.

Een pijplijn maken met een stap voor het implementeren van een sjabloon:

Selecteer Pijplijnen in het menu aan de linkerkant.
Selecteer Pijplijn maken.
Op het tabblad Verbinding maken selecteert u GitHub. Voer, als u daarom wordt gevraagd, uw GitHub-referenties in en volg de instructies. Als het volgende scherm wordt weergegeven, selecteert u Alleen opslagplaatsen selecteren en controleert u of uw opslagplaats in de lijst voorkomt voordat u Goedkeuren en installeren selecteert.
Selecteer uw opslagplaats op het tabblad Selecteren. De standaardnaam is [YourAccountName]/[YourGitHubRepositoryName].
Selecteer Starter pipeline (pijplijn Starter) op het tabblad Configure (Configureren). U ziet het pijplijnbestand azure-pipelines.yml met twee scriptstappen.
Verwijder de twee scriptstappen uit het .yml-bestand.
Verplaats de cursor naar de regel na steps:.
Selecteer Show Assistant (Assistent weergeven) rechts in het scherm om het deelvenster Tasks (Taken) te openen.
Selecteer ARM template deployment (ARM-implementatiesjabloon).
Voer de volgende waarden in:
- deploymentScope: Resourcegroep selecteren. Zie Implementatiebereiken voor meer informatie over de bereiken.
- Azure Resource Manager-verbinding: selecteer de naam van de serviceverbinding die u eerder hebt gemaakt.
- Abonnement: Geef de id van het doelabonnement op.
- Actie: Selecteer de actie Resourcegroep maken of bijwerken, voert twee acties - 1 uit. er wordt een resourcegroep gemaakt als u een nieuwe resourcegroepsnaam opgeeft. 2: de opgegeven sjabloon wordt geïmplementeerd.
- Resourcegroep: Voer een nieuwe resourcegroepnaam in. Bijvoorbeeld ARMPipeline-rg.
- Locatie: Selecteer een locatie voor de resourcegroep, bijvoorbeeld VS - centraal.
- Sjabloonlocatie: Selecteer de URL van het bestand, wat betekent dat de taak zoekt naar het sjabloonbestand met behulp van de URL. Omdat relativePath wordt gebruikt in de hoofdsjabloon en relativePath alleen wordt ondersteund voor implementaties op basis van URI's, moet u hier URL gebruiken.
- Sjabloonkoppeling: voer de URL in die u hebt gekregen aan het einde van de sectie Een GitHub-opslagplaats voorbereiden. Begint met https://raw.githubusercontent.com.
- Koppeling sjabloonparameters: laat dit veld leeg. U geeft de parameterwaarden op in de parameters voor het Overschrijven van de sjabloon.
- Sjabloonparameters overschrijven: Enter -projectName [EnterAProjectName].
- Implementatiemodus: Selecteer Incrementeel.
- Implementatienaam: Voer DeployPipelineTemplate in. U moet Geavanceerd selecteren om Naam van implementatie weer te geven.
Selecteer Toevoegen.

Zie de implementatietaak voor de Azure-resourcegroep en de implementatietaak voor de Azure Resource Manager-sjabloon voor meer informatie over de taak

Het .yml-bestand ziet er ongeveer als volgt uit:
Selecteer Opslaan en uitvoeren.
Selecteer in het deelvenster Opslaan en uitvoeren nogmaals Opslaan en uitvoeren. Er wordt een kopie van het YAML-bestand opgeslagen in de verbonden opslagplaats. U kunt het YAML-bestand weergeven door naar uw opslagplaats te bladeren.
Controleer of de pijplijn is uitgevoerd.

De implementatie controleren

Meld u aan bij de Azure-portal.
Open de resourcegroep. De naam is wat u hebt opgegeven in het YAML-bestand van de pijplijn. U ziet dat er één opslagaccount is gemaakt. De naam van het opslagaccount begint met store.
Selecteer het opslagaccount om het te openen.
Selecteer Eigenschappen. Merk op dat Replicatie is ingesteld op Lokaal redundante opslag (LRS).

Bijwerken en opnieuw implementeren

Wanneer u de sjabloon bijwerkt en de wijzigingen naar de externe opslagplaats pusht, worden de resources (in dit geval het opslagaccount) automatisch bijgewerkt door de pijplijn.

Open linkedStorageAccount.json vanuit uw lokale opslagplaats in Visual Studio Code of een andere teksteditor.
Wijzig de defaultValue (standaardwaarde) van storageAccountType in Standard_GRS. Zie de volgende schermafbeelding:
De wijzigingen opslaan.
Push de wijzigingen naar de externe opslagplaats door de volgende opdrachten in Git Bash/Shell uit te voeren.
```
git pull origin main
git add .
git commit -m "Update the storage account type."
git push origin main
```
Met de eerste opdracht (pull) wordt de lokale opslagplaats gesynchroniseerd met de externe opslagplaats. Het YAML-bestand van de pijplijn is alleen toegevoegd aan de externe opslagplaats. Als u de opdracht pull uitvoert, wordt een kopie van het YAML-bestand naar de lokale vertakking gedownload.

Met de vierde opdracht (push) wordt het herziene bestand linkedStorageAccount.json geüpload naar de externe opslagplaats. Als de hoofdvertakking van de externe opslagplaats is bijgewerkt, wordt de pijplijn opnieuw geactiveerd.

U kunt de wijzigingen controleren door de replicatie-eigenschap van het opslagaccount te controleren. Zie De implementatie controleren.

Resources opschonen

Schoon de geïmplementeerd Azure-resources, wanneer u deze niet meer nodig hebt, op door de resourcegroep te verwijderen.

Selecteer Resourcegroep in het linkermenu van Azure Portal.
Voer de naam van de resourcegroep in het veld Filter by name in.
Selecteer de naam van de resourcegroep.
Selecteer Resourcegroep verwijderen in het bovenste menu.

Mogelijk wilt u ook de GitHub-opslagplaats en het Azure DevOps-project verwijderen.

Volgende stappen

Gefeliciteerd. U hebt deze zelfstudie voor de implementatie van een Resource Manager-sjabloon voltooid. Laat het ons weten als u opmerkingen en suggesties hebt in de feedbacksectie. Bedankt! U kunt nu doorgaan met meer geavanceerde concepten over sjablonen. De volgende zelfstudie gaat dieper in op het gebruik van documentatie voor sjabloonverwijzingen om u te helpen bij het definiëren van te implementeren resources.

Sjabloonverwijzing gebruiken