Szybki start: korzystanie z konfiguracji aplikacja systemu Azure w usłudze Azure Container Apps

W tym przewodniku Szybki start użyjesz aplikacja systemu Azure Configuration w aplikacji uruchomionej w usłudze Azure Container Apps. Dzięki temu można scentralizować magazyn i zarządzać konfiguracją aplikacji w usłudze Container Apps. Ten przewodnik Szybki start korzysta z aplikacji ASP.NET Core utworzonej w przewodniku Szybki start: tworzenie aplikacji ASP.NET Core przy użyciu usługi App Configuration. Konteneryzujesz aplikację i wdrażasz ją w usłudze Azure Container Apps. Przed kontynuowaniem ukończ przewodnik Szybki start.

Napiwek

Wykonując czynności opisane w tym przewodniku Szybki start, najlepiej zarejestrować wszystkie nowe zasoby w ramach jednej grupy zasobów, aby można było ponownie je przegrupować w jednym miejscu i usunąć je szybciej później, jeśli nie będą już potrzebne.

Wymagania wstępne

• Aplikacja korzystająca ze sklepu App Configuration. Jeśli go nie masz, utwórz wystąpienie przy użyciu przewodnika Szybki start: tworzenie aplikacji ASP.NET Core za pomocą usługi App Configuration.
• Wystąpienie usługi Azure Container Apps. Jeśli go nie masz, utwórz wystąpienie przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia.
• Docker Desktop
• Interfejs wiersza polecenia platformy Azure

---

Łączenie aplikacja systemu Azure Konfiguracji z aplikacją kontenera

1. W witrynie Azure Portal przejdź do wystąpienia aplikacji kontenera.

2. Postępuj zgodnie z przewodnikiem Szybki start łącznika usług dla usługi Azure Container Apps , aby utworzyć połączenie usługi dla magazynu App Configuration przy użyciu następujących ustawień.

   1. Na karcie Podstawy :

      • W obszarze Typ usługi wybierz pozycję Konfiguracja aplikacji

      • W obszarze Konfiguracja aplikacji wybierz sklep App Configuration.

        

   2. Na karcie Uwierzytelnianie:

      • Wybierz typ uwierzytelniania tożsamości zarządzanej przypisanej przez system
      • Rozwiń menu Zaawansowane
      • Przypisywanie tożsamości roli Czytelnik danych konfiguracji aplikacji
      • W obszarze Informacje o konfiguracji znajduje się zmienna środowiskowa o nazwie AZURE_APPCONFIGURATION_ENDPOINT. Wybierz ikonę ołówka po prawej stronie i zmodyfikuj nazwę zmiennej środowiskowej, aby dopasować nazwę zmiennej w aplikacji, z której jest ładowany punkt końcowy usługi App Configuration. Jeśli aplikacja została skompilowana zgodnie z przewodnikiem Szybki start ASP.NET Core, nazwa zmiennej to Endpoints:AppConfiguration. Podczas edytowania nazwy zmiennej zastąp dwukropek podwójnymi podkreśleniami, aby stał się .Endpoints__AppConfiguration Jeśli pracujesz z inną aplikacją, wprowadź odpowiednią nazwę zmiennej środowiskowej, a następnie wybierz pozycję Gotowe.

   3. Użyj wartości domyślnych dla wszystkich innych elementów.

   Po utworzeniu połączenia zmienna środowiskowa o nazwie Endpoints__AppConfiguration zostanie dodana do kontenera zasobu aplikacji kontenera. Jego wartość to odwołanie do wpisu tajnego aplikacji kontenera , punktu końcowego magazynu usługi App Configuration.

Tworzenie kontenera

1. Uruchom polecenie dotnet publish, aby skompilować aplikację w trybie wydania i utworzyć zasoby w opublikowanym folderze.

   dotnet publish -c Release -o published
   

