Függvény létrehozása és közzététele az Azure-ban a Java és a Gradle használatával

Ez a cikk bemutatja, hogyan hozhat létre és tehet közzé Java-függvényprojekteket az Azure Functionsben a Gradle parancssori eszközzel. Ha elkészült, a függvénykód egy kiszolgáló nélküli üzemeltetési csomagban fut az Azure-ban, és egy HTTP-kérés aktiválja.

Megjegyzés

Ha nem a Gradle az előnyben részesített fejlesztési eszköz, tekintse meg a Maven, az IntelliJ IDEA és a VS Code használatát használó Java-fejlesztőknek készült hasonló oktatóanyagokat.

Előfeltételek

Ha függvényeket szeretne fejleszteni a Java használatával, akkor a számítógépre a következőket kell telepíteni:

Aktív Azure-előfizetésre is szüksége van. Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.

Fontos

A rövid útmutató befejezéséhez a JAVA_HOME környezeti változót a JDK telepítési helyére kell beállítani.

Functions-projekt előkészítése

A mintaprojekt klónozásához használja a következő parancsot:

git clone https://github.com/Azure-Samples/azure-functions-samples-java.git
cd azure-functions-samples-java/triggers-bindings

Nyissa meg build.gradle és módosítsa a appName következő szakaszban szereplő nevet egy egyedi névre, hogy elkerülje a tartománynév ütközését az Azure-ban való üzembe helyezéskor.

azurefunctions {
    resourceGroup = 'java-functions-group'
    appName = 'azure-functions-sample-demo'
    pricingTier = 'Consumption'
    region = 'westus'
    runtime {
      os = 'windows'
    }
    localDebug = "transport=dt_socket,server=y,suspend=n,address=5005"
}

Nyissa meg az új Function.java fájlt az src/main/java elérési útról egy szövegszerkesztőben, és tekintse át a létrehozott kódot. Ez a kód egy HTTP által aktivált függvény, amely a kérés törzsét visszhangozza.

Futtassa helyben a függvényt

Futtassa a következő parancsot a függvényprojekt lefordításához, majd futtatásához:

gradle jar --info
gradle azureFunctionsRun

A projekt helyi futtatásakor az Alábbihoz hasonló kimenet jelenik meg az Azure Functions Core Toolsban:

...

Now listening on: http://0.0.0.0:7071
Application started. Press Ctrl+C to shut down.

Http Functions:

    HttpExample: [GET,POST] http://localhost:7071/api/HttpExample
...

Aktiválja a függvényt a parancssorból az alábbi cURL paranccsal egy új terminálablakban:

curl -w "\n" http://localhost:7071/api/HttpExample --data AzureFunctions

A várt kimenet a következő:

Hello, AzureFunctions

Megjegyzés

Ha az authLevel értéke FUNCTION vagy ADMIN, akkor helyi futtatáskor nincs szükség az hozzáférési kulcsra.

A Ctrl+C billentyűparanccsal állítsa le a függvénykódot a terminálablakban.

A függvény üzembe helyezése az Azure-ban

A függvényalkalmazás és a kapcsolódó erőforrások az Azure-ban jönnek létre a függvényalkalmazás első üzembe helyezésekor. Az üzembe helyezés előtt az az login Azure CLI paranccsal jelentkezzen be az Azure-előfizetésbe.

az login

Tipp

Ha a fiókja több előfizetéshez is hozzáfér, a az account set paranccsal állítsa be az alapértelmezett előfizetést ebben a munkamenetben.

A következő paranccsal helyezze üzembe a projektet egy új függvényalkalmazásban.

gradle azureFunctionsDeploy

Ez a build.gradle fájl értékei alapján hozza létre a következő erőforrásokat az Azure-ban:

  • Erőforráscsoport. Az Ön által megadott resourceGroup névvel ellátva.
  • Storage-fiók. A függvények által megkövetelt. A rendszer véletlenszerűen hozza létre a nevet a Tárfiók nevének követelményei alapján.
  • App Service-csomag. Kiszolgáló nélküli használatalapú csomag üzemeltetése a függvényalkalmazáshoz a megadott régióban. A név véletlenszerűen jön létre.
  • Függvényalkalmazás. A függvényalkalmazás a függvények üzembe helyezési és végrehajtási egysége. A név az Ön appName neve, kiegészítve egy véletlenszerűen generált számmal.

A telepítés a projektfájlokat is csomagolja, és ZIP telepítés segítségével telepíti azokat az új funkcióalkalmazásba, a run-from-package mód bekapcsolva.

A mintaprojektben a HTTP-trigger authLevel értéke ANONYMOUS, ami kihagyja a hitelesítést. Ha azonban a FUNCTION vagy a ADMIN értékhez hasonló más authLevelt használ, be kell szereznie a függvénykulcsot, hogy HTTP-n keresztül meghívhassa a függvényvégpontot. A függvénykulcs lekérésének legegyszerűbb módja az Azure Portal.

A HTTP-eseményindító URL-címének lekérése

A függvény aktiválásához szükséges URL-címet a függvénykulcs használatával az Azure Portalról szerezheti be.

  1. Keresse meg az Azure Portalt, jelentkezzen be, írja be a függvényalkalmazás alkalmazásnevét a Lap tetején található Keresés mezőbe, és nyomja le az Enter billentyűt.

  2. A függvényalkalmazásban válassza a Függvények lehetőséget, válassza ki a függvényt, majd kattintson a függvény URL-címének lekérése parancsra a jobb felső sarokban.

    A függvény URL-címének másolása az Azure portálról

  3. Válassza az alapértelmezett (függvénykulcs) lehetőséget, és válassza a Másolás lehetőséget.

Mostantól használhatja a másolt URL-címet a függvény eléréséhez.

A függvény ellenőrzése az Azure-ban

Az Azure-ban cURLfutó függvényalkalmazás ellenőrzéséhez cserélje le az alábbi minta URL-címét a portálról másolt URL-címre.

curl -w "\n" http://azure-functions-sample-demo.azurewebsites.net/api/HttpExample --data AzureFunctions

Ez egy POST-kérést küld a függvényvégpontra, a kérés törzsében a(z) AzureFunctions elemmel. A következő válasz jelenik meg.

Hello, AzureFunctions

Következő lépések

Létrehozott egy Java-függvényprojektet egy HTTP által aktivált függvénnyel, futtatta a helyi gépen, és üzembe helyezte az Azure-ban. Most egészítse ki a függvényt a következők szerint...

Azure Storage-üzenetsor kimeneti kötésének hozzáadása

  • Last updated on