Korzystanie z usługi Azure Functions w usłudze Azure Container Apps

W tym artykule pokazano, jak utworzyć aplikację usługi Azure Functions w usłudze Azure Container Apps wraz ze wstępnie skonfigurowanymi regułami skalowania automatycznego.

Wymagania wstępne

Zasób Opis
Konto platformy Azure Konto Azure z aktywną subskrypcją.

Jeśli go nie masz, utwórz go bezpłatnie.
Konto usługi Azure Storage Konto usługi Blob Storage do przechowywania stanu dla usługi Azure Functions.
aplikacja systemu Azure Insights Wystąpienie usługi aplikacja systemu Azure Insights do zbierania danych dotyczących aplikacji kontenera.

Utwórz aplikację Functions

W poniższych krokach pokazano, jak utworzyć aplikację kontenera przy użyciu przykładowego obrazu kontenera. Jeśli chcesz użyć tej procedury z niestandardowym obrazem kontenera, zobacz Tworzenie pierwszej aplikacji funkcji w usłudze Azure Container Apps.

  1. Przejdź do witryny Azure Portal i wyszukaj pozycję Container Apps na pasku wyszukiwania.

  2. Wybierz aplikacje kontenerowe.

  3. Wybierz Utwórz.

  4. Wybierz Aplikację kontenera.

  5. W sekcji Podstawy wprowadź następujące wartości.

    Pod Szczegóły projektu:

    Majątek Wartość
    Subskrypcja Wybierz subskrypcję platformy Azure.
    Grupa zasobów Wybierz pozycję Utwórz nową grupę zasobów, nadaj jej nazwę my-aca-functions-group, a następnie wybierz przycisk OK.
    Nazwa aplikacji kontenera Wprowadź my-aca-functions-app.

  6. Obok pozycji Optymalizacja pod kątem usługi Azure Functions zaznacz pole wyboru.

    Zrzut ekranu witryny Azure Portal podczas tworzenia wstępnie skonfigurowanej aplikacji kontenera dla usługi Azure Functions.

  7. W polu Środowisko usługi Container Apps wprowadź:

    Majątek Wartość
    Rejon Wybierz region najbliżej Ciebie.
    Środowisko usługi Container Apps Wybierz pozycję Utwórz nowe środowisko.

  8. W oknie konfiguracja środowiska wprowadź:

    Majątek Wartość
    Nazwa środowiska Wprowadź my-aca-functions-environment
    Redundancja strefowa Wybierz opcję Wyłączone.

  9. Wybierz pozycję Utwórz , aby zapisać wartości.

  10. Wybierz pozycję Dalej: Kontener , aby przełączyć się do sekcji Kontener .

  11. Obok pozycji Użyj obrazu szybkiego startu pozostaw to pole niezaznaczone.

  12. W sekcji Szczegóły kontenera wprowadź następujące wartości.

    Majątek Wartość
    Nazwa To pole jest wstępnie wypełnione twoim wyborem z poprzedniej sekcji.
    Źródło obrazu Wybierz Docker Hub lub inne rejestry
    Subskrypcja Wybierz swoją subskrypcję.
    Typ obrazu Wybierz pozycję Publiczna.
    Serwer logowania rejestru Wprowadź mcr.microsoft.com
    Obraz i etykieta Wprowadź k8se/quickstart-functions:latest

  13. W obszarze Zmienne środowiskowe wprowadź wartości następujących zmiennych:

    • AzureWebJobsStorage
    • APPINSIGHTS_INSTRUMENTATIONKEY lub APPLICATIONINSIGHTS_CONNECTION_STRING

    Wprowadź wartości tożsamości zarządzanej lub parametrów połączenia dla tych zmiennych. Korzystanie z tożsamości zarządzanej.

    Zmienna AzureWebJobsStorage jest wymaganym ciągiem połączenia konta usługi Azure Storage dla usługi Azure Functions. To konto magazynujące przechowuje dzienniki wykonywania funkcji, zarządza wyzwalaczami i powiązaniami oraz utrzymuje stan dla funkcji trwałej.

    Application Insights to usługa monitorowania i diagnostyki, która zapewnia wgląd w wydajność i użycie usługi Azure Functions. Ta usługa monitorowania pomaga śledzić współczynniki żądań, czasy odpowiedzi, współczynniki błędów i inne metryki.

  14. Wybierz pozycję Dalej > Ingress, aby przejść do sekcji Ingress i wprowadzić następujące wartości.

    Majątek Wartość
    Wejście Zaznacz pole wyboru Włączone, aby włączyć ingress.
    Ruch przychodzący Wybierz pozycję Akceptowanie ruchu z dowolnego miejsca.
    Typ ruchu wejściowego Wybierz pozycję HTTP.
    Port docelowy Wprowadź 80.

  15. Wybierz pozycję Przejrzyj i utwórz.

  16. Wybierz Utwórz.

  17. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

  18. Na stronie Przegląd wybierz link obok pozycji Adres URL aplikacji , aby otworzyć aplikację na nowej karcie przeglądarki.

  19. Dołącz /api/HttpExample na końcu adresu URL.

    W przeglądarce jest zwracany komunikat "Funkcja wyzwalacza HTTP przetworzyła żądanie".

