Arbeiten mit Containern und Azure-Funktionen

In diesem Artikel wird die Unterstützung veranschaulicht, die Azure Functions für containerisierte Funktions-Apps bereitstellt, die in einer Azure-Container-Apps-Umgebung ausgeführt werden. Weitere Informationen finden Sie unter Azure Container Apps-Hosting von Azure Functions.

In diesem Artikel wird die Unterstützung veranschaulicht, die Azure Functions für Funktions-Apps bereitstellt, die in Linux-Containern ausgeführt werden.

Erstellen Ihrer ersten Azure Functions-Container in Azure Container Apps

Weitere Informationen zu Bereitstellungen in Azure Container Apps finden Sie unter Azure Container Apps-Hosting von Azure Functions.

Erstellen Ihrer ersten Azure Functions-Container

Arbeiten mit Containern und Azure Functions

Sie sollten auch die Aktivierung von Continuous Deployment in Erwägung ziehen.

Erstellen einer containerisierten Funktions-App mithilfe des Azure-Portals

Wenn Sie eine Funktions-App im Azure-Portal erstellen, können Sie die Funktions-App aus einem Image in einer Containerregistrierung bereitstellen. Informationen zum Erstellen einer containerisierten Funktions-App in einer Containerregistrierung finden Sie unter Erstellen Ihrer Funktions-App in einem Container.

In den folgenden Schritten wird eine vorhandene containerisierte Funktions-App aus einer Containerregistrierung erstellt und bereitgestellt.

1. Klicken Sie im Menü des Azure-Portals oder auf der Startseite auf Ressource erstellen.

2. Wählen Sie auf der Seite "Neu " die Option "Web>Function App" aus.

3. Wählen Sie unter "Hostingoption auswählen" die Option "Funktionen Premium>auswählen" aus.

   Diese Aktion erstellt eine Funktions-App, die von Azure Functions im Premium-Plan gehostet wird, die die dynamische Skalierung unterstützt. Sie können sich auch für die Ausführung in einem App Service-Plan entscheiden, aber bei diesem dedizierten Plan müssen Sie die Skalierung Ihrer Funktions-App verwalten.

4. Verwenden Sie auf der Seite „Grundlagen“ die Funktions-App-Einstellungen, wie in der folgenden Tabelle angegeben.

   Setting	Vorgeschlagener Wert	Description
   Subscription	Ihr Abonnement	Das Abonnement, unter dem Sie Ihre Funktions-App erstellen.
   Ressourcengruppe	myResourceGroup	Der Name der neuen Ressourcengruppe, in der Sie Ihre Funktions-App erstellen. Sie sollten eine Ressourcengruppe erstellen, da beim Erstellen neuer Funktions-Apps in einer vorhandenen Ressourcengruppe bekannte Einschränkungen gelten.
   Name der Funktions-App	Ein App-Name	Der Name, der Ihre neue Funktionen-App bezeichnet Gültige Zeichen sind a-z (Groß-/Kleinschreibung nicht beachtet), 0-9 und -.
   Sicherer eindeutiger Standardhostname	Enabled	Aktivieren Sie dieses Feature, damit Sie sich keine Gedanken über Domänennamenkonflikte machen müssen, unabhängig vom App-Namen.
   Möchten Sie Code oder ein Containerimage bereitstellen?	Containerimage	Stellen Sie eine containerisierte Funktions-App aus einer Registrierung bereit. Informationen zum Erstellen einer Funktions-App in der Registrierung finden Sie unter Erstellen einer Funktions-App in einem lokalen Linux-Container.
   Region	Bevorzugte Region	Wählen Sie eine Region in Ihrer Nähe oder in der Nähe anderer Dienste aus, auf die Ihre Funktionen zugreifen können.
   Linux-Plan	Neuer Plan (Standard)	Erstellt einen neuen Premium-Plan zum Hosten Ihrer App. Sie können auch einen vorhandenen Premium-Plan auswählen.
   Tarif	Elastic Premium EP1	EP1 ist der kostengünstigste Plan. Sie können bei Bedarf einen umfangreicheren Plan auswählen.
   Zonenredundanz	Disabled	Sie benötigen dieses Feature nicht in einer Nichtproduktions-App.

5. Akzeptieren Sie die Standardoptionen zum Erstellen eines neuen Speicherkontos auf der Registerkarte " Speicher " und einer neuen Application Insight-Instanz auf der Registerkarte "Überwachung ". Sie können auch ein vorhandenes Speicherkonto oder eine Application Insights-Instanz verwenden.

6. Wählen Sie Bewerten + erstellen aus, um die App-Konfigurationsauswahl zu überprüfen.

7. Überprüfen Sie auf der Seite Bewerten + erstellen Ihre Einstellungen, und wählen Sie dann Erstellen aus, um die Funktions-App mithilfe eines Standard-Basisimages bereitzustellen.

8. Nachdem Ihre Funktions-App-Ressource erstellt wurde, wählen Sie "Zur Ressource wechseln" aus. Wählen Sie auf der Seite der Funktions-App die Option Bereitstellungscenter aus.

