Samouczek: przygotowywanie rejestru kontenerów platformy Azure z replikacją geograficzną
Rejestr kontenerów platformy Azure to prywatny rejestr platformy Docker wdrożony na platformie Azure, który można zlokalizować w sieci w pobliżu własnych wdrożeń. Ten zestaw trzech samouczków przedstawia metodę użycia replikacji geograficznej do wdrożenia aplikacji internetowej platformy ASP.NET Core uruchomionej w kontenerze systemu Linux do dwóch wystąpień funkcji Web Apps for Containers. Dowiesz się, jak platforma Azure automatycznie wdraża obraz do każdego wystąpienia aplikacji internetowej z najbliższego repozytorium z replikacją geograficzną.
Ten samouczek jest pierwszą częścią trzyczęściowej serii:
- Tworzenie rejestru kontenerów platformy Azure z replikacją geograficzną
- Klonowanie kodu źródłowego aplikacji z usługi GitHub
- Tworzenie obrazu kontenera platformy Docker ze źródła aplikacji
- Wypchnięcie obrazu kontenera do rejestru
W kolejnych samouczkach kontener zostanie wdrożony z prywatnego rejestru do aplikacji internetowej uruchomionej w dwóch regionach platformy Azure. Następnie zostanie zaktualizowany kod w aplikacji, a oba wystąpienia aplikacji internetowej zostaną zaktualizowane za pomocą pojedynczego polecenia docker push uruchomionego względem rejestru.
Zanim rozpoczniesz
Dla tego samouczka wymagana jest lokalna instalacja interfejsu wiersza polecenia platformy Azure (w wersji 2.0.31 lub nowszej). Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.
Należy posiadać wiedzę na temat bazowych koncepcji usługi Docker, takich jak kontenery, obrazy kontenerów i podstawowe polecenia interfejsu wiersza polecenia usługi Docker. Aby uzyskać podstawowe informacje na temat kontenerów, zapoznaj się z tematem Get started with Docker (Rozpoczynanie pracy z platformą Docker).
Do ukończenia tego samouczka potrzebna jest lokalna instalacja usługi Docker. Platforma Docker dostarcza instrukcje na temat instalacji w systemach macOS, Windows i Linux.
Usługa Azure Cloud Shell nie zawiera składników platformy Docker wymaganych do ukończenia każdego kroku w tym samouczku. Dlatego zalecamy użycie lokalnej instalacji interfejsu wiersza polecenia platformy Azure i środowiska deweloperskiego platformy Docker.
Tworzenie rejestru kontenerów
Na potrzeby tego samouczka potrzebny jest rejestr kontenerów platformy Azure w warstwie usługi Premium. Aby utworzyć nowy rejestr kontenerów platformy Azure, wykonaj kroki opisane w tej sekcji.
Napiwek
Jeśli rejestr został wcześniej utworzony i trzeba go uaktualnić, zobacz Zmienianie warstw.
Zaloguj się w witrynie Azure Portal.
Wybierz pozycję Utwórz zasób>Kontenery>Azure Container Registry.
Skonfiguruj nowy rejestr przy użyciu następujących ustawień. Na karcie Podstawy :
- Nazwa rejestru: utwórz nazwę rejestru, która jest globalnie unikatowa w obrębie platformy Azure i składa się z od 5 do 50 znaków alfanumerycznych
- Grupa zasobów: utwórz nową>
myResourceGroup - Lokalizacja:
West US - Jednostka SKU:
Premium(wymagana dla replikacji geograficznej)
Wybierz pozycję Przejrzyj i utwórz , a następnie utwórz , aby utworzyć wystąpienie rejestru.
W dalszej części tego samouczka wartość <acrName> będzie używana jako symbol zastępczy wybranej nazwy rejestru kontenerów.
Napiwek
Ponieważ rejestry kontenerów platformy Azure to zwykle zasoby o długim czasie życia używane na wielu hostach kontenerów, zalecamy utworzenie rejestru w jego własnej grupie zasobów. Podczas konfigurowania rejestrów z replikacją geograficzną i elementów webhook te dodatkowe zasoby są umieszczane w tej samej grupie zasobów.
Konfigurowanie replikacji geograficznej
Teraz, gdy masz rejestr w warstwie Premium, możesz skonfigurować replikację geograficzną. Aplikacja internetowa, którą skonfigurujesz w następnym samouczku pod kątem uruchamiania w dwóch regionach, będzie wtedy mogła ściągać obrazy kontenera z najbliższego rejestru.
Przejdź do nowego rejestru kontenerów w witrynie Azure Portal i wybierz pozycję Replikacje w obszarze Usługi:
Zostanie wyświetlona mapa z zielonymi sześciokątami reprezentującymi regiony platformy Azure dostępne dla replikacji geograficznej:
Zreplikuj rejestr do regionu Wschodnie stany USA, wybierając jego zielony sześciokąt, a następnie wybierz polecenie Utwórz w obszarze Utwórz replikację:
Po zakończeniu replikacji w portalu będzie wyświetlany stan Gotowe dla obu regionów. Użyj przycisku Odśwież, aby odświeżyć stan replikacji. Utworzenie i zsynchronizowanie replik może trwać około minuty.
Włączanie konta administratora
W kolejnych samouczkach wdrożysz obraz kontenera z rejestru bezpośrednio w usłudze Web App for Containers. Aby włączyć tę funkcję, należy również włączyć konto administratora rejestru.
Przejdź do nowego rejestru kontenerów w witrynie Azure Portal i wybierz pozycję Klucze dostępu w obszarze Ustawienia. W obszarze Administrator wybierz pozycję Włącz.
Logowanie do rejestru Container Registry
Po skonfigurowaniu replikacji geograficznej utwórz obraz kontenera i wypchnij go do rejestru. Przed wypchnięciem obrazów do rejestru należy najpierw zalogować się do rejestru.
Użyj polecenia az acr login, aby przeprowadzić uwierzytelnianie i zapisać poświadczenia dla rejestru w pamięci podręcznej. Zastąp ciąg <acrName> nazwą wcześniej utworzonego rejestru.
az acr login --name <acrName>
Polecenie zwraca ciąg Login Succeeded po zakończeniu.
Pobieranie kodu aplikacji
Przykład podany w tym samouczku obejmuje małą aplikację internetową utworzoną za pomocą platformy ASP.NET Core. Aplikacja udostępnia stronę HTML wyświetlającą region, z którego obraz został wdrożony przez usługę Azure Container Registry.
Użyj narzędzia git, aby pobrać przykład do katalogu lokalnego, a następnie użyj polecenia cd, aby przejść do tego katalogu:
git clone https://github.com/Azure-Samples/acr-helloworld.git
cd acr-helloworld
Jeśli nie masz zainstalowanego narzędzia git, możesz pobrać archiwum ZIP bezpośrednio z usługi GitHub.
Aktualizacja pliku Dockerfile
Plik Dockerfile dołączony do przykładu przedstawia sposób tworzenia kontenera. Rozpoczyna się od oficjalnego obrazu środowiska uruchomieniowego ASP.NET Core, kopiuje pliki aplikacji do kontenera, instaluje zależności, kompiluje dane wyjściowe przy użyciu oficjalnego obrazu zestawu SDK platformy .NET Core, a na koniec tworzy zoptymalizowany obraz aspnetcore.
Plik Dockerfile znajduje się w lokalizacji ./AcrHelloworld/Dockerfile w sklonowanym źródle.
FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS base
# Update <acrName> with the name of your registry
# Example: uniqueregistryname.azurecr.io
ENV DOCKER_REGISTRY <acrName>.azurecr.io
WORKDIR /app
EXPOSE 80
FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
WORKDIR /src
COPY *.sln ./
COPY AcrHelloworld/AcrHelloworld.csproj AcrHelloworld/
RUN dotnet restore
COPY . .
WORKDIR /src/AcrHelloworld
RUN dotnet build -c Release -o /app
FROM build AS publish
RUN dotnet publish -c Release -o /app
FROM base AS production
WORKDIR /app
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "AcrHelloworld.dll"]
Aplikacja w obrazie acr-helloworld próbuje określić region, z którego wdrożono jej kontener, odpytując usługę DNS o informacje dotyczące serwera logowania rejestru. Musisz określić w pełni kwalifikowaną nazwę domeny (FQDN, fully qualified domain name) serwera logowania rejestru za pomocą zmiennej środowiskowej DOCKER_REGISTRY w pliku Dockerfile.
Najpierw pobierz serwer logowania rejestru za pomocą polecenia az acr show. Zastąp ciąg <acrName> nazwą rejestru utworzonego w poprzednich krokach.
az acr show --name <acrName> --query "{acrLoginServer:loginServer}" --output table
Wyjście:
AcrLoginServer
-----------------------------
uniqueregistryname.azurecr.io
Następnie zaktualizuj wiersz ENV DOCKER_REGISTRY przy użyciu nazwy FQDN serwera logowania rejestru. W tym przykładzie użyto przykładowej nazwy rejestru uniqueregistryname:
ENV DOCKER_REGISTRY uniqueregistryname.azurecr.io
Tworzenie obrazu kontenera
Po zaktualizowaniu pliku Dockerfile za pomocą nazwy FQDN serwera logowania rejestru możesz użyć polecenia docker build do utworzenia obrazu kontenera. Uruchom następujące polecenie, aby utworzyć obraz i oznaczyć go za pomocą adresu URL prywatnego rejestru, ponownie zastępując ciąg <acrName> nazwą rejestru:
docker build . -f ./AcrHelloworld/Dockerfile -t <acrName>.azurecr.io/acr-helloworld:v1
Podczas tworzenia obrazu platformy Docker jest wyświetlanych kilka wierszy danych wyjściowych (w tym miejscu są one obcięte):
Sending build context to Docker daemon 523.8kB
Step 1/18 : FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS base
2.2: Pulling from mcr.microsoft.com/dotnet/core/aspnet
3e17c6eae66c: Pulling fs layer
[...]
Step 18/18 : ENTRYPOINT dotnet AcrHelloworld.dll
---> Running in 6906d98c47a1
---> c9ca1763cfb1
Removing intermediate container 6906d98c47a1
Successfully built c9ca1763cfb1
Successfully tagged uniqueregistryname.azurecr.io/acr-helloworld:v1
Użyj polecenia docker images, aby wyświetlić kompilację i oznakowany obraz:
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
uniqueregistryname.azurecr.io/acr-helloworld v1 01ac48d5c8cf About a minute ago 284MB
[...]
Wypychanie obrazu do usługi Azure Container Registry
Następnie użyj polecenia docker push, aby wypchnąć obraz acr-helloworld do rejestru. Zastąp ciąg <acrName> nazwą rejestru.
docker push <acrName>.azurecr.io/acr-helloworld:v1
Ponieważ rejestr skonfigurowano pod kątem replikacji geograficznej, obraz jest automatycznie replikowany do regionów Zachodnie stany USA i Wschodnie stany USA po użyciu pojedynczego polecenia docker push.
$ docker push uniqueregistryname.azurecr.io/acr-helloworld:v1
The push refers to a repository [uniqueregistryname.azurecr.io/acr-helloworld]
cd54739c444b: Pushed
d6803756744a: Pushed
b7b1f3a15779: Pushed
a89567dff12d: Pushed
59c7b561ff56: Pushed
9a2f9413d9e4: Pushed
a75caa09eb1f: Pushed
v1: digest: sha256:0799014f91384bda5b87591170b1242bcd719f07a03d1f9a1ddbae72b3543970 size: 1792
Następne kroki
W ramach tego samouczka utworzono prywatny, replikowany geograficznie rejestr kontenerów, utworzono obraz kontenera, a następnie wypchnięto obraz do rejestru.
Przejdź do następnego samouczka, aby wdrożyć kontener do wielu wystąpień funkcji Web Apps for Containers za pomocą replikacji geograficznej w celu udostępniania obrazów lokalnie.