Üzembe helyezés Azure Functionsbe az Azure fejlesztői parancssori felülettel

Azure fejlesztői parancssori felület (azd) támogatja a kód- és tárolótelepítéseket a Azure Functions. Használja a dedikált function gazdagépet azure.yaml mindkét módban:

  • A kód üzembe helyezése zip-archívumként csomagolja be a lefordított függvénykódot, és feltölti a függvényalkalmazásba.
  • A tárolótelepítés létrehoz vagy felold egy konténerképet, szükség esetén közzéteszi azt az Azure Container Registryben (ACR), és frissíti a Function Appot a rendszerkép futtatásához.

Az Azure Functions és az Azure App Service egyaránt a Microsoft.Web/sites erőforrás-szolgáltatót használják, és a tárolóüzembehelyezési folyamataik bizonyos belső működési mechanizmusokban osztoznak. Ezek azonban nem ugyanaz a azd gazdagép. A Functions függvényspecifikus csomagolást és távoli buildelési viselkedést használ host: function, és nem használja az App Service üzembehelyezési pontok munkafolyamatát.

Válasszon telepítési módot

azd a szolgáltatáskonfigurációból választja ki az üzembe helyezési módot:

Configuration Üzembehelyezési mód
forrás language, támogatott, nem Dockeres project használatával és nincs docker.path Kód üzembe helyezése
language: docker Tárolók üzembe helyezése
Egy forrásnyelvvel rendelkező docker.path érték Tárolók üzembe helyezése
Előre összeállított image Tárolók üzembe helyezése

A kiépített függvényalkalmazásnak ugyanazt a módot kell használnia, mint a szolgáltatáskonfiguráció. Ha a függvényalkalmazás tárolókhoz van konfigurálva, de azure.yaml a kód üzembe helyezését választja, vagy fordítva, akkor azd deploy a feltöltés előtt leáll, és jelenti az eltérést.

Függvénykód üzembe helyezése

Kódalapú függvényszolgáltatás konfigurálása egy forrásprojekttel, egy támogatott nyelvvel és host: function:

services:
  api:
    project: ./src/api
    language: ts
    host: function

A(z) azd során azd deploy létrehozza a projektet, alkalmazza a(z) .funcignore kizárásokat, zip-archívumot hoz létre, és feltölti a csomagot az Azure Functions üzembehelyezési API-ján keresztül.

A Bicepnek vagy a Terraformnak létre kell hoznia egy kódalapú függvényalkalmazást, és meg kell címkéznie azd-service-name címkével, amelynek értéke a szolgáltatás neve, kivéve, ha az erőforrást a(z) azure.yaml elemben a(z) resourceName használatával azonosítja. Konfigurálja az üzemeltetési tervet, a futtatókörnyezetet, a tárolást, az identitásokat, a hálózatkezelést és az alkalmazásbeállításokat infrastruktúra mint kód segítségével.

Távoli buildelés beállítása kód üzembe helyezéséhez

A legfelső szintű szolgáltatás tulajdonsága remoteBuild csak a Flex Consumption-csomag kódalapú függvényalkalmazásaira vonatkozik. Azt szabályozza, hogy Azure Functions az Oryx használatával hozza-e létre a feltöltött csomagot:

services:
  api:
    project: ./src/api
    language: python
    host: function
    remoteBuild: true

Ha Flex Consumption esetén kihagyja a(z) remoteBuild elemet, a(z) azd a nyelv és a csomag tartalma alapján kiválaszt egy alapértelmezett beállítást:

Nyelv Alapértelmezett viselkedés
JavaScript vagy TypeScript Távoli buildet használ, ha .funcignore kizárja node_modules, vagy ha nincs .funcignore fájl. Ellenkező esetben a helyileg összeállított csomagot használja.
Python Távoli build használata.
Go Helyben fordul. A Go Function Apps nem támogatják a távoli buildelést.
Egyéb támogatott nyelvek A helyileg összeállított csomagot használja.

JavaScript és TypeScript esetén a kifejezetten konfigurált remoteBuild értéknek meg kell egyeznie a .funcignore értékkel, ha az a fájl létezik. Állítsa be a(z) remoteBuild: true elemet, ha .funcignore kizárja a(z) node_modules elemet. Állítsa be remoteBuild: false ha .funcignore tartalmazza node_modules elemet a csomagban.

Ne állítsa be a nem Flex-csomagok legfelső szintű remoteBuild tulajdonságát. Ha engedélyezni szeretne egy Oryx-buildet egy másik támogatott csomagban, konfigurálja a(z) SCM_DO_BUILD_DURING_DEPLOYMENT=true és ENABLE_ORYX_BUILD=true elemet függvényalkalmazás-beállításként az infrastruktúrában.

Tárolóalapú függvény üzembe helyezése

Dockerfile-nal rendelkező forrásprojekt esetén állítsa be language: dockervagy tartsa meg a forrásnyelvet, és adja meg docker.path.

Az alábbi példa Egy Dockerfile-fájllal rendelkező TypeScript-projektet használ:

services:
  api:
    project: ./src/api
    language: ts
    host: function
    docker:
      path: ./Dockerfile

Egy előre összeállított rendszerképet helyi projekt nélkül is üzembe helyezhet:

services:
  api:
    host: function
    image: myregistry.azurecr.io/functions/api:1.0

Előre összeállított rendszerkép esetén hagyja ki language vagy állítsa be a következőre docker: . Ne kombinálja a(z) image elemet a(z) project elemmel.