2. Utwórz plik o nazwie Dockerfile w katalogu zawierającym plik csproj, otwórz go w edytorze tekstów i wprowadź następującą zawartość. Plik Dockerfile to plik tekstowy, który nie ma rozszerzenia i służy do tworzenia obrazu kontenera.

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. Skompiluj kontener, uruchamiając następujące polecenie.

   docker build --tag aspnetapp .
   

Utworzenie wystąpienia usługi Azure Container Registry

Tworzenie rejestru Azure Container Registry (ACR). Usługa ACR umożliwia tworzenie i przechowywanie obrazów kontenerów oraz zarządzanie nimi.

Portal

1. Aby utworzyć rejestr kontenerów, postępuj zgodnie z przewodnikiem Szybki start usługi Azure Container Registry.
2. Po zakończeniu wdrażania otwórz wystąpienie usługi ACR, a następnie z menu po lewej stronie wybierz pozycję Ustawienia > Klucze dostępu.
3. Zanotuj wartość serwera logowania wymienioną na tej stronie. Te informacje będą używane w późniejszym kroku.
4. Przełącz użytkownika administratora na włączone. Ta opcja umożliwia połączenie usługi ACR z usługą Azure Container Apps przy użyciu poświadczeń użytkownika administratora. Alternatywnie możesz pozostawić ją wyłączoną i skonfigurować aplikację kontenera do ściągania obrazów z rejestru przy użyciu tożsamości zarządzanej.

Interfejs wiersza polecenia platformy Azure

1. Utwórz wystąpienie usługi ACR przy użyciu następującego polecenia. Tworzy rejestr w warstwie podstawową o nazwie myregistry z włączonym użytkownikiem administratora, który umożliwia aplikacji kontenera nawiązywanie połączenia z rejestrem przy użyciu poświadczeń użytkownika administratora. Aby uzyskać więcej informacji, zobacz Przewodnik Szybki start dotyczący usługi Azure Container Registry.

   az acr create 
   --resource-group AppConfigTestResources \
   --name myregistry \
   --admin-enabled true \
   --sku Basic
   

2. W danych wyjściowych polecenia zanotuj wartość serwera logowania usługi ACR wymienioną po loginServer.

3. Pobierz nazwę użytkownika i hasło usługi ACR, uruchamiając polecenie az acr credential show --name myregistry. Te wartości będą potrzebne później.

Wypychanie obrazu do usługi Azure Container Registry

Wypchnij obraz platformy Docker do utworzonego wcześniej usługi ACR.

1. Uruchom polecenie az acr login, aby zalogować się do rejestru.

   az acr login --name myregistry
   

   Polecenie zwraca wartość Login Succeeded po pomyślnym zalogowaniu.

2. Użyj tagu docker, aby oznaczyć obraz odpowiednimi szczegółami.

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   Napiwek

   Aby przejrzeć listę istniejących obrazów i tagów platformy Docker, uruchom polecenie docker image ls. W tym scenariuszu powinny zostać wyświetlone co najmniej dwa obrazy: aspnetapp i myregistry.azurecr.io/aspnetapp.

3. Użyj polecenia docker push, aby wypchnąć obraz do rejestru kontenerów. W tym przykładzie utworzono repozytorium aspnetapp w usłudze ACR zawierające obraz aspnetapp . W poniższym przykładzie zastąp symbole <login-serverzastępcze i <tag> <image-name> wartością serwera logowania usługi ACR, nazwą obrazu i tagiem obrazu.

   Metoda:

   docker push <login-server>/<image-name>:<tag>
   

   Przykład:

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. Otwórz usługę Azure Container Registry w witrynie Azure Portal i upewnij się, że w obszarze Repozytoria możesz zobaczyć nowe repozytorium.

   

Dodawanie obrazu kontenera do usługi Azure Container Apps

Zaktualizuj aplikację kontenera, aby załadować obraz kontenera z usługi ACR.

1. W witrynie Azure Portal otwórz wystąpienie usługi Azure Container Apps.

2. W menu po lewej stronie w obszarze Aplikacja wybierz pozycję Kontenery.