9. Im Bereitstellungscenter können Sie Ihre Containerregistrierung als Quelle für das Image verbinden. Sie können auch GitHub Actions oder Azure-Pipelines aktivieren, um eine solidere kontinuierliche Bereitstellung von Updates für Ihren Container in der Registrierung zu ermöglichen.

Erstellen einer containerisierten Funktions-App mithilfe des Azure-Portals

Wenn Sie eine in Container-Apps gehostete Funktions-App im Azure-Portal erstellen, können Sie ihre Funktions-App aus einem Image in einer Containerregistrierung bereitstellen. Informationen zum Erstellen einer containerisierten Funktions-App in einer Containerregistrierung finden Sie unter Erstellen Ihrer Funktions-App in einem Container.

In den folgenden Schritten wird eine vorhandene containerisierte Funktions-App aus einer Containerregistrierung erstellt und bereitgestellt.

1. Klicken Sie im Menü des Azure-Portals oder auf der Startseite auf Ressource erstellen.

2. Wählen Sie auf der Seite "Neu " die Option "Web>Function App" aus.

3. Wählen Sie unter Hostingoption auswählen die Option Container-Apps>Auswählen aus.

4. Verwenden Sie auf der Seite „Grundlagen“ die Funktions-App-Einstellungen, wie in der folgenden Tabelle angegeben.

   Setting	Vorgeschlagener Wert	Description
   Subscription	Ihr Abonnement	Das Abonnement, unter dem Sie Ihre Funktions-App erstellen.
   Ressourcengruppe	myResourceGroup	Der Name der neuen Ressourcengruppe, in der Sie Ihre Funktions-App erstellen. Sie sollten eine Ressourcengruppe erstellen, da beim Erstellen neuer Funktions-Apps in einer vorhandenen Ressourcengruppe bekannte Einschränkungen gelten.
   Name der Funktions-App	Eindeutiger Name*	Der Name, der Ihre neue Funktionen-App bezeichnet Gültige Zeichen sind a-z (Groß-/Kleinschreibung nicht beachtet), 0-9 und -.
   Region	Bevorzugte Region	Wählen Sie eine Region in Ihrer Nähe oder in der Nähe anderer Dienste aus, auf die Ihre Funktionen zugreifen können.

   *App-Name muss innerhalb der Azure-Container-Apps-Umgebung eindeutig sein.

5. Akzeptieren Sie weiterhin auf der Seite "Grundlagen" die vorgeschlagene neue Umgebung für die Azure-Container-Apps-Umgebung. Die neue Standardumgebung wird unter Verbrauch + dediziert mit dem Standardworkloadprofil und ohne Zonenredundanz erstellt, wodurch die Kosten minimiert werden. Weitere Informationen finden Sie unter Azure Container Apps-Hosting von Azure Functions.

   Sie können auch eine vorhandene Container Apps-Umgebung auswählen. Um eine benutzerdefinierte Umgebung zu erstellen, wählen Sie stattdessen "Neu erstellen" aus. Auf der Seite Container Apps-Umgebung erstellen können Sie nicht standardmäßige Workloadprofile hinzufügen oder Zonenredundanz aktivieren. Weitere Informationen zu Umgebungen finden Sie unter Azure Container Apps-Umgebungen.

6. Wählen Sie die Registerkarte "Container " aus, und deaktivieren Sie die Option "Schnellstartimage verwenden". Andernfalls wird die Funktions-App über das Basisimage für Ihre Funktions-App-Sprache bereitgestellt.

7. Wählen Sie Ihren Bildtyp, öffentlich oder privat aus. Wählen Sie "Privat" aus, wenn Sie azure Container Registry oder eine andere private Registrierung verwenden. Geben Sie den Namen des Bilds an, einschließlich des Registrierungspräfixes. Wenn Sie eine private Registrierung verwenden, geben Sie die Anmeldeinformationen für die Authentifizierung der Imageregistrierung an. Die Einstellung "Öffentlich" unterstützt nur Bilder, die öffentlich im Docker Hub gespeichert sind.

8. Wählen Sie unter Containerressourcenzuordnung die gewünschte Anzahl von CPU-Kernen und verfügbaren Arbeitsspeicher aus. Wenn Ihre Umgebung andere Workloadprofile hinzugefügt hat, können Sie ein nicht standardmäßiges Workloadprofil auswählen. Die Auswahl auf dieser Seite wirkt sich auf die Kosten des Hostings Ihrer App aus. Sehen Sie sich die Seite mit der Preisübersicht von Container Apps, um Ihre potenziellen Kosten zu schätzen.

9. Wählen Sie Bewerten + erstellen aus, um die App-Konfigurationsauswahl zu überprüfen.

10. Überprüfen Sie auf der Seite Überprüfen + erstellen Ihre Einstellungen, und wählen Sie dann Erstellen aus, um die Funktions-App bereitzustellen und Ihr Containerimage aus der Registrierung bereitzustellen.

Verwendung von Lastprofilen für Container-Anwendungen

Workloadprofile sind Funktionen von Container Apps, mit deren Hilfe Sie Ihre Bereitstellungsressourcen besser steuern können. Azure Functions in Azure Container Apps unterstützt auch Workloadprofile. Weitere Informationen finden Sie unter Workloadprofile in Azure Container Apps.

