Kurz: automatizace změny velikosti nahraných imagí pomocí Event Grid

Azure Event Grid je služba Eventing Service pro Cloud. Event Grid umožňuje vytvářet odběry událostí vyvolaných službami Azure nebo prostředky třetích stran.

Tento kurz je druhou částí série kurzů o službě Storage. Navazuje na předchozí kurz o službě Storage a přidává automatické vytváření miniatur bez serveru s využitím služeb Azure Event Grid a Azure Functions. Event Grid umožňuje službě Azure Functions reagovat na události služby Azure Blob Storage a vytvářet miniatury nahraných obrázků. K události vytvoření ve službě Blob Storage se vytvoří odběr události. Při přidání objektu blob do určitého kontejneru služby Blob Storage dojde k volání koncového bodu funkce. K přístupu k objektu blob se použití data předaná do vazby funkce ze služby Event Grid a vygeneruje se obrázek miniatury.

Funkce změny velikosti se do existující aplikace pro nahrávání obrázků přidává pomocí rozhraní Azure CLI a webu Azure Portal.

V tomto kurzu se naučíte:

Požadavky

Pro absolvování tohoto kurzu potřebujete:

• Potřebujete předplatné Azure. Tento kurz nefunguje s bezplatným předplatným.
• Nejdřív je potřeba dokončit předchozí kurz o službě Blob Storage: Odeslání dat obrázků do cloudu v Azure Storage.

Vytvoření účtu Azure Storage

Azure Functions vyžaduje obecný účet úložiště. Kromě účtu BLOB Storage, který jste vytvořili v předchozím kurzu, vytvořte ve skupině prostředků samostatný účet obecné úložiště. Názvy účtů úložiště musí mít délku 3 až 24 znaků a můžou obsahovat jenom číslice a malá písmena.

Nastavte proměnné tak, aby obsahovaly název skupiny prostředků, kterou jste vytvořili v předchozím kurzu, umístění pro prostředky, které se mají vytvořit, a název nového účtu úložiště, který Azure Functions vyžaduje. Pak vytvořte účet úložiště pro funkci Azure Functions.

Vytvoření aplikace funkcí

K hostování provádění funkcí potřebujete aplikaci Function App. Function App poskytuje prostředí pro provádění kódu funkce bez serveru.

V následujícím příkazu zadejte vlastní jedinečný název aplikace Function App. Název aplikace funkcí se použije jako výchozí doména DNS pro příslušnou aplikaci funkcí, a proto musí být název mezi všemi aplikacemi v Azure jedinečný.

Zadejte název aplikace Function App, která se má vytvořit, a pak vytvořte funkci Azure Functions.

Teď nakonfigurujte aplikaci Function App, aby se připojovala k účtu úložiště objektů blob, který jste vytvořili v předchozím kurzu.

Konfigurace aplikace Function App

Tato funkce vyžaduje pro účet úložiště objektů BLOB přihlašovací údaje, které se přidají do nastavení aplikace Function App pomocí příkazu AZ functionapp config appSettings set nebo 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"

Nastavení FUNCTIONS_EXTENSION_VERSION=~2 způsobí, že bude aplikace funkcí používat verzi 2.x modulu runtime služby Azure Functions.

Teď můžete nasadit do této aplikace Function App nasadit projekt projektu kódu funkce.

Nasazení kódu funkce

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

Funkce změny velikosti obrázků se aktivuje požadavky HTTP, které se do ní odesílají ze služby Event Grid. Službě Event Grid můžete sdělit, že chcete přijímat tato oznámení na adrese URL vaší funkce, vytvořením odběru událostí. Pro účely tohoto kurzu se přihlásíte k odběru událostí vytvářených objekty blob.

Data předávaná do funkce z oznámení služby Event Grid zahrnují adresu URL objektu blob. Tato adresa URL se pak předá do vstupní vazby za účelem získání nahraného obrázku ze služby Blob Storage. Funkce vygeneruje obrázek miniatury a zapíše výsledný datový proud do samostatného kontejneru ve službě Blob Storage.

