Samouczek: wdrażanie w usłudze Azure Container Apps przy użyciu programu Visual Studio

Usługa Azure Container Apps umożliwia uruchamianie mikrousług i konteneryzowanych aplikacji na platformie bezserwerowej. Dzięki usłudze Container Apps możesz korzystać z zalet uruchamiania kontenerów, pozostawiając problemy związane z ręcznym konfigurowaniem infrastruktury chmury i złożonych orkiestratorów kontenerów.

W tym samouczku wdrożysz konteneryzowaną aplikację ASP.NET Core 6.0 w usłudze Azure Container Apps przy użyciu programu Visual Studio. Poniższe kroki dotyczą również wcześniejszych wersji ASP.NET Core.

Wymagania wstępne

• Wymagane jest konto platformy Azure z aktywną subskrypcją. Jeśli jeszcze go nie masz, możesz bezpłatnie utworzyć konto.
• Program Visual Studio 2022 w wersji 17.2 lub nowszej jest dostępny do pobrania bezpłatnie.

Tworzenie projektu

Zacznij od utworzenia konteneryzowanej aplikacji ASP.NET Core do wdrożenia na platformie Azure.

1. W programie Visual Studio wybierz pozycję Plik , a następnie wybierz pozycję Nowy => Projekt.

2. W oknie dialogowym wyszukaj ASP.NET, a następnie wybierz pozycję ASP.NET Core Web App i wybierz przycisk Dalej.

3. W polu Nazwa projektu nadaj aplikacji nazwę MyContainerApp , a następnie wybierz pozycję Dalej.

4. Na ekranie Dodatkowe informacje upewnij się, że wybrano pozycję Włącz platformę Docker, a następnie upewnij się, że dla ustawienia systemu operacyjnego platformy Docker wybrano system Linux. Usługa Azure Container Apps obecnie nie obsługuje kontenerów systemu Windows. Ten wybór zapewnia, że szablon projektu domyślnie obsługuje konteneryzację. Po włączeniu projekt używa kontenera, gdy jest uruchomiony lub jest kompilowany.

5. Kliknij pozycję Utwórz , a program Visual Studio utworzy i załaduje projekt.

Wdrażanie w usłudze Azure Container Apps

Aplikacja zawiera plik Dockerfile, ponieważ ustawienie Włącz platformę Docker zostało wybrane w szablonie projektu. Program Visual Studio używa pliku Dockerfile do kompilowania obrazu kontenera, który jest uruchamiany przez usługę Azure Container Apps.

Zapoznaj się z tematem How Visual Studio builds containerized apps (Jak program Visual Studio kompiluje aplikacje konteneryzowane ), jeśli chcesz dowiedzieć się więcej na temat specyfiki tego procesu.

Teraz możesz przystąpić do wdrażania w aplikacji w usłudze Azure Containers Apps.

Tworzenie zasobów

Okna dialogowe publikowania programu Visual Studio pomogą Ci wybrać istniejące zasoby platformy Azure lub utworzyć nowe, które będą używane do wdrażania aplikacji. Skompiluje również obraz kontenera przy użyciu pliku Dockerfile w projekcie, wypchnie ten obraz do usługi ACR, a na koniec wdroży nowy obraz w wybranej aplikacji kontenera.

1. Kliknij prawym przyciskiem myszy węzeł projektu MyContainerApp i wybierz pozycję Publikuj.

2. W oknie dialogowym wybierz pozycję Azure z listy opcji publikowania, a następnie wybierz pozycję Dalej.

   

3. Na ekranie Określony element docelowy wybierz pozycję Azure Container Apps (Linux), a następnie ponownie wybierz pozycję Dalej .

   

4. Następnie utwórz aplikację kontenera platformy Azure w celu hostowania projektu. Wybierz zieloną ikonę znaku plus po prawej stronie, aby otworzyć okno dialogowe tworzenia. W oknie dialogowym Tworzenie nowego wprowadź następujące wartości:

   • Nazwa aplikacji konteneramsdocscontainerapp: wprowadź nazwę .
   • Nazwa subskrypcji: wybierz subskrypcję, w której chcesz hostować aplikację.
   • Grupa zasobów: grupa zasobów działa jako kontener logiczny do organizowania powiązanych zasobów na platformie Azure. Możesz wybrać istniejącą grupę zasobów lub wybrać pozycję Nowy , aby utworzyć grupę z wybraną nazwą, taką jak msdocscontainerapps.
   • Środowisko usługi Container Apps: Środowisko usługi Container Apps: każda aplikacja kontenera musi być częścią środowiska aplikacji kontenera. Środowisko zapewnia izolowane sieci dla co najmniej jednej aplikacji kontenera, dzięki czemu można je łatwo wywołać nawzajem. Kliknij pozycję Nowy , aby otworzyć okno dialogowe Tworzenie nowego środowiska aplikacji kontenera. Pozostaw wartości domyślne i wybierz przycisk OK , aby zamknąć okno dialogowe środowiska.
   • Nazwa kontenera: jest to przyjazna nazwa kontenera, który będzie uruchamiany dla tej aplikacji kontenera. Użyj nazwy msdocscontainer1 tego przewodnika Szybki start. Aplikacja kontenera zwykle uruchamia pojedynczy kontener, ale czasami jest potrzebny więcej niż jeden kontener. Jednym z takich przykładów jest to, że kontener przyczepki jest wymagany do wykonania działania, takiego jak wyspecjalizowane rejestrowanie lub komunikacja.

   