3. Wybierz pozycję Edytuj i wdróż.

4. W obszarze Obraz kontenera kliknij nazwę istniejącego obrazu kontenera.

5. Zaktualizuj następujące ustawienia:

   Ustawienie	Sugerowana wartość	opis
   Źródło obrazu	Azure Container Registry	Wybierz usługę Azure Container Registry jako źródło obrazu.
   Uwierzytelnianie	Poświadczenia administratora	Użyj opcji poświadczeń użytkownika administratora, która została włączona wcześniej w rejestrze kontenerów. Jeśli użytkownik administracyjny nie został włączony, ale skonfigurowany do używania tożsamości zarządzanej, musisz ręcznie wprowadzić obraz i tag w formularzu.
   Rejestr	myregistry.azurecr.io	Wybierz utworzoną wcześniej usługę Azure Container Registry.
   Obraz	aspnetapp	Wybierz utworzony wcześniej obraz platformy Docker i wypchnięty do usługi ACR.
   Tag obrazu	Wersja 1	Wybierz tag obrazu z listy.

6. Wybierz pozycję Zapisz , a następnie pozycję Utwórz , aby wdrożyć aktualizację w aplikacji kontenera platformy Azure.

Przejdź do adresu URL aplikacji kontenera platformy Azure

W witrynie Azure Portal w wystąpieniu usługi Azure Container Apps przejdź do karty Przegląd i otwórz adres URL aplikacji.

Strona internetowa wygląda następująco:

Czyszczenie zasobów

Jeśli nie chcesz nadal korzystać z zasobów utworzonych w tym artykule, usuń utworzoną tutaj grupę zasobów, aby uniknąć naliczania opłat.

Ważne

Usunięcie grupy zasobów jest nieodwracalne. Grupa zasobów i wszystkie zasoby w niej są trwale usuwane. Upewnij się, że nie usuniesz przypadkowo nieprawidłowej grupy zasobów ani zasobów. Jeśli zasoby dla tego artykułu zostały utworzone w grupie zasobów zawierającej inne zasoby, które chcesz zachować, usuń każdy zasób oddzielnie z odpowiedniego okienka zamiast usuwać grupę zasobów.

1. Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
2. W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
3. Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
4. Wybierz pozycję Usuń grupę zasobów.
5. Zobaczysz prośbę o potwierdzenie usunięcia grupy zasobów. Wprowadź nazwę grupy zasobów, aby potwierdzić, a następnie wybierz pozycję Usuń.

Po kilku chwilach grupa zasobów i wszystkie jej zasoby zostaną usunięte.

Powiązana zawartość

W ramach tego przewodnika Szybki start wykonasz następujące czynności:

• Konfiguracja połączonej aplikacja systemu Azure z usługą Azure Container Apps
• Użyto platformy Docker do utworzenia obrazu kontenera z aplikacji ASP.NET Core przy użyciu ustawień usługi App Configuration
• Utworzono wystąpienie usługi Azure Container Registry
• Wypchnięty obraz do wystąpienia usługi Azure Container Registry
• Dodano obraz kontenera do usługi Azure Container Apps
• Przejdź do adresu URL wystąpienia usługi Azure Container Apps zaktualizowanego przy użyciu ustawień skonfigurowanych w magazynie App Configuration.

Tożsamość zarządzana umożliwia jednemu zasobowi platformy Azure uzyskiwanie dostępu do innego bez obsługi wpisów tajnych. Możesz usprawnić dostęp z usługi Container Apps do innych zasobów platformy Azure. Aby uzyskać więcej informacji, zobacz jak uzyskać dostęp do usługi App Configuration przy użyciu tożsamości zarządzanej i jak uzyskać dostęp do usługi Container Registry przy użyciu tożsamości zarządzanej.

Aby dowiedzieć się, jak skonfigurować aplikację internetową ASP.NET Core w celu dynamicznego odświeżania ustawień konfiguracji, przejdź do następnego samouczka.

Włączanie konfiguracji dynamicznej