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 nie masz konta, możesz je utworzyć teraz za darmo.
Konto usługi Azure Storage	Konto usługi Blob Storage do przechowywania stanu dla usługi Azure Functions.
Azure Application Insights	Wystąpienie usługi Azure Application 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ź ciąg my-aca-functions-app.

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

   

7. W obszarze Ś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ź środowisko 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	Wybieranie usługi Docker Hub lub innych rejestrów
    Subskrypcja	Wybierz swoją subskrypcję.
    Typ obrazu	Wybierz pozycję Publiczna.
    Serwer logowania rejestru	Wprowadź mcr.microsoft.com
    Obraz i tag	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 wymaganymi parametrami 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. To monitorowanie pomaga śledzić współczynniki żądań, czasy odpowiedzi, współczynniki błędów i inne metryki.

14. Wybierz pozycję Dalej > ruch przychodzący, aby przełączyć się do sekcji Ruch przychodzący i wprowadzić następujące wartości.

    Majątek	Wartość
    Wejście	Zaznacz pole wyboru Włączone , aby włączyć ruch przychodzący.
    Ruch przychodzący	Wybierz pozycję Akceptowanie ruchu z dowolnego miejsca.
    Typ ruchu przychodzącego	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

• Konto Azure z aktywną subskrypcją.
  • Jeśli nie masz konta platformy Azure, możesz go utworzyć bezpłatnie.
• Zainstalowany interfejs wiersza polecenia platformy Azure.

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

• Omówienie usługi Azure Functions w usłudze Azure Container Apps