5. Wybierz pozycję Utwórz , aby zakończyć tworzenie lub aplikację kontenera. Program Visual Studio i platforma Azure tworzą wymagane zasoby w Twoim imieniu. Ten proces może potrwać kilka minut, więc poczekaj na jego ukończenie przed przejściem dalej.

6. Po utworzeniu zasobów wybierz pozycję Dalej.

   

7. Na ekranie Rejestr możesz wybrać istniejący rejestr, jeśli istnieje, lub utworzyć nowy. Aby utworzyć nowy, kliknij zieloną + ikonę po prawej stronie. Na ekranie Tworzenie nowego rejestru wypełnij następujące wartości:

   • Prefiks DNS: wprowadź wartość msdocscontainerregistry lub wybraną nazwę.
   • Nazwa subskrypcji: wybierz subskrypcję, której chcesz użyć — możesz wybrać tylko jedną subskrypcję.
   • Grupa zasobów: wybierz utworzoną wcześniej grupę zasobów msdocs.
   • Jednostka SKU: wybierz pozycję Standardowa.
   • Lokalizacja rejestru: wybierz region, który jest geograficznie blisko Ciebie.

   

8. Po wypełnieniu tych wartości wybierz pozycję Utwórz. Utworzenie rejestru w programie Visual Studio i na platformie Azure zajmie trochę czasu.

9. Po utworzeniu rejestru kontenerów upewnij się, że jest zaznaczona, a następnie wybierz pozycję Zakończ. Utworzenie profilu publikowania w programie Visual Studio potrwa chwilę. Ten profil publikowania to miejsce, w którym program VS przechowuje wybrane opcje publikowania i zasoby, dzięki czemu można szybko publikować je ponownie za każdym razem, gdy chcesz. Możesz zamknąć okno dialogowe po jego zakończeniu.

   

Publikowanie aplikacji przy użyciu programu Visual Studio

Podczas tworzenia zasobów i profilu publikowania nadal trzeba opublikować i wdrożyć aplikację na platformie Azure.

Wybierz pozycję Publikuj w prawym górnym rogu ekranu profilu publikowania, aby wdrożyć aplikację kontenera utworzoną na platformie Azure. Ten proces może chwilę potrwać, więc poczekaj na jego ukończenie.

Po zakończeniu wdrażania aplikacji program Visual Studio otworzy przeglądarkę pod adresem URL wdrożonej witryny. Ta strona może początkowo wyświetlać błąd, jeśli wszystkie odpowiednie zasoby nie zakończyły aprowizacji. Możesz okresowo odświeżać przeglądarkę, aby sprawdzić, czy wdrożenie zostało w pełni ukończone.

Publikowanie aplikacji przy użyciu GitHub Actions

Aplikacje kontenerów można również wdrażać przy użyciu ciągłej integracji/ciągłego wdrażania za pośrednictwem akcji usługi GitHub, które są zaawansowanym narzędziem do automatyzowania, dostosowywania i wykonywania przepływów pracy programowania bezpośrednio za pośrednictwem repozytorium GitHub projektu.

Jeśli program Visual Studio wykryje, że projekt, który publikujesz, jest hostowany w usłudze GitHub, przepływ publikowania przedstawia dodatkowy krok Typ wdrożenia . Ten etap umożliwia deweloperom wybranie, czy publikować bezpośrednio za pomocą programu Visual Studio, wykonując kroki przedstawione wcześniej w przewodniku Szybki start, czy za pośrednictwem przepływu pracy GitHub Actions.

Jeśli wybierzesz przepływ pracy GitHub Actions, program Visual Studio doda folder github do katalogu głównego projektu wraz z wygenerowanym plikiem YAML wewnątrz niego. Plik YAML zawiera GitHub Actions konfiguracji do kompilowania i wdrażania aplikacji na platformie Azure za każdym razem, gdy wypychasz kod.

Po wprowadzeniu zmiany i wypchnięciu kodu możesz zobaczyć postęp procesu kompilacji i wdrażania w usłudze GitHub na karcie Akcje . Ta strona zawiera szczegółowe dzienniki i wskaźniki dotyczące postępu i kondycji przepływu pracy.

Po wyświetleniu zielonego znacznika wyboru obok zadań kompilacji i wdrażania przepływ pracy zostanie ukończony. Po przejściu do witryny usługi Container Apps powinny zostać wyświetlone najnowsze zastosowane zmiany. Zawsze możesz znaleźć adres URL aplikacji kontenera przy użyciu strony Azure Portal.

Czyszczenie zasobów

Jeśli nie zamierzasz nadal korzystać z tej aplikacji, możesz usunąć wystąpienie usługi Azure Container Apps i wszystkie skojarzone usługi, usuwając grupę zasobów.

Wykonaj następujące kroki w Azure Portal, aby usunąć utworzone zasoby:

1. Wybierz grupę zasobów msdocscontainerapps w sekcji Przegląd .
2. Wybierz przycisk Usuń grupę zasobów w górnej części grupy zasobów Przegląd.
3. Wprowadź nazwę grupy zasobów msdocscontainerapps w oknie dialogowym potwierdzenia Czy na pewno chcesz usunąć okno dialogowe potwierdzenia "my-container-apps".
4. Wybierz pozycję Usuń.
   Proces usuwania grupy zasobów może potrwać kilka minut.

Porada

Masz problemy? Daj nam znać w usłudze GitHub, otwierając problem w repozytorium usługi Azure Container Apps.

Następne kroki

Środowiska w usłudze Azure Container Apps