Zelfstudie: Een toepassing met CI/CD implementeren in een Service Fabric-cluster
Deze zelfstudie is deel vier van een reeks. Hierin wordt beschreven hoe u een continue integratie en implementatie instelt voor een Azure Service Fabric-toepassing met behulp van Azure Pipelines. Er is een bestaande Service Fabric-toepassing vereist. De toepassing die in Een .NET-toepassing bouwen is gemaakt, wordt als voorbeeld gebruikt.
In deel drie van de serie leert u het volgende:
- Broncodebeheer aan uw project toevoegen
- Een build-pijplijn in Azure Pipelines maken
- Een release-pijplijn in Azure Pipelines maken
- Automatisch een upgrade en een toepassing implementeren
In deze zelfstudies leert u het volgende:
Vereisten
Voor u met deze zelfstudie begint:
- Als u nog geen Azure-abonnement hebt, maakt u een gratis account
- Installeer Visual Studio 2019 en installeer de workloads Azure-ontwikkeling en ASP.NET-ontwikkeling en webontwikkeling.
- Installeer de Service Fabric-SDK.
- Maak een Windows Service Fabric-cluster in Azure, bijvoorbeeld door deze zelfstudie te volgen
- Maak een Azure DevOps-organisatie. Met een organisatie kunt u een project maken in Azure DevOps en Azure Pipelines gebruiken.
De voorbeeldtoepassing om te stemmen downloaden
Als u de voorbeeldtoepassing Voting niet in deel één van deze reeks hebt gebouwd, kunt u deze downloaden. Voer in een opdrachtvenster de volgende opdracht uit om de opslagplaats van de voorbeeld-app te klonen op uw lokale computer.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Een publicatieprofiel voorbereiden
Nu u een toepassing hebt gemaakt en de toepassing hebt geïmplementeerd in Azure, kunt u continue integratie instellen. Bereid eerst binnen uw toepassing een publicatieprofiel voor, dat kan worden gebruikt door het implementatieproces dat in Azure Pipelines wordt uitgevoerd. Het publicatieprofiel moet worden geconfigureerd voor het cluster dat u eerder hebt gemaakt. Start Visual Studio en open een bestaand Service Fabric-toepassingsproject. Klik in Solution Explorer met de rechtermuisknop op de toepassing en selecteer Publish....
Kies een doelprofiel in het toepassingsproject, dat voor de werkstroom voor continue integratie kan worden gebruikt, bijvoorbeeld Cloud. Geef het eindpunt voor de clusterverbinding op. Schakel het selectievakje bij Upgrade the Application in, zodat voor elke implementatie in Azure DevOps een upgrade voor de toepassing wordt uitgevoerd. Selecteer de hyperlink Opslaan om de instellingen op te slaan in het publicatieprofiel en kies Vervolgens Annuleren om het dialoogvenster te sluiten.
Uw Visual Studio-oplossing delen met een nieuwe Git-opslagplaats van Azure DevOps
Deel de bronbestanden van uw toepassing met een project in Azure DevOps zodat u builds kunt genereren.
Maak een nieuwe GitHub-opslagplaats en Azure DevOps-opslagplaats vanuit Visual Studio 2022 IDE door Git -> Git-opslagplaats maken te selecteren in het Git-menu
Selecteer uw account in de vervolgkeuzelijst en voer de naam van uw opslagplaats in en selecteer de knop Maken en drukken .
Als u de opslagplaats publiceert, wordt er een nieuw project gemaakt in uw Azure DevOps Services-account met dezelfde naam als de lokale opslagplaats.
Bekijk de zojuist gemaakte opslagplaats door naar organisatienaam> te<https://dev.azure.com/\ navigeren, beweeg de muisaanwijzer over de naam van uw project en selecteer het pictogram Opslagplaatsen.
Continue levering configureren met Azure Pipelines
Een build-pijplijn in Azure Pipelines beschrijft een werkstroom die bestaat uit een reeks build-stappen die achtereenvolgens worden uitgevoerd. Maak een build-pijplijn die een Service Fabric-toepassingspakket maakt en andere artefacten, om deze in een Service Fabric-cluster te implementeren. Meer informatie over build-pijplijnen van Azure Pipelines.
Een release-pijplijn van Azure Pipelines beschrijft een werkstroom waarmee een toepassingspakket in een cluster wordt geïmplementeerd. Als de build-pijplijn en de release-pijplijn samen worden gebruikt, wordt hiermee de hele werkstroom uitgevoerd, te beginnen met bronbestanden en te eindigen met het uitvoeren van een toepassing in uw cluster. Meer informatie over release-pijplijnen in Azure Pipelines.
Een build-pijplijn maken
Open een webbrowser en navigeer naar uw nieuwe project op: https://dev.azure.com/\<organisatienaam>/VotingSample
Selecteer het tabblad Pijplijnen en selecteer Pijplijn maken.
Selecteer De klassieke editor gebruiken om een pijplijn te maken zonder YAML.
Selecteer Azure Repos Git als bron, VotingSample Team-project, VotingApplication Repository en master Default branch voor handmatige en geplande builds. Selecteer vervolgens Doorgaan.
Selecteer in Selecteer een sjabloon de Azure Service Fabric-toepassingssjabloon en selecteer Toepassen.
Voer in Taken 'Azure Pipelines' in als de agentgroep en windows-2022 als agentspecificatie.
Schakel onder Triggers continue integratie in door Enable continuous integration in te schakelen. Binnen Branchfilters zijn de standaardwaarden voor Branchspecificatie ingesteld op master. Selecteer Save and queue om handmatig een build te starten.
Hiermee worden ook triggers gebouwd na pushen of inchecken. Als u de voortgang van de build wilt controleren, gaat u naar het tabblad Builds . Zodra u hebt gecontroleerd of de build is uitgevoerd, definieert u een release-pijplijn waarmee uw toepassing in een cluster wordt geïmplementeerd.
Een release-pijplijn maken
Selecteer het tabblad Pijplijnen, vervolgens Releases en daarna + Nieuwe pijplijn. Selecteer in Select a template de sjabloon Azure Service Fabric Deployment in de lijst en vervolgens Apply.
Selecteer Taken en vervolgens +Nieuw om een nieuwe clusterverbinding toe te voegen.
Selecteer in de weergave New Service Fabric Verbinding maken ion de optie Verificatie op basis van certificaat of Microsoft Entra. Geef het clustereindpunt van tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000( of het eindpunt van het cluster waarnaar u implementeert).
Voor verificatie op basis van verificatie voegt u de vingerafdruk voor servercertificaat toe van het servercertificaat waarmee het cluster is gemaakt. Voeg in het clientcertificaat de basis-64-codering van het certificaatbestand van de client toe. Zie het pop-upitem met de Help voor dat veld voor informatie over hoe u de basis-64-representatie van het certificaat ophaalt. Voeg ook het wachtwoord voor het certificaat toe. U kunt het cluster- of het servercertificaat gebruiken als u geen apart clientcertificaat hebt.
Voor Microsoft Entra-referenties voegt u de vingerafdruk van het servercertificaat toe van het servercertificaat dat wordt gebruikt om het cluster te maken en de referenties die u wilt gebruiken om verbinding te maken met het cluster in de velden Gebruikersnaam en Wachtwoord.
Selecteer Opslaan.
Voeg vervolgens een build-artefact toe aan de pijplijn, zodat met de release-pijplijn de uitvoer van de build kan worden gevonden. Selecteer Pijplijn en artefacten->+Toevoegen. Selecteer in Source (Build definition) de build-pijplijn die u eerder hebt gemaakt. Selecteer Toevoegen om het build-artefact op te slaan.
Schakel een trigger voor continue implementatie in, zodat automatisch een release wordt gemaakt als de build wordt voltooid. Selecteer het bliksempictogram in het artefact, schakel de trigger in en kies Opslaan om de release-pijplijn op te slaan.
Selecteer Release maken -> Maken om handmatig een release te maken. U kunt de voortgang van de release volgen op het tabblad Releases.
Controleer of de implementatie is geslaagd en of de toepassing wordt uitgevoerd in het cluster. Open een webbrowser en ga naar https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Noteer de toepassingsversie. In dit voorbeeld is het 1.0.0.20170616.3.
Wijzigingen doorvoeren en pushen, een release activeren
Controleer of de pijplijn voor continue integratie correct functioneert door enkele codewijzigingen aan te brengen in Azure DevOps.
Terwijl u uw code schrijft, houdt Visual Studio de bestandswijzigingen in uw project bij in de sectie Wijzigingen van het venster Git-wijzigingen.
Voeg in de weergave Wijzigingen een bericht toe met een beschrijving van uw update en voer uw wijzigingen door.
Selecteer in het venster Git-wijzigingen de knop Push (de pijl-omhoog) om code in Azure Pipelines bij te werken.
Als u de wijzigingen naar Azure Pipelines pusht, wordt er automatisch een build geactiveerd. Als u de voortgang van de build wilt controleren, schakelt u over naar het tabblad Pijplijnen in https://dev.azure.com/organizationname/VotingSample.
Wanneer de build is voltooid, wordt er automatisch een release gemaakt en wordt gestart met het upgraden van de toepassing op het cluster.
Controleer of de implementatie is geslaagd en of de toepassing wordt uitgevoerd in het cluster. Open een webbrowser en ga naar https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Noteer de toepassingsversie. In dit voorbeeld is het 1.0.0.20170815.3.
De toepassing bijwerken
Breng in de toepassing wijzigingen aan de code aan. Sla de wijzigingen op en voer ze door aan de hand van de voorgaande stappen.
Zodra de upgrade van de toepassing wordt uitgevoerd, kunt u de voortgang ervan volgen in Service Fabric Explorer:
De upgrade van de toepassing kan enkele minuten duren. Als het bijwerken is voltooid, wordt de volgende versie door de toepassing uitgevoerd. In dit voorbeeld 1.0.0.20170815.4.
Volgende stappen
In deze zelfstudie heeft u het volgende geleerd:
- Broncodebeheer aan uw project toevoegen
- Een build-pijplijn maken
- Een release-pijplijn maken
- Automatisch een upgrade en een toepassing implementeren
Ga door naar de volgende zelfstudie: