Tworzenie konteneryzowanej aplikacji internetowej w języku Python w chmurze

Ten artykuł jest częścią samouczka dotyczącego konteneryzowania i wdrażania aplikacji internetowej w języku Python w usłudze Azure App Service. Usługa App Service umożliwia uruchamianie konteneryzowanych aplikacji internetowych i wdrażanie za pomocą funkcji ciągłej integracji/ciągłego wdrażania (CI/CD) za pomocą usług Docker Hub, Azure Container Registry i Visual Studio Team Services. W tej części samouczka dowiesz się, jak utworzyć konteneryzowaną aplikację internetową w języku Python w chmurze.

W poprzedniej opcjonalnej części tego samouczka obraz kontenera został skompilowany i uruchomiony lokalnie. Natomiast w tej części samouczka utworzysz (konteneryzujesz) aplikację internetową w języku Python w obrazie Docker bezpośrednio w rejestrze kontenerów Azure . Kompilowanie obrazu na platformie Azure jest zwykle szybsze i łatwiejsze niż kompilowanie lokalnie, a następnie wypychanie obrazu do rejestru. Ponadto kompilowanie w chmurze nie wymaga działania platformy Docker w środowisku deweloperskim.

Gdy obraz Docker znajduje się w Azure Container Registry, można go wdrożyć w Azure App Service.

Ten diagram usługi wyróżnia składniki omówione w tym artykule.

Tworzenie usługi Azure Container Registry

Jeśli masz już usługę Azure Container Registry, której możesz użyć, przejdź do następnego kroku. Jeśli tego nie zrobisz, utwórz go.

Azure CLI

Polecenia interfejsu wiersza polecenia platformy Azure można uruchamiać w usłudze Azure Cloud Shell lub na stacji roboczej z zainstalowanym interfejsem wiersza polecenia platformy Azure . Po uruchomieniu w usłudze Cloud Shell pomiń Krok 3.

1. W razie potrzeby utwórz grupę zasobów za pomocą polecenia az group create. Jeśli masz już skonfigurowane konto usługi Azure Cosmos DB dla bazy danych MongoDB w części 2. Skompiluj i przetestuj kontener lokalnie tego samouczka, ustaw zmienną środowiskową RESOURCE_GROUP_NAME na nazwę grupy zasobów użytej dla tego konta i przejdź do następnego kroku.

   RESOURCE_GROUP_NAME='msdocs-web-app-rg'
   LOCATION='eastus'
   
   az group create -n $RESOURCE_GROUP_NAME -l $LOCATION
   

   LOKALIZACJA powinna być wartością lokalizacji platformy Azure. Wybierz lokalizację w pobliżu. Wartości lokalizacji platformy Azure można wyświetlić za pomocą następującego polecenia: az account list-locations -o table.

2. Utwórz rejestr kontenerów za pomocą polecenia az acr create.

   REGISTRY_NAME='<your Azure Container Registry name>'
   
   az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Basic
   

   REGISTRY_NAME musi być unikatowa na platformie Azure i zawierać od 5 do 50 znaków alfanumerycznych.

   W danych wyjściowych JSON polecenia wyszukaj wartość loginServer, która jest w pełni kwalifikowaną nazwą rejestru (wszystkie małe litery) i która powinna zawierać określoną nazwę rejestru.

3. Jeśli używasz Azure CLI lokalnie, zaloguj się do rejestru przy użyciu polecenia az acr login.

   az acr login -n $REGISTRY_NAME
   

   Polecenie dodaje "azurecr.io" do nazwy, aby utworzyć w pełni kwalifikowaną nazwę rejestru. W przypadku powodzenia zostanie wyświetlony komunikat "Logowanie powiodło się".

   Notatka

   Polecenie az acr login nie jest wymagane ani obsługiwane w usłudze Cloud Shell.

VS Code

Te kroki wymagają rozszerzenia platformy Docker dla programu VS Code.