Tároló üzembe helyezése során azd:

  1. A rendszerképet helyileg vagy távolról hozza létre, vagy felhasználja a konfigurált, előre összeállított rendszerképet.
  2. Közzéteszi a lemezképet a projekthez konfigurált ACR-példányba, amikor közzétételre van szükség.
  3. Frissíti a Function Appot linuxFxVersion értékről DOCKER|<image> értékre.
  4. A fő Function App-helyre telepít.

A legfelső szintű szolgáltatás tulajdonsága remoteBuild nem vonatkozik a tárolókra. Tárolórendszerkép ACR-feladatokkal való létrehozásához használja a következőt docker.remoteBuild:

services:
  api:
    project: ./src/api
    language: docker
    host: function
    docker:
      path: ./Dockerfile
      remoteBuild: true

Tárolóra kész függvényalkalmazás létrehozása

azd deploy frissíti a rendszerkép-hivatkozást, de nem konvertál kódalapú függvényalkalmazást tárolóalapú függvényalkalmazássá. Az infrastruktúrának a telepítés előtt ki kell építenie egy kompatibilis webhelyet.

Requirement Details
Linux Function App Linux-függvényalkalmazás kiépítése egy Azure Functions Prémium vagy Dedikált (App Service) csomagon. A Flex Consumption nem támogatja az egyéni konténereket. Ez a host: function munkafolyamat a(z) Microsoft.Web/sites-t célozza, nem az Azure Container Appsben üzemeltetett Azure Functions szolgáltatást.
Konténerhely konfigurációja Állítsa be a webhelytípust úgy, hogy tartalmazza a következőket: functionapp, linux, és container. Inicializálja a(z) linuxFxVersion elemet egy DOCKER\|<image> értékkel. A helyőrző kép azért elegendő, mert azd deploy helyettesíti.
Konténer-regisztráció Forrásbuildekhez hozzon létre egy ACR-példányt, és tegye közzé a bejelentkezési kiszolgálóját az AZURE_CONTAINER_REGISTRY_ENDPOINT infrastruktúra kimenetén keresztül, vagy konfigurálja a(z) docker.registry elemet a szolgáltatáshoz. A teljes körűen minősített előre elkészített image közvetlenül, külön közzétételi regisztrációs adatbázis nélkül is használható.
Nyilvántartási hozzáférés Adjon a rendszerképet közzétevő identitásnak jogosultságot arra, hogy szükség esetén közzétételkor feltöltse azt a célregisztrációs adatbázisba. Külön konfigurálja a Function Appot az üzembe helyezett rendszerkép lekérésére. Privát ACR-rendszerképek esetén engedélyezze a függvényalkalmazás felügyelt identitása számára a lekérési hozzáférést, és konfigurálja a webhelyet a felügyelt identitás hitelesítő adatainak használatára. Egy másik privát regisztrációs adatbázis esetében konfigurálja a megfelelő pull hitelesítő adatokat az infrastruktúrában.
Függvénybeállítások Konfigurálja a szükséges beállításokat, például a FUNCTIONS_EXTENSION_VERSION, AzureWebJobsStorage és FUNCTIONS_WORKER_RUNTIME beállításokat Bicep vagy Terraform használatával.
Erőforrás-felderítés Alkalmazzon egy azd-service-name címkét, amelynek értéke megegyezik a azure.yaml szolgáltatásnévvel, vagy állítsa be kifejezetten az resourceName értéket.

A function szolgáltatásszintű beállítások nem támogatottak a env gazdagéphez. Ehelyett függvényalkalmazás-beállításokat határozhat meg az infrastruktúrában.

Az üzembehelyezési tárolóhelyek ismertetése

azd mindig üzembe helyez egy function szolgáltatást a fő Function App-webhelyen. Nem észleli a Function App-foglalatokat, nem kér rájuk, és nem helyezi üzembe őket. Az App Service-foglalat beállításai, például AZD_DEPLOY_{SERVICE}_SLOT_NAME nem befolyásolják egy Function App üzembe helyezését.

Ha üzembehelyezési ponton alapuló Functions kiadási folyamatra van szüksége, kezelje az üzembehelyezési pontot és az üzembe helyezést a beépített host: function munkafolyamaton kívül.

Függvények és App Service-gazdagépek összehasonlítása

A Functions és az App Service azonos Microsoft.Web/sites erőforrástípust használ, de válassza ki a számítási feladatnak megfelelő gazdagépet:

Behavior function gazdagép appservice gazdagép
Workload Eseményvezérelt Azure Functions Webalkalmazások és API-k
Kód üzembe helyezése Az Azure Functions zip-alapú üzembehelyezési folyamatát használja Az App Service üzembehelyezési folyamatát használja
Tárolók üzembe helyezése Frissíti a Function App rendszerképét, miután ellenőrizte, hogy a webhely tárolóalapú-e Frissíti a Web App image-ét, miután ellenőrizte, hogy a webhely tárolóra kész-e
Távoli kódbuild Támogatja a Flex Consumption Function Apps szolgáltatásszintű remoteBuild lehetőséget Nem használja a „Függvények” remoteBuild lehetőséget
Üzembehelyezési pontok Mindig üzembe helyezi a fő webhelyre Támogatja az azd App Service-slot munkafolyamatát
Szolgáltatásszint env Nem támogatott; használja a Function App beállításait az infrastruktúrában Alkalmazásbeállítások konfigurálása az infrastruktúrában