Sie können auch die Menge der CPU- und Arbeitsspeicherressourcen festlegen, die Ihrer App zugeordnet sind.

Sie können sowohl Workloadprofile als auch Ressourcenzuordnungen mithilfe der Azure CLI oder im Azure-Portal erstellen und verwalten.

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime <LANGUAGE_STACK> --image <IMAGE_URI> --workload-profile-name <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

az functionapp container set --name <APP_NAME> --resource-group AzureFunctionsContainers-rg --workload-profile-name  <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

Aktivieren von Continuous Deployment in Azure

Wenn Sie Ihre containerisierte Funktions-App in Azure Container Apps hosten, gibt es zwei Möglichkeiten, die kontinuierliche Bereitstellung aus einem Quellcode-Repository einzurichten:

• Azure-Pipelines
• GitHub-Aktionen

Sie sind derzeit nicht in der Lage, Container basierend auf Imageänderungen kontinuierlich in einer Containerregistrierung bereitzustellen. Sie müssen stattdessen diese Pipelines für die kontinuierliche Bereitstellung (Continuous Deployment) auf Basis des Quellcodes verwenden.

Aktivieren von Continuous Deployment in Azure

Sie können Azure Functions aktivieren, um Ihre Bereitstellung eines Images jeweils automatisch zu aktualisieren, wenn Sie das Bild in der Registrierung aktualisieren.

1. Verwenden Sie den folgenden Befehl, um Continuous Deployment zu aktivieren und die Webhook-URL abzurufen:

az functionapp deployment container config --enable-cd --query CI_CD_URL --output tsv --name <APP_NAME> --resource-group AzureFunctionsContainers-rg

Update-AzFunctionAppSetting -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg -AppSetting @{"DOCKER_ENABLE_CI" = "true"}
Get-AzWebAppContainerContinuousDeploymentUrl -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg

Ersetzen Sie wie zuvor <APP_NAME> durch den Namen Ihrer Funktions-App.

1. Kopieren Sie die Webhook-URL der Bereitstellung in die Zwischenablage.

2. Öffnen Sie Docker Hub, melden Sie sich an, und wählen Sie Repositorys auf der Navigationsleiste aus. Suchen Sie das Bild, wählen Sie die Registerkarte "Webhooks " aus, geben Sie einen Webhook-Namen an, fügen Sie Ihre URL in die Webhook-URL ein, und wählen Sie dann " Erstellen" aus.

   

3. Nachdem der Webhook festgelegt wurde, wird Ihr Image von Azure Functions jeweils erneut bereitgestellt, wenn Sie es in Docker Hub aktualisieren.

Aktivieren von SSH-Verbindungen

SSH ermöglicht die sichere Kommunikation zwischen einem Container und einem Client. Wenn SSH aktiviert ist, können Sie mithilfe der erweiterten App Service-Tools (Kudu) eine Verbindung mit Ihrem Container herstellen. Azure Functions stellt ein Basisimage bereit, für das SSH bereits aktiviert ist, um das Herstellen einer Verbindung mit Ihrem Container per SSH zu vereinfachen. Sie müssen Ihre Dockerfile-Datei nur bearbeiten, dann neu erstellen und das Image erneut bereitstellen. Anschließend können Sie mit den Advanced Tools (Kudu) eine Verbindung mit dem Container herstellen.

1. Fügen Sie in Ihrer Dockerfile-Datei die Zeichenfolge -appservice an das Basisimage in Ihrer FROM Anweisung an, wie im folgenden Beispiel gezeigt:

   FROM mcr.microsoft.com/azure-functions/node:4-node18-appservice
   

   In diesem Beispiel wird die SSH-fähige Version des Basisimages von Node.js-Version 18 verwendet. Besuchen Sie die Azure Functions-Basisimagerepositorys, um zu überprüfen, ob Sie die neueste Version des SSH-fähigen Basisimages verwenden.

2. Erstellen Sie das Image neu, indem Sie den Befehl docker build verwenden und <DOCKER_ID> wie im folgenden Beispiel gezeigt durch Ihre Docker Hub-Konto-ID ersetzen.

   docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
   

3. Pushen Sie das aktualisierte Image an Docker Hub. Dies sollte deutlich weniger Zeit als der erste Pushvorgang in Anspruch nehmen. Nur die aktualisierten Segmente des Images müssen jetzt hochgeladen werden.

   docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
   

4. Azure Functions stellt das Bild automatisch für Ihre Funktionen-App erneut bereit. Der Vorgang findet in weniger als einer Minute statt.

5. Suchen Sie im Azure-Portal Ihre Funktions-App. Wählen Sie im linken Menü die Option "Entwicklungstools>SSH" aus. Klicken Sie auf Starten. Die Verbindungsherstellung könnte etwas dauern, falls das Containerimage von Azure noch aktualisiert wird.

6. Nachdem eine Verbindung mit Ihrem Container hergestellt wurde, können Sie den Befehl top ausführen, um die derzeit ausgeführten Prozesse anzuzeigen.