Kurz: Nastavení CI/CD pro aplikaci Service Fabric pomocí Azure Pipelines
Tento kurz je druhou částí série. Ukazuje, jak nastavit kontinuální integraci a průběžné nasazování (CI/CD) pro aplikaci Azure Service Fabric pomocí Azure Pipelines. K dokončení kurzu musíte mít existující aplikaci Service Fabric. V tomto kurzu se používá aplikace popsaná v první části série kurzů.
V tomto kurzu se naučíte:
- Přidání správy zdrojového kódu do projektu
- Vytvoření kanálu buildu v Azure Pipelines
- Vytvoření kanálu verze v Azure Pipelines
- Automatické nasazení a upgrade aplikace
V této sérii kurzů se dozvíte, jak:
- Sestavit aplikaci .NET pro Service Fabric
- Nasadit aplikaci do vzdáleného clusteru
- Přidat koncový bod HTTPS do front-end služby ASP.NET Core
- Konfigurace CI/CD pomocí Azure Pipelines (tento kurz)
- Nastavit monitorování a diagnostiku aplikace
Požadavky
Než začnete s tímto kurzem:
- Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet.
- Nainstalujte Sadu Visual Studio 2019, včetně úlohy vývoje pro Azure a úlohy ASP.NET a vývoje webu.
- Nainstalujte sadu Service Fabric SDK.
- Vytvořte cluster Service Fabric pro Windows v Azure, například podle tohoto kurzu.
- Vytvořte organizaci Azure DevOps, abyste mohli vytvořit projekt v Azure DevOps a používat Azure Pipelines.
Stažení ukázkové aplikace Voting
Pokud jste v některé z těchto řad nevytvořili ukázkovou aplikaci Voting, můžete si ji stáhnout. V příkazovém okně naklonujte spuštěním následujícího příkazu úložiště ukázkové aplikace do místního počítače.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Příprava profilu publikování
Teď, když jste vytvořili aplikaci a nasadili ji do Azure, jste připraveni nastavit kontinuální integraci. Nejprve v rámci aplikace připravte profil publikování pro použití procesem nasazení, který se spouští v rámci Azure Pipelines. Profil publikování by měl být nakonfigurovaný tak, aby cílil na cluster, který jste vytvořili dříve. Spusťte sadu Visual Studio a otevřete existující projekt aplikace Service Fabric. V Průzkumník řešení klikněte pravým tlačítkem na aplikaci a vyberte Publikovat.
V projektu aplikace zvolte cílový profil, který se má použít pro pracovní postup kontinuální integrace, například Cloud. Zadejte koncový bod připojení clusteru. Zaškrtněte políčko Upgradovat aplikaci, aby se vaše aplikace upgraduje pro každé nasazení v Azure DevOps. Kliknutím na odkaz Uložit profil uložte nastavení do profilu publikování a pak dialogové okno zavřete výběrem možnosti Storno .
Sdílení řešení sady Visual Studio do nového úložiště Gitu Azure DevOps
Sdílejte zdrojové soubory aplikace do projektu v Azure DevOps, abyste mohli vygenerovat sestavení.
Pokud chcete vytvořit nové úložiště GitHubu a úložiště Azure DevOps v sadě Visual Studio 2022, v nabídce Git vyberte Git Create Git>Repository.
Vyberte svůj účet a zadejte název úložiště. Vyberte Vytvořit a nasdílení změn.
Publikování úložiště vytvoří nový projekt ve vašem účtu Azure DevOps Services, který má stejný název jako místní úložiště.
Pokud chcete zobrazit nově vytvořené úložiště, přejděte na https://dev.azure.com/><organizationname>. Najeďte myší na název projektu a vyberte ikonu Úložiště .
Konfigurace průběžného doručování pomocí Azure Pipelines
Kanál buildu Azure Pipelines popisuje pracovní postup, který má sadu kroků sestavení, které se spouští postupně. Pokud chcete nasadit do clusteru Service Fabric, vytvořte kanál buildu, který vytvoří balíček aplikace Service Fabric a další artefakty. Přečtěte si další informace o kanálech buildu Azure Pipelines.
Kanál verze Azure Pipelines popisuje pracovní postup, který nasadí balíček aplikace do clusteru. Při společném použití kanál buildu a kanál verze spustí celý pracovní postup, počínaje zdrojovými soubory a končí spuštěnou aplikací v clusteru. Přečtěte si další informace o kanálech verze Azure Pipelines.
Vytvoření kanálu buildu
Otevřete webový prohlížeč a přejděte na nový projekt na adrese https://dev.azure.com/<organization-name>/VotingSample.
Vyberte kartu Pipelines (Kanály) a pak vyberte Create Pipeline (Vytvořit kanál).
Vyberte Použít klasický editor k vytvoření kanálu bez použití YAML.
Jako zdroj vyberte Git Azure Repos. V případě týmového projektu vyberte VotingSample. Jako úložiště vyberte VotingApplication. Ponechte výchozí větev pro ruční a naplánované buildy. Potom vyberte Pokračovat.
V části Vybrat šablonu vyberte šablonu aplikace Azure Service Fabric a pak vyberte Použít.
V části Úlohy zadejte do fondu agentů Azure Pipelines. Jako specifikaci agenta zadejte windows-2022.
V části Triggery zaškrtněte políčko Povolit kontinuální integraci . Ve větvi filtry se ve specifikaci větve nastaví jako hlavní. Pokud chcete ručně spustit sestavení, vyberte Uložit a zařadit do fronty.
Sestavení se aktivují také pro nasdílení změn nebo vrácení se změnami. Pokud chcete zkontrolovat průběh sestavení, vyberte kartu Sestavení . Po ověření úspěšného spuštění sestavení definujte kanál verze, který nasadí vaši aplikaci do clusteru.
Vytvoření kanálu verze
Vyberte kartu Pipelines (Kanály) a pak vyberte Release New pipeline (Vydání>nového kanálu). Při výběru šablony vyberte šablonu nasazení Azure Service Fabric a pak vyberte Použít.
Vyberte Úkoly>Nové a přidejte nové připojení clusteru.
V části Nové připojení Service Fabric vyberte ověřování pomocí certifikátů nebo ověřování přihlašovacích údajů Microsoft Entra. Zadejte koncový bod tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 clusteru (nebo koncový bod clusteru, do které nasazujete).
Pro ověřování na základě certifikátu přidejte kryptografický otisk certifikátu serveru použitý k vytvoření clusteru. V části Klientský certifikát přidejte kódování Base64 souboru klientského certifikátu. Informace o nápovědě pro toto pole vám pomůžou zjistit, jak získat zakódovanou reprezentaci certifikátu zakódovanou v base-64. Přidejte také heslo pro certifikát. Certifikát clusteru nebo certifikát serveru můžete použít, pokud nemáte samostatný klientský certifikát.
Pro přihlašovací údaje Microsoft Entra přidejte hodnotu kryptografického otisku certifikátu serveru. Použijte certifikát serveru, který jste použili k vytvoření clusteru, a přihlašovací údaje, které chcete použít pro připojení ke clusteru pomocí uživatelského jména a hesla.
Zvolte Uložit.
Dále do kanálu přidejte artefakt sestavení, aby kanál verze mohl najít výstup z sestavení. Vyberte Přidat artefakty>kanálu>. V části Zdroj (definice sestavení) vyberte kanál buildu, který jste vytvořili dříve. Vyberte Přidat a uložte artefakt sestavení.
Povolte trigger průběžného nasazování, aby se po dokončení sestavení automaticky vytvořila verze. Vyberte ikonu blesku v artefaktu, povolte trigger a výběrem možnosti Uložit uložte kanál verze.
Výběrem možnosti Vytvořit verzi> vytvořte verzi ručně. Pokud chcete sledovat průběh vydávání verzí, vyberte kartu Vydané verze .
Ověřte, že nasazení proběhlo úspěšně a jestli je aplikace spuštěná v clusteru. Otevřete webový prohlížeč a přejděte na https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Poznamenejte si verzi aplikace. V tomto příkladu je 1.0.0.20170616.3to .
Potvrzení a nasdílení změn s cílem aktivace vydání
Pokud chcete ověřit, že kanál kontinuální integrace funguje, zkontrolujte některé změny kódu v Azure DevOps.
Při psaní kódu sada Visual Studio sleduje změny souboru v projektu v části Změny v podokně Změny Gitu.
V části Změny zadejte zprávu s popisem aktualizace a potvrďte změny.
V Git Changes (Změny Gitu) vyberte Push (šipka nahoru) a aktualizujte kód v Azure Pipelines.
Nasdílením změn do Služby Azure Pipelines se aktivuje sestavení. Pokud chcete zkontrolovat průběh sestavení, vyberte v aplikaci na kartě Kanály .https://dev.azure.com/organizationname/VotingSample
Po dokončení sestavení se automaticky vytvoří verze a spustí upgrade aplikace v clusteru.
Ověřte, že nasazení proběhlo úspěšně a jestli je aplikace spuštěná v clusteru. Otevřete webový prohlížeč a přejděte na https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Poznamenejte si verzi aplikace. V tomto příkladu je 1.0.0.20170815.3to .
Aktualizace aplikace
Proveďte v aplikaci změny kódu. Uložte a potvrďte změny.
Po zahájení upgradu aplikace můžete sledovat průběh upgradu v Service Fabric Exploreru:
Upgrade aplikace může trvat několik minut. Po dokončení upgradu aplikace spustí další verzi. V tomto příkladu je spuštěná verze 1.0.0.20170815.4.
Další krok
Přejděte k dalšímu kurzu: