Cvičení – nasazení funkce do Azure

  • 6 min

Teď, když jste se naučili vytvářet a nasazovat funkce do Azure, je čas teorii začlenit do praxe.

V tomto cvičení se dozvíte, jak nakonfigurovat funkci pro nasazení do Azure Functions. Pak pomocí Mavenu nasadíte funkci a otestujete ji v cloudu.

Konfigurace projektu funkce pro nasazení

Před nasazením do Azure je potřeba v aplikaci funkcí provést několik změn. Následující kroky vás provedou aktualizací projektu pro nasazení.

  1. Určete oblast pro sandboxovou skupinu prostředků:

    1. Název skupiny prostředků, která se pro vás automaticky vytvořila při aktivaci sandboxu, použijte k načtení oblasti, ve které se skupina prostředků nachází:

      az group show --name "<rgn>[sandbox resource group name]</rgn>" | jq -r '.location'

    2. Zkopírujte název oblasti, která se zobrazí pro použití v následujícím postupu.

  2. Upravením souboru pom.xml aktualizujte nastavení:

    1. V Azure Cloud Shellu přejděte do kořenové složky vaší aplikace. Příklad:

      cd ~/event-reporting

    2. Otevřete soubor pom.xml v editoru kódu Cloud Shellu.

      code pom.xml

    3. Vyhledejte následující ID artefaktu:

      <artifactId>azure-functions-maven-plugin</artifactId>

    4. V následujícím oddílu <configuration> vyhledejte element <resourceGroup> a aktualizujte ho názvem vaší skupiny prostředků. Příklad:

      <resourceGroup><rgn>[sandbox resource group name]</rgn></resourceGroup>

    5. Vyhledejte element <region> a aktualizujte ho názvem oblasti, kde se nachází vaše skupina prostředků. Příklad:

      <region>westus</region>

    6. Stiskněte kombinaci kláves CTRL+S a uložte soubor pom.xml. Potom stisknutím kombinace kláves CTRL+Q zavřete editor kódu.

Nasazení funkce služby Azure Functions

Teď, když je vaše funkce nakonfigurovaná pro nasazení, je dalším krokem jeho nasazení do Azure Functions.

  1. V Azure Cloud Shellu přejděte do kořenové složky vaší aplikace. Příklad:

    cd ~/event-reporting

  2. K sestavení funkce a jejímu nasazení do Azure Functions použijte následující příkaz:

    mvn clean package azure-functions:deploy

    Maven zobrazí spuštěný stav nasazení. Příklad:

    [INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Azure Java Functions 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- azure-functions-maven-plugin:1.4.1:deploy (default-cli) @ event-reporting ---
[INFO] Auth Type : AZURE_CLI
[INFO] Subscription : Concierge Subscription(12345678-1234-1234-1234-123456789abc)
[INFO] The specified function app does not exist. Creating a new function app...
[INFO] Set function worker runtime to java.
[INFO] Successfully created the function app: event-reporting-20240125192009873.
[INFO] Trying to deploy the function app...
[INFO] Trying to deploy artifact to event-reporting-20240125192009873...
[INFO] Successfully deployed the artifact to https://event-reporting-20240125192009873.azurewebsites.net
[INFO] Deployment done, you may access your resource through event-reporting-20240125192009873.azurewebsites.net
[INFO] Syncing triggers and fetching function information
[INFO] Querying triggers...
[INFO] HTTP Trigger Urls:
[INFO]   HttpExample : https://event-reporting-20240125192009873.azurewebsites.net/api/httpexample
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:01 min
[INFO] Finished at: 2024-01-25T20:12:04Z
[INFO] ------------------------------------------------------------------------

Načtení adresy URL funkce služby Azure Functions pomocí portálu

Vzpomeňte si, že ve cvičení, které jste dokončili v předchozí lekci, jste museli vytvořit adresu URL k otestování funkce ve webovém prohlížeči. Existuje ale jednodušší metoda načtení adresy URL pro funkci Azure Functions pomocí webu Azure Portal. K tomu poslouží následující postup.

  1. Pomocí stejného účtu, kterým jste aktivovali sandbox, se přihlaste na Azure Portal.

  2. V nabídce vlevo vyberte Všechny prostředky.

  3. Ze seznamu prostředků vyberte svou aplikaci funkcí. v tomto cvičení začíná názvem aplikace funkcí generování sestav událostí. Příklad:

    event-reporting-20240125192009873

    Tento function app název je stejný, který byl hlášen v odpovědi nasazení dříve v tomto cvičení.

  4. Na stránce Přehled aplikace funkcí vyberte na kartě Funkce funkci HttpExample. Zobrazí se stránka Přehled funkce.

  5. V horní části stránky funkce vyberte Získat adresu URL funkce. Zkopírujte plně sestavenou adresu URL vaší funkce. Příklad:

    https://event-reporting-20240125192009873.azurewebsites.net/api/HttpExample

    Tuto adresu URL použijete v další části tohoto cvičení.

Otestování funkce služby Azure Functions na portálu

Teď, když jste funkci nasadili do Azure, je vše, co je potřeba k otestování funkce ve webovém prohlížeči, připojit řetězec dotazu na konec adresy URL, jak jste to udělali v předchozích cvičeních.

  1. Vytvořte adresu URL pro rozhraní API vaší funkce:

    1. Načtěte adresu URL, kterou jste zkopírovali v předchozí části tohoto cvičení (Načtení adresy URL funkce služby Azure Functions pomocí portálu), například:

      https://event-reporting-20240125192009873.azurewebsites.net/api/HttpExample

    2. Připojte řetězec dotazu, který předá název adrese URL rozhraní API, například:

      https://event-reporting-20240125192009873.azurewebsites.net/api/HttpExample?name=Bob

    3. Tuto plně vytvořenou adresu URL si zkopírujte. Budete ji používat v následujících krocích.

  2. Ve webovém prohlížeči otevřete novou kartu a do pole adresy vložte plně vytvořenou adresu URL z předchozích kroků.

  3. Když webovému prohlížeči dáte pokyn, aby požádal o adresu URL, zobrazí se zpráva ve formátu prostého textu vrácená do webového prohlížeče, která je přizpůsobena názvu, který jste předali v řetězci dotazu. Příklad:

    Hello, Bob

Blahopřejeme, úspěšně jste nasadili a otestovali funkci v Azure!