Självstudie: Automatisera storleksändring av överladdade bilder med Event Grid

Azure Event Grid är en händelsetjänst för molnet. Med Event Grid kan du skapa prenumerationer på händelser som genereras av Azure-tjänster eller resurser från tredje part.

Den här självstudien är del två i en serie med Storage-självstudier. Den bygger vidare på föregående Storage-självstudie och lägger till serverfri och automatisk generering av miniatyrbilder med Azure Event Grid och Azure Functions. Event Grid gör att Azure Functions kan svara på Azure Blob Storage-händelser och generera miniatyrbilder av bilder som laddats upp. En händelseprenumeration skapas mot skapandehändelsen i Blob Storage. När en blob läggs till i en viss Blob-lagringscontainer anropas en funktionsslutpunkt. Data som skickas till funktionsbindningen från Event Grid används till att få åtkomst till bloben och generera miniatyrbilden.

Du kan använda Azure CLI och Azure-portalen till att lägga till funktionen för storleksändring i en befintlig app för uppladdning av bilder.

I den här guiden får du lära dig att:

Förutsättningar

För att slutföra den här kursen behöver du:

• Du behöver en Azure-prenumeration. Den här självstudien fungerar inte med den kostnadsfria prenumerationen.
• Du måste ha slutfört föregående Blob Storage-självstudie: Överför bilddata i molnet med Azure Storage.

Skapa ett Azure Storage-konto

För Azure Functions krävs ett allmänt lagringskonto. Utöver bloblagringskontot som du skapade i föregående självstudie skapar du ett separat allmänt lagringskonto i resursgruppen. Namnet på ett lagringskonto måste vara mellan 3 och 24 tecken långt och får endast innehålla siffror och gemener.

Ange variabler som ska innehålla namnet på den resursgrupp som du skapade i föregående självstudie, platsen för de resurser som ska skapas och namnet på det nya lagringskonto som Azure Functions kräver. Skapa sedan lagringskontot för Azure-funktionen.

Skapa en funktionsapp

Du måste ha en funktionsapp som värd för körning av funktionen. Funktionsappen är en miljö för serverfri körning av funktionskoden.

I följande kommando anger du ditt unika namn på funktionsappen. Funktionsappens namn används som DNS-standarddomän för funktionsappen. Därför måste namnet vara unikt bland alla appar i Azure.

Ange ett namn för funktionsappen som ska skapas och skapa sedan Azure-funktionen.

Konfigurera nu funktionsappen så att den ansluter till bloblagringskontot som du skapade i föregående självstudie.

Konfigurera funktionsappen

Funktionen behöver autentiseringsuppgifter för Blob Storage-kontot, som läggs till i programinställningarna för funktionsappen med antingen kommandot az functionapp config appsettings set eller Update-AzFunctionAppSetting.

storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

az functionapp config appsettings set --name $functionapp --resource-group $resourceGroupName --settings "AzureWebJobsStorage=$storageConnectionString THUMBNAIL_CONTAINER_NAME=thumbnails THUMBNAIL_WIDTH=100 FUNCTIONS_EXTENSION_VERSION=~2 FUNCTIONS_WORKER_RUNTIME=dotnet"

$storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

Update-AzFunctionAppSetting -Name $functionapp -ResourceGroupName $resourceGroupName -AppSetting @{AzureWebJobsStorage=$storageConnectionString; THUMBNAIL_CONTAINER_NAME=thumbnails; THUMBNAIL_WIDTH=100 FUNCTIONS_EXTENSION_VERSION=~2; 'FUNCTIONS_WORKER_RUNTIME'='dotnet'}

blobStorageAccountKey=$(az storage account keys list -g $resourceGroupName -n $blobStorageAccount --query [0].value --output tsv)

storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

az functionapp config appsettings set --name $functionapp --resource-group $resourceGroupName --settings "FUNCTIONS_EXTENSION_VERSION=~2 BLOB_CONTAINER_NAME=thumbnails AZURE_STORAGE_ACCOUNT_NAME=$blobStorageAccount AZURE_STORAGE_ACCOUNT_ACCESS_KEY=$blobStorageAccountKey AZURE_STORAGE_CONNECTION_STRING=$storageConnectionString FUNCTIONS_WORKER_RUNTIME=node"

Inställningen FUNCTIONS_EXTENSION_VERSION=~2 får funktionsappen att köra version 2.x av Azure Functions-körningen.

Nu kan du distribuera ett funktionskodprojekt till den här funktionsappen.

