Översikt över Python Container Apps i Azure

Den här artikeln beskriver hur du går från Python-projektkod (till exempel en webbapp) till en distribuerad Docker-container i Azure. Vi diskuterar den allmänna processen för containerisering, distributionsalternativ för containrar i Azure och Python-specifik konfiguration av containrar i Azure.

Docker-containrarnas natur är att skapandet av en Docker-avbildning från kod och distributionen av avbildningen till en container i Azure liknar alla programmeringsspråk. De språkspecifika övervägandena – Python i det här fallet – finns i konfigurationen under containeriseringsprocessen i Azure, särskilt Dockerfile-strukturen och konfigurationen som stöder Python-webbramverk som Django, Flask och FastAPI.

Scenarier för containerarbetsflöde

För utveckling av Python-containrar är några vanliga arbetsflöden för att flytta från kod till container:

Slutmålet med dessa arbetsflöden är att ha en container som körs i en av De Azure-resurser som stöder Docker-containrar enligt listan i nästa avsnitt.

En utvecklingsmiljö kan vara din lokala arbetsstation med Visual Studio Code eller PyCharm, Codespaces (en utvecklingsmiljö som finns i molnet) eller Visual Studio Dev Containers (en container som en utvecklingsmiljö).

Alternativ för distributionscontainer i Azure

Python-containerappar stöds i följande tjänster.

En mer detaljerad jämförelse av dessa tjänster finns i Jämföra containerappar med andra Azure-containeralternativ.

Virtuella miljöer och containrar

När du kör ett Python-projekt i en utvecklingsmiljö är användning av en virtuell miljö ett vanligt sätt att hantera beroenden och säkerställa reproducerbarhet för projektkonfigurationen. En virtuell miljö har en Python-tolk, bibliotek och skript installerade som krävs av den projektkod som körs i den miljön. Beroenden för Python-projekt hanteras via filen requirements.txt .

Du kan betrakta Docker-containrar som liknande funktioner som virtuella miljöer, men med ytterligare fördelar när det gäller reproducerbarhet och portabilitet. Docker-containern kan köras var som helst där containrar kan köras, oavsett operativsystem.

En Docker-container innehåller din Python-projektkod och allt som koden behöver köra. För att komma till den punkten måste du skapa python-projektkoden i en Docker-avbildning och sedan skapa en container, en körbar instans av avbildningen.

För containerisering av Python-projekt är nyckelfilerna:

Containerinställningar för webbramverk

Webbramverk har standardportar där de lyssnar efter webbbegäranden. När du arbetar med vissa Azure-containerlösningar måste du ange den port som containern lyssnar på som tar emot trafik.

I följande tabell visas hur du ställer in porten för azure-containerlösningar för skillnad.

Python Dockerfile

En Dockerfile är en textfil som innehåller instruktioner för att skapa en Docker-avbildning. Den första raden anger basavbildningen till att börja med. Den här raden följs av instruktioner för att installera nödvändiga program, kopiera filer och andra instruktioner för att skapa en arbetsmiljö. Till exempel visas några Python-specifika exempel för viktiga Python Dockerfile-instruktioner i tabellen nedan.

Docker build-kommandot skapar Docker-avbildningar från en Dockerfile och en kontext. En byggkontext är den uppsättning filer som finns i den angivna sökvägen eller URL:en. Vanligtvis skapar du en avbildning från python-projektets rot och sökvägen för build-kommandot är "." som du ser i följande exempel.

docker build --rm --pull  --file "Dockerfile"  --tag "mywebapp:latest"  .

Byggprocessen kan referera till någon av filerna i kontexten. Ditt bygge kan till exempel använda en COPY-instruktion för att referera till en fil i kontexten. Här är ett exempel på en Dockerfile för ett Python-projekt med flaskramverket:

FROM python:3.8-slim

EXPOSE 5000

# Keeps Python from generating .pyc files in the container.
ENV PYTHONDONTWRITEBYTECODE=1

# Turns off buffering for easier container logging
ENV PYTHONUNBUFFERED=1

# Install pip requirements.
COPY requirements.txt .
RUN python -m pip install -r requirements.txt

WORKDIR /app
COPY . /app

# Creates a non-root user with an explicit UID and adds permission to access the /app folder.
RUN adduser -u 5678 --disabled-password --gecos "" appuser && chown -R appuser /app
USER appuser

# Provides defaults for an executing container; can be overridden with Docker CLI.
CMD ["gunicorn", "--bind", "0.0.0.0:5000", "wsgi:app"]

