Úvod do Azure Functions

Azure Functions je způsob, jak vytvořit a spustit fragmenty kódu řízené událostmi – – funkce – – v cloudu, aniž by bylo nutné explicitně zřizovat nebo spravovat infrastrukturu. Další informace o službě Azure Functions najdete v Dokumentaci ke službě Azure Functions.

Požadavky

nástroje funkce Azure functions jsou součástí Visual Studio pro Mac 7,5 a novějších.

K vytváření a nasazování funkcí budete také potřebovat předplatné Azure. Pokud nemáte účet Azure, můžete si ho zdarma zaregistrovat a obdržet 12 měsíců bezplatné oblíbené služby, $200 bezplatný kredit a 25 + vždy bezplatných služeb – > https://azure.com/free .

Vytvoření prvního projektu Azure Functions

1. v Visual Studio pro Mac vyberte soubor > nové řešení.

2. v dialogovém okně nový Project v části cloudový > obecné vyberte šablonu Azure Functions a klikněte na další:

   

3. Vyberte šablonu počáteční Azure Functions, kterou chcete použít, zadejte název funkce a klikněte na Další.

   

   Tip

   I když jsou v sadě Azure Functions běhové prostředí a šablony (CLI) zachované jako dostupné, nevyhnutelně jsou zastaralé. při vytváření nového projektu functions Visual Studio pro Mac zkontroluje aktualizace rozhraní příkazového řádku a upozorní vás, jak je znázorněno na následujícím obrázku. Stačí kliknout na tlačítko a stáhnout aktualizované šablony.

   V závislosti na typu vybrané funkce vás na další stránce zobrazí výzva k zadání podrobností, jako jsou například přístupová práva, jak je znázorněno na následujícím obrázku:

   

   Další informace o různých typech šablon Azure Functions a vlastnostech vazby vyžadovaných ke konfiguraci jednotlivých šablon najdete v části Dostupné šablony funkcí . V tomto příkladu používáme Trigger http s přístupovými právy nastavenou na anonymní.

4. Po nastavení parametrů vyberte umístění projektu a klikněte na vytvořit.

Visual Studio pro Mac vytvoří projekt .NET Standard s zahrnutou výchozí funkcí. zahrnuje také NuGet odkazy na celou řadu balíčků AzureWebJobs a také balíček Newtonsoft. Json .

Nový projekt obsahuje následující soubory:

• vaše funkce-Name. cs – Tato třída obsahuje často používaný kód pro funkci, kterou jste vybrali. Obsahuje atribut Functions s názvem funkce a atribut triggeru, který určuje, co aktivuje funkci (např. požadavek HTTP). Další informace o metodě funkce najdete v článku referenční informace pro vývojáře v jazyce C# Azure Functions .
• Host. JSON – tento soubor popisuje globální možnosti konfigurace pro hostitele Functions. Ukázkový soubor a informace o dostupných nastaveních pro tento soubor najdete v referenčních informacích k souboru Host. JSON pro Azure Functions.
• Local. Settings. JSON – tento soubor obsahuje všechna nastavení pro spouštění funkcí místně. Tato nastavení používá Azure Functions Core Tools. Další informace najdete v tématu soubor místních nastavení v Azure Functions Core Tools článku.

teď, když jste vytvořili nový projekt Azure Functions v Visual Studio pro Mac, můžete otestovat výchozí funkci aktivovanou protokolem HTTP z místního počítače.

Místní testování funkce

díky podpoře Azure Functions v Visual Studio pro Mac můžete testovat a ladit funkci na místním počítači pro vývoj.

1. pokud chcete funkci místně otestovat, stiskněte tlačítko spustit v Visual Studio pro Mac:

   

2. Spuštěním projektu se spustí místní ladění funkce Azure Function a otevře se nové okno terminálu, jak je znázorněno na následujícím obrázku:

   

   Zkopírujte adresu URL z výstupu.

3. Vložte adresu URL pro požadavek HTTP do panelu adresy prohlížeče. Přidejte řetězec dotazu ?name=<yourname> na konec adresy URL a spusťte požadavek. Následující obrázek ukazuje odpověď v prohlížeči na místní požadavek GET vrácený funkcí:

   

Přidání další funkce do projektu

Šablony funkcí umožňují rychle vytvářet nové funkce s použitím nejběžnějších aktivačních událostí a šablon. Chcete-li vytvořit jiný typ funkce, postupujte takto:

1. Chcete-li přidat novou funkci, klikněte pravým tlačítkem myši na název projektu a vyberte přidat > přidat funkci...:

   

2. V dialogovém okně Nová funkce Azure vyberte požadovanou funkci:

   

   Seznam šablon Azure Functions najdete v části Dostupné šablony funkcí .

Výše uvedený postup můžete použít k přidání dalších funkcí do projektu Function App. Každá funkce v projektu může mít jinou aktivační událost, ale funkce musí mít právě jednu aktivační událost. Další informace najdete v tématu Azure Functions triggery a koncepty vazeb.

Publikování do Azure

1. Klikněte pravým tlačítkem na název projektu a vyberte publikovat > publikovat do Azure:

2. Pokud jste už účet Azure připojili k Visual Studio pro Mac zobrazí se seznam dostupných služeb App Services. Pokud jste se přihlásili, budete vyzváni k tomu.