1. Wybierz pozycję F1 lub CTRL+SHIFT+P, aby otworzyć paletę poleceń. Następnie wpisz "rejestr" i wybierz zadanie Azure Container Registry: Stwórz Rejestr.

   Możesz także w sekcji REJESTRÓW w rozszerzeniu Docker kliknąć prawym przyciskiem myszy subskrypcję i wybrać pozycję Utwórz rejestr. Ta akcja interfejsu użytkownika uruchamia to samo zadanie tworzenia rejestru.

2. Postępuj zgodnie z monitami i wprowadź następujące wartości:

   • nazwa rejestru: nazwa rejestru musi być unikatowa na platformie Azure i zawierać od 5 do 50 znaków alfanumerycznych.

   • SKU: wybierz Standard.

   • grupa zasobów: użyj istniejącej grupy lub utwórz nową.

   • lokalizacja: jeśli używasz istniejącej grupy zasobów, wybierz odpowiadającą lokalizację. W przeciwnym razie lokalizacja to miejsce, w którym jest tworzona grupa zasobów zawierająca rejestr.

   

3. W rozszerzeniu platformy Docker w sekcji rejestrów znajdź utworzony rejestr, kliknij prawym przyciskiem myszy i wybierz pozycję Wyświetl właściwości.

   Wyszukaj parę wartości klucza loginServer w danych wyjściowych. Wartość to pełna kwalifikowana nazwa rejestru.

   

witryny Azure Portal

Zaloguj się do witryny Azure Portal i wykonaj następujące kroki, aby utworzyć usługę Azure Container Registry.

1. Wyszukaj frazę "rejestr kontenerów" i wybierz pozycję Container Registry w sekcji Marketplace w wynikach.

2. Na karcie Basics formularza Tworzenie rejestru kontenerów wprowadź następujące wartości:

   • grupa zasobów: użyj istniejącej grupy lub utwórz nową.
   • nazwa rejestru: nazwa rejestru musi być unikatowa na platformie Azure i zawierać od 5 do 50 znaków alfanumerycznych.
   • Lokalizacja: Jeśli korzystasz z istniejącej grupy zasobów, wybierz odpowiednią lokalizację. W przeciwnym razie lokalizacja to miejsce, w którym jest tworzona grupa zasobów zawierająca rejestr.
   • SKU: wybierz standardowy.

   

   Po zakończeniu wybierz Przejrzyj i utwórz. Po zakończeniu walidacji wybierz pozycję Utwórz.

3. Po zakończeniu wdrażania przejdź do nowego rejestru i znajdź w pełni kwalifikowaną nazwę.

   1. W menu usługi wybierz pozycję Przegląd.
   2. Skopiuj wartość Serwera logowania. Powinna to być w pełni kwalifikowana nazwa o nazwie "azurecr.io".

   

4. Konto administratora jest wymagane do wdrożenia obrazu kontenera z rejestru w usłudze Azure Web Apps for Containers.

   1. W menu usługi wybierz pozycję Klucze dostępu.
   2. Wybierz Włączone dla użytkownika administratora.

   

   Konto administratora rejestru jest wymagane podczas korzystania z portalu Azure do wdrażania obrazu kontenera, jak pokazano w tym samouczku. Konto administratora jest używane tylko podczas tworzenia usługi App Service. Po utworzeniu usługi App Service tożsamość zarządzana jest używana do ściągania obrazów z rejestru i można wyłączyć konto administratora.

Tworzenie obrazu w usłudze Azure Container Registry

Obraz kontenera można utworzyć bezpośrednio na platformie Azure na kilka sposobów. Najpierw możesz użyć usługi Azure Cloud Shell, która kompiluje obraz bez korzystania ze środowiska lokalnego. Możesz również skompilować obraz kontenera na platformie Azure ze środowiska lokalnego przy użyciu programu VS Code lub interfejsu wiersza polecenia platformy Azure. Kompilowanie obrazu w chmurze nie wymaga działania platformy Docker w środowisku lokalnym. Jeśli chcesz, możesz wykonać instrukcje opisane w Clone lub pobrać przykładową aplikację w części 2 tego samouczka, aby uzyskać przykładową aplikację internetową platformy Flask lub Django.

Azure CLI