Du kan skapa en Dockerfile för hand eller skapa den automatiskt med VS Code och Docker-tillägget. Mer information finns i Generera Docker-filer.

Docker Build-kommandot är en del av Docker CLI. När du använder IDE:er som VS Code eller PyCharm anropar användargränssnittskommandona för att arbeta med Docker-avbildningar build-kommandot åt dig och automatiserar att ange alternativ.

Arbeta med Python Docker-avbildningar och containrar

VS Code och PyCharm

Det är inte nödvändigt att arbeta i en integrerad utvecklingsmiljö (IDE) för utveckling av Python-containrar, men det kan förenkla många containerrelaterade uppgifter. Här är några av de saker du kan göra med VS Code och PyCharm.

• Ladda ned och skapa Docker-avbildningar.

  • Skapa avbildningar i utvecklingsmiljön.
  • Skapa Docker-avbildningar i Azure utan Docker installerat i utvecklingsmiljön. (För PyCharm använder du Azure CLI för att skapa avbildningar i Azure.)

• Skapa och kör Docker-containrar från en befintlig avbildning, en hämtad avbildning eller direkt från en Dockerfile.

• Kör multicontainer-program med Docker Compose.

• Anslut och arbeta med containerregister som Docker Hub, GitLab, JetBrains Space, Docker V2 och andra självvärdade Docker-register.

• (endast VS Code) Lägg till en Dockerfile - och Docker-sammansättningsfiler som är skräddarsydda för ditt Python-projekt.

Använd följande steg för att konfigurera VS Code och PyCharm för att köra Docker-containrar i utvecklingsmiljön.

• VS-kod
• PyCharm

Om du inte redan har gjort det installerar du Azure Tools för VS Code.

Instruktioner	Skärmbild
Steg 1: Använd SKIFT + ALT + A för att öppna Azure-tillägget och bekräfta att du är ansluten till Azure. Du kan också välja Azure-ikonen i VS Code-tilläggsfältet. Om du inte är inloggad väljer du Logga in på Azure och följer anvisningarna. Om du har problem med att komma åt din Azure-prenumeration kan det bero på att du är bakom en proxyserver. Information om hur du löser anslutningsproblem finns i Nätverks Anslut ions i Visual Studio Code.
Steg 2: Använd CTRL + SKIFT + X för att öppna Tillägg, söka efter Docker-tillägget och installera tillägget. Du kan också välja tilläggsikonen i VS Code-tilläggsfältet.
Steg 3: Välj Docker-ikonen i tilläggsfältet, expandera bilder och högerklicka på en avbildning kör den som en container.
Steg 4: Övervaka Docker-körningens utdata i terminalfönstret .

Azure CLI och Docker CLI

Du kan också arbeta med Python Docker-avbildningar och containrar med hjälp av Azure CLI och Docker CLI. Både VS Code och PyCharm har terminaler där du kan köra dessa CLI:er.

Använd ett CLI när du vill ha bättre kontroll över bygg- och körningsargument och för automatisering. Följande kommando visar till exempel hur du använder Azure CLI az acr build för att ange Docker-avbildningsnamnet.

az acr build --registry <registry-name> \
  --resource-group <resource-group> \
  --target pythoncontainerwebapp:latest .

Som ett annat exempel bör du överväga följande kommando som visar hur du använder Kommandot Docker CLI-körning. Exemplet visar hur du kör en Docker-container som kommunicerar med en MongoDB-instans i utvecklingsmiljön utanför containern. De olika värdena för att slutföra kommandot är enklare att automatisera när de anges på en kommandorad.

docker run --rm -it \
  --publish <port>:<port> --publish 27017:27017 \
  --add-host mongoservice:<your-server-IP-address> \
  --env CONNECTION_STRING=mongodb://mongoservice:27017 \
  --env DB_NAME=<database-name> \
  --env COLLECTION_NAME=<collection-name> \
  containermongo:latest  

Mer information om det här scenariot finns i Skapa och testa en containerbaserad Python-webbapp lokalt.

Miljövariabler i containrar

Python-projekt använder ofta miljövariabler för att skicka data till kod. Du kan till exempel ange information om databasanslutning i en miljövariabel så att den enkelt kan ändras under testningen. Eller när du distribuerar projektet till produktion kan databasanslutningen ändras för att referera till en instans av produktionsdatabasen.