Distribuera funktionskoden

az functionapp deployment source config --name $functionapp --resource-group $resourceGroupName --branch master --manual-integration --repo-url https://github.com/Azure-Samples/function-image-upload-resize

az functionapp deployment source config --name $functionapp \
  --resource-group $resourceGroupName --branch master --manual-integration \
  --repo-url https://github.com/Azure-Samples/storage-blob-resize-function-node-v10

Funktionen för att ändra bildstorlek utlöses av HTTP-förfrågningar som skickats till den från tjänsten Event Grid. Du kan ange för Event Grid att du vill hämta meddelandena via funktionens URL genom att skapa en händelseprenumeration. För den här självstudien prenumererar du på blob-skapade händelser.

Data som skickas till funktionen från Event Grid-meddelandet inkluderar blobens URL. URL:en skickas sedan till indatabindningen för att hämta den uppladdade avbildningen från Blob Storage. Funktionen genererar en miniatyrbild och skriver den resulterande dataströmmen till en separat container i Blob Storage.

I det här projektet används EventGridTrigger som typ av utlösare. Det är bättre att använda Event Grid-utlösaren än någon allmän HTTP-utlösare. Event Grid verifierar automatiskt Event Grid Function-utlösare. Med allmänna HTTP-utlösare måste du implementera verifieringssvaret.

Funktionsprojektkoden distribueras direkt från den offentliga exempeldatabasen. Mer information om distributionsalternativen för Azure Functions finns i Kontinuerlig distribution för Azure Functions.

Skapa en händelseprenumeration

En händelseprenumeration anger vilka provider-genererade händelser du vill skicka till en viss slutpunkt. I det här fallet exponeras slutpunkten av din funktion. Använd följande steg till att skapa en händelseprenumeration som skickar meddelanden till din funktion i Azure-portalen:

1. I Azure Portaldu upp på sidan och söker efter och väljer Function App funktionsappen som du nyss skapade. Välj Funktioner och sedan miniatyrfunktionen.

   

2. Välj Integrering och välj sedan Event Grid utlösare och välj Skapa Event Grid prenumeration.

   

3. Använd de inställningar för händelseprenumerationen som anges i tabellen.

   

   Inställning	Föreslaget värde	Beskrivning
   Namn	imageresizersub	Namn som identifierar din nya händelseprenumeration.
   Typ av ämne	Lagringskonton	Välj händelseprovidern för Storage-kontot.
   Prenumeration	Din Azure-prenumeration	Som standard välj den aktuella Azure-prenumerationen.
   Resursgrupp	myResourceGroup	Välj Använd befintlig och välj den resursgrupp du har använt i den här självstudien.
   Resurs	Ditt Blob Storage-konto	Välj det Blob Storage-konto du skapade.
   Systemämnesnamn	imagestoragesystopic	Ange ett namn för systemämnet. Mer information om systemämnen finns i Översikt över systemämnen.
   Händelsetyper	Blob skapas	Avmarkera alla typer utom Blob skapas. Det är bara händelsetyper för Microsoft.Storage.BlobCreated som skickas till funktionen.
   Slutpunktstyp	genereras automatiskt	Fördefinierad som Azure Function.
   Slutpunkt	genereras automatiskt	Namnet på funktionen. I det här fallet är det Miniatyr .

4. Växla till fliken Filter och gör följande:

   1. Välj alternativet Aktivera ämnesfiltrering.

   2. För Ämne börjar med anger du följande värde: /blobServices/default/containers/images/.

      

5. Välj Skapa för att lägga till händelseprenumerationen. Detta skapar en händelseprenumeration som Thumbnail utlöser funktionen när en blob läggs till i images containern. Funktionen ändrar storlek på avbildningarna och lägger till dem till containern thumbnails.

Nu när tjänsterna på serversidan har konfigurerats ska du testa funktionen för storleksändring i exempelwebbappen.

Testa exempelappen

När du ska testa storleksändring i webbappen bläddrar du till URL-adressen för din publicerade app. Standardwebbadressen för webbappen är https://<web_app>.azurewebsites.net.

Nästa steg

I den här självstudiekursen lärde du dig att:

Gå vidare till del tre i Storage-självstudien om du vill lära dig om säker åtkomst till lagringskontot.

• Mer information om Event Grid finns i En introduktion till Azure Event Grid.
• Om du vill prova en annan självstudie om Azure Functions kan du läsa Skapa en funktion som kan integreras med Azure Logic Apps.