Azure Functions beheren in Azure Container Apps

U kunt uw geïmplementeerde functies in Azure Container Apps beheren met behulp van de Azure CLI. Met de volgende opdrachten kunt u de functies die worden uitgevoerd in uw containeromgeving weergeven, inspecteren en ermee werken.

Opmerking

Wanneer u te maken hebt met scenario's met meerdere revisies, voegt u de parameter --revision <REVISION_NAME> toe aan uw opdracht om een specifieke revisie te targeten.

Lijst functies

Bekijk alle functies die zijn geïmplementeerd in uw container-app:

# List all functions
az containerapp function list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME

Functiedetails weergeven

Gedetailleerde informatie over een specifieke functie ophalen:

az containerapp function show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --function-name <FUNCTIONS_APP_NAME>

Functie-aanroepen bewaken

Het bewaken van uw functie-app is essentieel voor het begrijpen van de prestaties en het diagnosticeren van problemen. De volgende opdrachten laten zien hoe u functie-URL's ophaalt, aanroepen activeert en gedetailleerde telemetrie- en aanroepsamenvattingen bekijkt met behulp van de Azure CLI. Voordat u de traceringen aanroept, roept u de functie een paar keer aan met behulp van curl -X POST "fqdn/api/HttpExample".

  1. Om aanroeptraceringen weer te geven, haalt u gedetailleerde traceringen van functieaanroepen op:

    az containerapp function invocations traces \
      --name $CONTAINERAPP_NAME \
      --resource-group $RESOURCE_GROUP \
      --function-name <FUNCTIONS_APP_NAME> \
      --timespan 5h \
      --limit 3
    
  2. Bekijk een aanroepsamenvatting om geslaagde en mislukte aanroepen te controleren.

    az containerapp function invocations summary \
      --name $CONTAINERAPP_NAME \
      --resource-group $RESOURCE_GROUP \
      --function-name <FUNCTIONS_APP_NAME> \
      --timespan 5h
    

Functietoetsen beheren

Azure Functions maakt gebruik van sleutels voor verificatie en autorisatie. U kunt de volgende verschillende typen sleutels beheren:

  • Hostsleutels: toegang krijgen tot elke functie in de app
  • Hoofdsleutels: beheerderstoegang bieden
  • Systeemsleutels: gebruikt door Azure-services
  • Functietoetsen: Toegang tot specifieke functies

De volgende opdrachten laten zien hoe u sleutels voor de host beheert. Als u dezelfde opdracht wilt uitvoeren voor een specifieke Functions-app, voegt u de --function-name <FUNCTIONS_APP_NAME> parameter toe aan uw opdracht.

Sleutels vermelden

Gebruik de volgende opdrachten om host- en functiespecifieke sleutels weer te geven voor uw Azure Functions die worden uitgevoerd in Container Apps.

Opmerking

Zorg ervoor dat er ten minste één replica actief blijft voor de volgende opdrachten voor sleutelsbeheer.

az containerapp function keys list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-type hostKey

Een specifieke sleutel weergeven

Geef de waarde van een specifieke sleutel op hostniveau voor uw functie-app weer met behulp van de volgende opdracht:

az containerapp function keys show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-type hostKey

Een sleutel instellen

Stel een specifieke sleutel op hostniveau in voor uw functie-app met behulp van de volgende opdracht:

az containerapp function keys set \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-value <KEY_VALUE> \
  --key-type hostKey

Sleutelbeheer met Azure Key Vault

Wanneer u Azure Key Vault gebruikt om geheimen op te slaan voor Azure Functions in Container Apps, werkt het genereren van sleutels anders dan in traditionele Functions-hosting.

Standaard:

  • De Functions-host maakt niet automatisch sleutels in Key Vault wanneer deze wordt gestart.

  • De Functions-host haalt sleutels op en gebruikt deze als deze al bestaan in Key Vault.

  • De Functions-host wordt zelfs zonder sleutels gestart en de sleutelsynchronisatie wordt normaal voltooid.

Als gevolg hiervan wordt uw toepassing correct uitgevoerd, maar sleutels op hostniveau worden niet weergegeven in Key Vault, tenzij u ze handmatig maakt.

Sleutels handmatig genereren

Als u het maken van sleutels in Azure Key Vault wilt activeren, roept u het Functions-beheereindpunt aan met behulp van de volgende CLI-opdracht.

az containerapp function keys list \
 -n <CONTAINER_APP_NAME> \
 -g <RESOURCE_GROUP> \
 --key-type hostKey