Paket som python-dotenv används ofta för att läsa nyckel/värde-par från en .env-fil och ange dem som miljövariabler. En .env-fil är användbar när den körs i en virtuell miljö, men rekommenderas inte när du arbetar med containrar. Kopiera inte .env-filen till Docker-avbildningen, särskilt om den innehåller känslig information och containern kommer att offentliggöras. Använd .dockerignore-filen för att undanta filer från att kopieras till Docker-avbildningen. Mer information finns i avsnittet Virtuella miljöer och containrar i den här artikeln.

Du kan skicka miljövariabler till containrar på några sätt:

1. Definieras i Dockerfile som ENV-instruktioner .
2. Skickas som --build-arg argument med Kommandot Docker build .
3. Skickas som --secret argument med Kommandot Docker build och BuildKit-serverdelen .
4. Skickas som --env eller --env-file argument med Kommandot Docker-körning.

De två första alternativen har samma nackdel som ovan med .env-filer , nämligen att du hårdkodar potentiellt känslig information till en Docker-avbildning. Du kan inspektera en Docker-avbildning och se miljövariablerna, till exempel med kommandot docker-avbildningen inspekterad.

Med det tredje alternativet med BuildKit kan du skicka hemlig information som ska användas i Dockerfile för att skapa Docker-avbildningar på ett säkert sätt som inte lagras i den slutliga avbildningen.

Det fjärde alternativet för att skicka in miljövariabler med Kommandot Docker-körning innebär att Docker-avbildningen inte innehåller variablerna. Variablerna är dock fortfarande synliga och inspekterar containerinstansen (till exempel när dockercontainern inspekteras). Det här alternativet kan vara acceptabelt när åtkomsten till containerinstansen styrs eller i test- eller utvecklingsscenarier.

Här är ett exempel på hur du skickar miljövariabler med kommandot Docker CLI-körning och använder --env argumentet .

# PORT=8000 for Django and 5000 for Flask
export PORT=<port-number>

docker run --rm -it \
  --publish $PORT:$PORT \
  --env CONNECTION_STRING=<connection-info> \
  --env DB_NAME=<database-name> \
  <dockerimagename:tag>

Om du använder VS Code eller PyCharm använder användargränssnittsalternativen för att arbeta med avbildningar och containrar slutligen Docker CLI-kommandon som det som visas ovan.

Slutligen är det annorlunda att ange miljövariabler när du distribuerar en container i Azure än att använda miljövariabler i utvecklingsmiljön. Till exempel:

• För Web App for Containers konfigurerar du programinställningar under konfigurationen av App Service. De här inställningarna är tillgängliga för din appkod som miljövariabler och används med standardmönstret os.environ . Du kan ändra värden efter den första distributionen när det behövs. Mer information finns i Åtkomst till appinställningar som miljövariabler.

• För Azure Container Apps konfigurerar du miljövariabler under den inledande konfigurationen av containerappen. Efterföljande ändringar av miljövariabler skapar en revision av containern. Dessutom kan du med Azure Container Apps definiera hemligheter på programnivå och sedan referera till dem i miljövariabler. Mer information finns i Hantera hemligheter i Azure Container Apps.

Som ett annat alternativ kan du använda Service Anslut or för att hjälpa dig att ansluta Azure-beräkningstjänster till andra säkerhetskopieringstjänster. Den här tjänsten konfigurerar nätverksinställningar och anslutningsinformation (till exempel generera miljövariabler) mellan beräkningstjänster och målstödtjänster i hanteringsplanet.

Visa containerloggar

Visa containerinstansloggar för att se diagnostikmeddelanden som matas ut från kod och för att felsöka problem i containerns kod. Här är flera sätt att visa loggar när du kör en container i utvecklingsmiljön:

• När du kör en container med VS Code eller PyCharm, som du ser i avsnittet VS Code och PyCharm, kan du se loggar i terminalfönster som öppnas när Docker-körningen körs.

• Om du använder Kommandot Docker CLI-körning med den interaktiva flaggan -itvisas utdata som följer kommandot .

• I Docker Desktop kan du också visa loggar för en container som körs.

När du distribuerar en container i Azure har du också åtkomst till containerloggar. Här är flera Azure-tjänster och hur du kommer åt containerloggar i Azure-portalen.

Här är Azure CLI-kommandona för att komma åt loggar för samma tjänster som anges ovan.

Det finns också stöd för att visa loggar i VS Code. Du måste ha Azure Tools for VS Code installerat. Nedan visas ett exempel på hur du visar Loggar för Web Apps for Containers (App Service) i VS Code.

Nästa steg

• Containerbaserad Python-webbapp i Azure med MongoDB
• Distribuera en Python-webbapp i Azure Container Apps med PostgreSQL