Tento projekt používá aktivační události typu EventGridTrigger. Použití aktivační události Event Grid je vhodnější než obecné aktivační události HTTP. Event Grid automaticky ověřuje aktivační události funkcí Event Grid. U obecných aktivačních událostí HTTP je potřeba implementovat odpověď ověření.

Kód projektu funkce se nasadí přímo z veřejného úložiště ukázek. Další informace o možnostech nasazení pro Azure Functions najdete v článkuPrůběžné nasazování se službou Azure Functions.

Vytvoření odběru událostí

Odběr událostí udává, které události vygenerované zprostředkovatelem chcete odeslat do určitého koncového bodu. V tomto případě zveřejňuje koncový bod vaše funkce. Pomocí následujících kroků vytvořte na webu Azure Portal odběr událostí, který odesílá oznámení do vaší funkce:

1. V Azure Portalv horní části hledání stránky a vyberte Function App a zvolte aplikaci funkcí, kterou jste právě vytvořili. Vyberte funkce a zvolte funkci Miniatura .

   

2. Vyberte vybrat integraci a pak zvolte aktivační událost Event Grid a vyberte vytvořit Event Grid předplatné.

   

3. Použijte nastavení odběru událostí uvedená v tabulce.

   

   Nastavení	Navrhovaná hodnota	Popis
   Název	imageresizersub	Název identifikující nový odběr událostí.
   Typ tématu	Účty úložiště	Vyberte zprostředkovatele událostí Účty úložiště.
   Předplatné	Vaše předplatné Azure	Ve výchozím nastavení je vybrané vaše aktuální předplatné Azure.
   Skupina prostředků	myResourceGroup	Vyberte Použít existující a zvolte skupinu prostředků, které jste už používali v tomto kurzu.
   Prostředek	Váš účet služby Blob Storage	Vyberte účet služby Blob Storage, který jste vytvořili.
   Název systémového tématu	imagestoragesystopic	Zadejte název systémového tématu. Další informace o systémových tématech najdete v tématu Přehled systémových témat.
   Typy událostí	Vytvoření objektu blob	Zrušte zaškrtnutí všech typů komě Vytvoření objektu blob. Do funkce se předají jenom události typu Microsoft.Storage.BlobCreated.
   Typ koncového bodu	automaticky generovaný	Předdefinované jako Funkce Azure.
   Koncový bod	automaticky generovaný	Název funkce. V tomto případě je to Thumbnail.

4. Přepněte na kartu Filtry a proveďte následující akce:

   1. Vyberte možnost Povolit filtrování předmětu.

   2. Jako Předmět začíná na zadejte následující hodnotu: /blobServices/default/containers/images/.

      

5. Vyberte Vytvořit a přidejte odběr události. Tím se vytvoří odběr události, který aktivuje Thumbnail funkci při přidání objektu blob do images kontejneru. Funkce změní velikost obrázků a přidá je do thumbnails kontejneru.

Teď máte nakonfigurované back-endové služby a můžete funkci změny velikosti obrázků otestovat v ukázkové webové aplikaci.

Testování ukázkové aplikace

Pokud chcete ve webové aplikaci otestovat změnu velikosti obrázků, přejděte na adresu URL publikované aplikace. Výchozí adresa URL webové aplikace je https://<web_app>.azurewebsites.net.

Další kroky

V tomto kurzu jste se naučili:

Ve třetí části série kurzů o službě Storage se dozvíte, jak zabezpečit přístup k účtu úložiště.

• Další informace o službě Event Grid najdete v článku Úvod do služby Azure Event Grid.
• Pokud chcete vyzkoušet jiný kurz, který se týká služby Azure Functions, podívejte se na článek Vytvoření funkce pro integraci s Azure Logic Apps.