3. V dialogovém okně publikovat do Azure App Service můžete buď vybrat existující službu App Service, nebo vytvořit novou, kliknutím na Nový.

4. V dialogovém okně vytvořit novou App Service zadejte nastavení:

   Nastavení	Popis
   Název služby App Service	Globálně jedinečný název, který identifikuje vaši novou aplikaci Function App.
   Předplatné	Předplatné Azure, které se má použít.
   Skupina prostředků	Název skupiny prostředků, ve které chcete vytvořit aplikaci funkcí. Vyberte + vytvořit novou skupinu prostředků.
   Plán služby	Vyberte existující plán nebo vytvořte vlastní plán. Vyberte umístění v oblasti poblíž nebo v blízkosti jiných služeb, ke kterým máte přístup.

5. Kliknutím na Další vytvořte účet úložiště. Modul runtime Functions vyžaduje účet úložiště Azure. Kliknutím na vlastní vytvořte účet úložiště pro obecné účely nebo použijte existující:

   

6. Kliknutím na Vytvořit vytvořte aplikaci funkce a související prostředky v Azure a nasaďte kód projektu funkce.

7. Můžete být vyzváni k zadání dialogového okna během publikování, které vás informují o verzi funkcí Update v Azure. Klikněte na Ano:

   

Nastavení aplikace funkcí

Všechna nastavení, která jste přidali v Local. Settings. JSON, se musí taky přidat do aplikace Function App v Azure. Tato nastavení nejsou nahrána automaticky při publikování projektu.

Přístup k nastavení aplikace získáte tak, že přejdete na Azure Portal na adrese https://ms.portal.azure.com/ . V části aplikace Functions vyberte aplikace Function App a zvýrazněte název vaší funkce:

Na kartě Přehled vyberte nastavení aplikace v části nakonfigurované funkce:

tady můžete nastavit Nastavení aplikace pro aplikaci function app, kde můžete přidat nová nastavení aplikace nebo upravit stávající:

Možná budete muset nastavit jedno důležité nastavení FUNCTIONS_EXTENSION_VERSION . při publikování z Visual Studio pro Mac by tato hodnota měla být nastavená na beta.

Dostupné šablony funkcí

• GitHub Trigger – reaguje na události, ke kterým dochází ve vašich GitHubch úložištích. Další informace najdete v článku o Azure Functions GitHub

  • GitHub – komentář – tato funkce se spustí, když obdrží GitHub webhook pro problém nebo žádost o přijetí změn a přidá komentář.
  • GitHub webhook – tato funkce se spustí, když přijme GitHub webhook.

• Http – aktivovat provádění kódu pomocí požadavku HTTP K dispozici jsou explicitní šablony pro následující aktivační události protokolu HTTP:

  • Aktivační událost http
  • Http získat CRUD
  • Http POST – Metoda CRUD
  • Aktivační událost http s parametry

• Timer – provede vyčištění nebo jiné úlohy Batch podle předdefinovaného plánu. Tato šablona má dvě pole: název a plán, což je šestý výraz CRON pole. Další informace najdete v článku o Azure Functions v čase .

• aktivační událost fronty – jedná se o funkci, která bude reagovat na zprávy, když dorazí do fronty Azure Storage. Kromě názvu funkce Tato šablona přebírá cestu (název fronty, ze které se bude číst zpráva) a připojení k účtu úložiště (název nastavení aplikace, které obsahuje připojovací řetězec účtu úložiště). Další informace najdete v Azure Functions článku o Queue Storage.

• Trigger objektu blob – proces Azure Storage objekty blob při přidání do kontejneru Kromě názvu funkce Tato šablona také přebírá cestu a vlastnost připojení. Vlastnost Path (cesta) je cesta v účtu úložiště, kterou bude aktivační událost monitorovat. Účet pro připojení je název nastavení aplikace, které obsahuje připojovací řetězec účtu úložiště. další informace najdete v článku Azure Functions Blob Storage.

• Obecný Webhook – jedná se o jednoduchou funkci, která se spustí pokaždé, když přijme žádost od libovolné služby, která podporuje Webhooky. Další informace najdete v článku o Azure Functions v tématu Obecné Webhooky.

• Orchestrace trvalých funkcí – Durable Functions umožňuje psát stavové funkce v prostředí bez serveru. Toto rozšíření za vás spravuje stav, kontrolní body a restartování. Další informace najdete v průvodci Azure Functions na trvalých funkcích.

• Změna velikosti obrázku – Tato funkce vytvoří obrázky se změněnou velikostí pokaždé, když se do kontejneru přidá objekt BLOB. Šablona používá cestu a připojovací řetězec pro aktivační událost, malý výstup obrázku a střední výstup obrázku.

• token sas – tato funkce generuje token sas pro daný Azure Storage kontejner a název objektu blob. Kromě názvu funkce Tato šablona také přebírá cestu a vlastnost připojení. Vlastnost Path (cesta) je cesta v účtu úložiště, kterou bude aktivační událost monitorovat. Účet pro připojení je název nastavení aplikace, které obsahuje připojovací řetězec účtu úložiště. Je také potřeba nastavit přístupová práva . Úroveň autorizace řídí, jestli funkce vyžaduje klíč rozhraní API a který klíč se má použít; Funkce používá klíč funkce. Správce používá přístupový klíč účtu. Další informace najdete v tématu funkce C# Azure pro vygenerování UKÁZEK SAS tokenů .