Wymagania wstępne

Utwórz aplikację Functions

Aby zalogować się do platformy Azure z poziomu interfejsu wiersza polecenia, uruchom następujące polecenie i postępuj zgodnie z monitami, aby ukończyć proces uwierzytelniania.

  1. Zaloguj się do Azure.

    az login

  2. Aby upewnić się, że używasz najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie uaktualniania.

    az upgrade

  3. Zainstaluj lub zaktualizuj rozszerzenie usługi Azure Container Apps dla interfejsu wiersza polecenia.

    Jeśli podczas uruchamiania poleceń az containerapp w Azure CLI lub poleceń cmdlet z modułu Az.App w PowerShell wystąpią błędy dotyczące brakujących parametrów, upewnij się, że masz zainstalowaną najnowszą wersję rozszerzenia Azure Container Apps.

    az extension add --name containerapp --allow-preview true --upgrade

    Teraz, po zainstalowaniu bieżącego rozszerzenia lub modułu, zarejestruj przestrzenie nazw Microsoft.App i Microsoft.OperationalInsights.

    az provider register --namespace Microsoft.App

    az provider register --namespace Microsoft.OperationalInsights

  4. Utwórz zmienne środowiskowe.

    RESOURCE_GROUP_NAME="my-aca-functions-group"
CONTAINER_APP_NAME="my-aca-functions-app"
ENVIRONMENT_NAME="my-aca-functions-environment"
LOCATION="westus"
STORAGE_ACCOUNT_NAME="storage-account-name"
STORAGE_ACCOUNT_SKU="storage-account-sku"
APPLICATION_INSIGHTS_NAME="application-insights-name"

  5. Utwórz grupę zasobów.

    az group create \
  --name $RESOURCE_GROUP_NAME \
  --location $LOCATION \
  --output none

  6. Utwórz środowisko usługi Container Apps.

    az containerapp env create \
    --name $ENVIRONMENT_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --location $LOCATION \
    --output none

  7. Utwórz konto przechowywania

    az storage account create \
  --name $STORAGE_ACCOUNT_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --sku $STORAGE_ACCOUNT_SKU

  8. Uzyskiwanie ciągu połączenia konta magazynowego

    $STORAGE_ACCOUNT_CONNECTION_STRING = az storage account show-connection-string \
  --name $STORAGE_ACCOUNT_NAME \
  --resource-group $RESOURCE_GROUP \
  --query connectionString \
  --output tsv

  9. Tworzenie usługi Azure Applications Insights

    az monitor app-insights component create \
--app $APPLICATION_INSIGHTS_NAME \
--location $LOCATION \
  --resource-group $RESOURCE_GROUP \
  --application-type web

  10. Uzyskanie ciągu połączenia do usługi Application Insights

    $APPLICATION_INSIGHTS_CONNECTION_STRING = az monitor app-insights component show \
  --app $APPLICATION_INSIGHTS_NAME \
  --resource-group $RESOURCE_GROUP \
  --query connectionString \
  --output tsv

  11. Tworzenie aplikacji kontenera usługi Azure Functions.

    az containerapp create \
  --resource-group $RESOURCE_GROUP_NAME \
  --name $CONTAINER_APP_NAME \
  --environment $ENVIRONMENT_NAME \
  --image mcr.microsoft.com/azure-functions/dotnet8-quickstart-demo:1.0 \
  --ingress external \
  --target-port 80 \
  --kind functionapp \
  --query properties.outputs.fqdn

    To polecenie zwraca adres URL aplikacji usługi Functions. Skopiuj ten adres URL i wklej go w przeglądarce internetowej.

  12. Tworzenie aplikacji kontenerowej usługi Azure Functions z użyciem --revisions-mode multiple na potrzeby scenariusza z wieloma wersjami

    az containerapp create \
  --name $CONTAINERAPP_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image mcr.microsoft.com/azure-functions/dotnet8-quickstart-demo:1.0 \
  --target-port 80 \
  --ingress external \
  --kind functionapp \
  --workload-profile-name $WORKLOAD_PROFILE_NAME \
  --env-vars AzureWebJobsStorage="$STORAGE_ACCOUNT_CONNECTION_STRING" APPLICATIONINSIGHTS_CONNECTION_STRING="$APPLICATION_INSIGHTS_CONNECTION_STRING"

  13. W przypadku scenariusza z wieloma rewizjami zaktualizuj aplikację kontenera i podziel ruch.

    az containerapp update \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --image mcr.microsoft.com/azure-functions/dotnet8-quickstart-demo:latest

az containerapp ingress traffic set -resource-group \
  --name $CONTAINERAPP_NAME \
  --resource-group $RESOURCE_GROUP \
  --revision-weight {revision1_name}=50 \
  --revision-weight {revision2_name}=50

  14. Dołącz /api/HttpExample na końcu adresu URL.

    W przeglądarce jest zwracany komunikat "Funkcja wyzwalacza HTTP przetworzyła żądanie".

Treści powiązane

  • Last updated on