Polecenia interfejsu wiersza polecenia platformy Azure można uruchamiać na stacji roboczej przy użyciu interfejsu wiersza polecenia platformy Azure zainstalowane gousługi Azure Cloud Shell. Po uruchomieniu w usłudze Cloud Shell pomiń Krok 1.

1. Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, zaloguj się do rejestru, jeśli jeszcze tego nie zrobiłeś, za pomocą polecenia az acr login.

   az acr login -n $REGISTRY_NAME
   

   Jeśli uzyskujesz dostęp do rejestru z subskrypcji innej niż ta, w której utworzono rejestr, użyj przełącznika --suffix.

   Notatka

   Polecenie az acr login nie jest potrzebne i nie jest obsługiwane w usłudze Cloud Shell.

2. Skompiluj obraz za pomocą polecenia az acr build.

   az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest .
   

   W tym poleceniu:

   • Kropka (".") na końcu polecenia wskazuje lokalizację kodu źródłowego do skompilowania. Jeśli nie uruchamiasz tego polecenia w przykładowym katalogu głównym aplikacji, określ ścieżkę do kodu.

     Zamiast ścieżki do kodu w środowisku możesz opcjonalnie określić ścieżkę do przykładowego repozytorium GitHub: https://github.com/Azure-Samples/msdocs-python-django-container-web-app lub https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.

   • Jeśli pominiesz opcję -t (taką samą jak --image), polecenie skolejkuje lokalną kompilację kontekstu bez przesyłania jej do rejestru. Budowanie bez wypychania może być przydatne do sprawdzenia, czy obraz buduje się.

3. Upewnij się, że obraz kontenera został utworzony za pomocą polecenia az acr repository list.

   az acr repository list -n $REGISTRY_NAME
   

VS Code

Te kroki wymagają rozszerzenia platformy Docker dla programu VS Code. Program VS Code musi zostać otwarty w folderze roboczym aplikacji internetowej.

1. W rozszerzeniu platformy Docker przejdź do rejestrów i nawiąż połączenie z platformą Azure.

   

2. Wybierz pozycję F1 lub CTRL+SHIFT+P, aby otworzyć paletę poleceń, wpisz "rejestr", a następnie wybierz zadanie Azure Container Registry: Build Image in Azure (Tworzenie obrazu na platformie Azure).

   Jeśli nie widzisz zadania, upewnij się, że Azure pojawia się pod REGISTRIES w rozszerzeniu Docker. Możesz również kliknąć prawym przyciskiem myszy Dockerfile i wybrać pozycję Kompiluj obraz w Azure, aby uruchomić zadanie.

3. Postępuj zgodnie z monitami i wprowadź następujące wartości, aby skompilować obraz.

   • Tag image: użyj nazwy obrazu "msdocspythoncontainerwebapp:latest".
   • Rejestru: Wybierz rejestr utworzony powyżej lub taki, do którego masz dostęp.
   • bazowy obraz systemu operacyjnego: wybierz Linux.

   

   Sprawdź okno OUTPUT, aby uzyskać postęp i informacje na temat kompilacji. Jeśli wystąpi błąd poświadczeń, kliknij prawym przyciskiem rejestr w sekcji rejestrów rozszerzenia Docker i wybierz pozycję Odśwież.

4. Potwierdź obraz w usłudze Azure Container Registry.

   1. W rozszerzeniu platformy Docker w sekcji REGISTRIES znajdź utworzony obraz kontenera.

   2. Potwierdź nazwę i tag "latest".

   

Azure Portal

Zaloguj się do witryny Azure Portal, aby wykonać te kroki.

1. Otwórz Azure Cloud Shell.

   

2. Skompiluj obraz za pomocą polecenia az acr build.

   az acr build \
     -r <registry-name> \
     -g <resource-group> \
     -t msdocspythoncontainerwebapp:latest \
     <repo-path>
   

   Ostatnim argumentem w poleceniu jest w pełni kwalifikowana ścieżka do repozytorium. Użyj https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git dla przykładowej aplikacji Django i https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git przykładowej aplikacji Platformy Flask.

3. Upewnij się, że obraz kontenera został utworzony za pomocą polecenia az acr repository list.

   az acr repository list -n <registry-name>
   

Następny krok

Wdrażanie aplikacji internetowej