Samouczek: wdrażanie aplikacji przy użyciu ciągłej integracji/ciągłego wdrażania w klastrze usługi Service Fabric
Niniejszy samouczek jest czwartą częścią serii i zawiera opis sposobu konfigurowania ciągłej integracji i ciągłego wdrażania aplikacji usługi Service Fabric za pomocą usługi Azure Pipelines. Wymagana jest istniejąca aplikacja usługi Service Fabric. Na potrzeby tego samouczka za przykład posłużyła aplikacja utworzona w temacie Tworzenie aplikacji .NET.
Część trzecia serii zawiera informacje na temat wykonywania następujących czynności:
- Dodawanie kontroli źródła do projektu
- Tworzenie potoku kompilacji w usłudze Azure Pipelines
- Tworzenie potoku wydania w usłudze Azure Pipelines
- Automatyczne wdrażanie i uaktualnianie aplikacji
Z tych samouczków dowiesz się, jak wykonywać następujące czynności:
- Kompilowanie aplikacji .NET Service Fabric
- Wdrażanie aplikacji w klastrze zdalnym
- Dodawanie punktu końcowego HTTPS do usługi frontonu platformy ASP.NET Core
- Konfigurowanie ciągłej integracji/ciągłego wdrażania za pomocą usługi Azure Pipelines
- Konfigurowanie monitorowania i diagnostyki dla aplikacji
Wymagania wstępne
Przed rozpoczęciem tego samouczka:
- Jeśli nie masz subskrypcji platformy Azure, utwórz bezpłatne konto
- Zainstaluj program Visual Studio 2019 i zainstaluj obciążenia programowanie na platformie Azure oraz ASP.NET i tworzenie aplikacji internetowych.
- Zainstaluj zestaw SDK usługi Service Fabric.
- Utwórz klaster usługi Service Fabric z systemem Windows na platformie Azure, na przykład postępując zgodnie z tym samouczkiem.
- Utwórz organizację usługi Azure DevOps. Organizacja umożliwia utworzenie projektu w usłudze Azure DevOps i korzystanie z usługi Azure Pipelines.
Pobieranie przykładowej aplikacji do głosowania
Jeśli nie skompilujesz przykładowej aplikacji Voting w części jednej z tej serii, możesz ją pobrać. W oknie polecenia uruchom następujące polecenie, aby sklonować przykładowe repozytorium aplikacji na komputer lokalny.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Przygotowywanie profilu publikowania
Po utworzeniu aplikacji i wdrożeniu aplikacji na platformie Azure możesz przystąpić do konfigurowania ciągłej integracji. Najpierw przygotuj profil publikowania w aplikacji na potrzeby procesu wdrażania wykonywanego w ramach usługi Azure Pipelines. Profil publikowania należy skonfigurować tak, aby był przeznaczony dla utworzonego wcześniej klastra. Uruchom program Visual Studio i otwórz istniejący projekt aplikacji usługi Service Fabric. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy aplikację i wybierz polecenie Opublikuj....
Wybierz profil docelowy w ramach projektu aplikacji na potrzeby przepływu pracy ciągłej integracji, na przykład chmurę. Określ punkt końcowy połączenia klastra. Zaznacz pole wyboru Uaktualnij aplikację, aby uaktualnić aplikację dla każdego wdrożenia w usłudze Azure DevOps. Wybierz hiperlink Zapisz, aby zapisać ustawienia w profilu publikowania, a następnie wybierz przycisk Anuluj, aby zamknąć okno dialogowe.
Udostępnianie rozwiązania programu Visual Studio w nowym repozytorium Git w usłudze Azure DevOps
Udostępnij pliki źródłowe aplikacji w projekcie zespołowym usługi Azure DevOps, aby umożliwić generowanie kompilacji.
Utwórz nowe repozytorium GitHub i repozytorium Usługi Azure DevOps z poziomu środowiska IDE programu Visual Studio 2022, wybierając pozycję Git —> Utwórz repozytorium Git z menu Git
Wybierz swoje konto z listy rozwijanej i wprowadź nazwę repozytorium, a następnie wybierz pozycję Utwórz i naciśnij przycisk.
Opublikowanie repozytorium powoduje utworzenie nowego projektu na koncie usługi Azure DevOps Services o takiej samej nazwie jak repozytorium lokalne.
Wyświetl nowo utworzone repozytorium, przechodząc do https://dev.azure.com/\<nazwy> organizacji, umieść wskaźnik myszy nad nazwą projektu i wybierz ikonę Repozytoria .
Konfigurowanie ciągłego dostarczania za pomocą usługi Azure Pipelines
Potok kompilacji usługi Azure Pipelines opisuje przepływ pracy składający się z zestawu kroków kompilacji wykonywanych sekwencyjnie. Utwórz potok kompilacji, który spowoduje wygenerowanie pakietu aplikacji usługi Service Fabric i innych artefaktów, na potrzeby wdrożenia w klastrze usługi Service Fabric. Dowiedz się więcej o potokach kompilacji usługi Azure Pipelines.
Potok wydania usługi Azure Pipelines opisuje przepływ pracy, który wdraża pakiet aplikacji w klastrze. Jednoczesne użycie potoku kompilacji i potoku wydania powoduje wykonanie całego przepływu pracy, zaczynając od plików źródłowych, a kończąc na aplikacji uruchomionej w klastrze. Dowiedz się więcej o potokach kompilacji usługi Azure Pipelines.
Tworzenie potoku kompilacji
Otwórz przeglądarkę internetową i przejdź do nowego projektu pod adresem: https://dev.azure.com/\<organizationname>/VotingSample
Wybierz kartę Potoki i wybierz pozycję Utwórz potok.
Wybierz pozycję Use the classic editor to create a pipeline without YAML (Użyj edytora klasycznego, aby utworzyć potok bez pliku YAML).
Wybierz pozycję Azure Repos Git jako źródło, projekt VotingSample Team, repozytorium VotingApplication i główną gałąź domyślną dla kompilacji ręcznych i zaplanowanych. Następnie wybierz pozycję Kontynuuj.
W obszarze Wybierz szablon wybierz szablon aplikacji usługi Azure Service Fabric i wybierz pozycję Zastosuj.
W obszarze Zadania wprowadź wartość "Azure Pipelines" jako pulęagentów i windows-2022 jako specyfikację agenta.
W obszarze Wyzwalacze włącz ciągłą integrację, zaznaczając pozycję Włącz ciągłą integrację. W obszarze Filtry gałęzi wartość domyślna pozycji Specyfikacja gałęzi jest ustawiona na master. Wybierz pozycję Zapisz i dodaj do kolejki, aby ręcznie uruchomić kompilację.
Kompilacje można również wyzwalać w ramach procesu wypychania lub ewidencjonowania. Aby sprawdzić postęp kompilacji, przejdź do karty Kompilacje . Po upewnieniu się, że kompilacja zostanie wykonana pomyślnie, zdefiniuj potok wydania, który wdraża aplikację w klastrze.
Tworzenie potoku wydania
Wybierz kartę Potoki, wybierz pozycję Wydania, a następnie wybierz pozycję + Nowy potok. W obszarze Wybieranie szablonu wybierz z listy szablon Wdrożenie usługi Azure Service Fabric, a następnie przycisk Zastosuj.
Wybierz pozycję Zadania , a następnie pozycję +Nowy , aby dodać nowe połączenie klastra.
W widoku Nowa usługa Service Fabric Połączenie ion wybierz pozycję Uwierzytelnianie poświadczeń oparte na certyfikatach lub Uwierzytelnienie poświadczeń firmy Microsoft. Określ punkt końcowy klastra tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000" (lub punkt końcowy klastra, do którego wdrażasz).
W przypadku uwierzytelniania opartego na certyfikatach dodaj odcisk palca certyfikatu serwera certyfikatu serwera używanego do utworzenia klastra. W obszarze Certyfikat klienta dodaj plik certyfikatu klienta zakodowany przy użyciu kodowania base-64. Zobacz pomoc podręczną dla tego pola, aby uzyskać informacje dotyczące sposobu uzyskania reprezentacji certyfikatu w kodowaniu base-64. Dodaj również Hasło certyfikatu. Jeśli nie masz osobnego certyfikatu klienta, możesz użyć certyfikatu klastra lub serwera.
W przypadku poświadczeń usługi Microsoft Entra dodaj odcisk palca certyfikatu serwera certyfikatu serwera używanego do utworzenia klastra oraz poświadczenia, których chcesz użyć do nawiązania połączenia z klastrem w polach Nazwa użytkownika i Hasło .
Wybierz pozycję Zapisz.
Następnie dodaj artefakt kompilacji do potoku, aby umożliwić potokowi wydania odnalezienie danych wyjściowych kompilacji. Wybierz pozycję Potok i artefakty ->+Dodaj. W obszarze Źródło (definicja kompilacji) wybierz wcześniej utworzony potok kompilacji. Wybierz pozycję Dodaj , aby zapisać artefakt kompilacji.
Włącz wyzwalacz ciągłego wdrażania, aby umożliwić automatyczne tworzenie wydania po zakończeniu kompilacji. Wybierz ikonę błyskawicy w artefaktzie, włącz wyzwalacz i wybierz pozycję Zapisz , aby zapisać potok wydania.
Wybierz pozycję Utwórz wydanie —> utwórz , aby ręcznie utworzyć wydanie. Postęp wydawania możesz monitorować na karcie Wydania.
Sprawdź, czy wdrożenie zakończyło się pomyślnie i czy aplikacja jest uruchomiona w klastrze. Otwórz przeglądarkę internetową i przejdź pod adres https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Zanotuj wersję aplikacji. W tym przykładzie jest to 1.0.0.20170616.3
.
Zatwierdzanie i wypychanie zmian, wyzwalanie wydania
Aby upewnić się, że potok ciągłej integracji działa prawidłowo, zaewidencjonuj zmiany kodu w usłudze Azure DevOps.
Podczas pisania kodu program Visual Studio śledzi zmiany plików w projekcie w sekcji Zmiany w oknie Zmiany usługi Git.
W widoku Zmiany dodaj komunikat opisujący aktualizację i zatwierdzając zmiany.
W oknie Git Changes (Zmiany usługi Git) wybierz przycisk Push (strzałka w górę), aby zaktualizować kod w usłudze Azure Pipelines.
Wypychanie zmian do usługi Azure Pipelines automatycznie wyzwala kompilację. Aby sprawdzić postęp kompilacji, przejdź do karty Potoki w pliku https://dev.azure.com/organizationname/VotingSample.
Po zakończeniu kompilacji zostanie automatycznie utworzone wydanie i rozpocznie uaktualnianie aplikacji w klastrze.
Sprawdź, czy wdrożenie zakończyło się pomyślnie i czy aplikacja jest uruchomiona w klastrze. Otwórz przeglądarkę internetową i przejdź pod adres https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/
. Zanotuj wersję aplikacji. W tym przykładzie jest to 1.0.0.20170815.3
.
Aktualizowanie aplikacji
Wprowadź zmiany w kodzie aplikacji. Zapisz i zatwierdź zmiany, postępując zgodnie z poprzednimi krokami.
Po rozpoczęciu uaktualnienia aplikacji możesz obserwować jego postęp w narzędziu Service Fabric Explorer:
Uaktualnienie aplikacji może potrwać kilka minut. Po zakończeniu uaktualniania aplikacja zostanie uruchomiona w następnej wersji. W tym przykładzie 1.0.0.20170815.4
.
Następne kroki
W tym samouczku zawarto informacje na temat wykonywania następujących czynności:
- Dodawanie kontroli źródła do projektu
- Tworzenie potoku kompilacji
- Tworzenie potoku wydania
- Automatyczne wdrażanie i uaktualnianie aplikacji
Przejdź do następnego samouczka: