Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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:
- A rendszerképet helyileg vagy távolról hozza létre, vagy felhasználja a konfigurált, előre összeállított rendszerképet.
- Közzéteszi a lemezképet a projekthez konfigurált ACR-példányba, amikor közzétételre van szükség.
- Frissíti a Function Appot
linuxFxVersionértékrőlDOCKER|<image>értékre. - 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 |