Azure Functions – folyamatos üzembe helyezés

Az Azure Functions használatával folyamatosan üzembe helyezheti a kódot a forráskövetési integrációval. A forrásvezérlési integráció lehetővé teszi a munkafolyamatot, amelyben egy kódfrissítés aktiválja a buildelést, a csomagolást és az üzembe helyezést a projektből az Azure-ba.

A folyamatos üzembe helyezés jó választás olyan projektekhez, ahol több és gyakori közreműködést is integrálhat. Ha folyamatos üzembe helyezést használ, egyetlen igazságforrást tart fenn a kódhoz, amely lehetővé teszi a csapatok számára a könnyű együttműködést.

A cikk lépései bemutatják, hogyan konfigurálhat folyamatos kódtelepítéseket az Azure-beli függvényalkalmazásban az Azure Portal Üzembe helyezési központjának használatával. A folyamatos integrációt az Azure CLI használatával is konfigurálhatja.

A Functions ezeket a forrásokat támogatja az alkalmazás folyamatos üzembe helyezéséhez:

Azure-adattárak

A projektkód karbantartása az Azure Reposban, az Azure DevOps egyik szolgáltatásában. A Git és a Team Foundation verziókövetését is támogatja. Az Azure Pipelines buildszolgáltatónál használatos). További információ: Mi az Azure-adattár?

GitHub

A projektkód karbantartása a GitHubon. Az összes buildszolgáltató támogatja. További információ: GitHub-dokumentumok.

A GitHub az egyetlen folyamatos üzembehelyezési forrás, amelyet a Linuxon futó alkalmazások támogatnak egy használatalapú csomagban, amely kiszolgáló nélküli Python-alkalmazásokat is tartalmaz.

Bitbucket

A projektkód karbantartása a Bitbucketben. Az App Service buildszolgáltatóját igényli.

Helyi Git

Tartsa karban a projektkódot egy dedikált Git-kiszolgálón, amely ugyanabban az App Service-csomagban fut a függvényalkalmazással. Az App Service buildszolgáltatóját igényli. További információ: Helyi Git-üzembe helyezés Azure-alkalmazás szolgáltatásban.

A függvényalkalmazást külső Git-adattárhoz is csatlakoztathatja, de ehhez manuális szinkronizálásra van szükség. Az üzembe helyezési lehetőségekről további információt az Azure Functions üzembehelyezési technológiáiban talál.

Feljegyzés

A cikkben tárgyalt folyamatos üzembe helyezési lehetőségek kizárólag kódalapú üzemelő példányokra vonatkoznak. A tárolóalapú függvényalkalmazások üzembe helyezéséről lásd: Tárolók folyamatos üzembe helyezésének engedélyezése az Azure-ban.

Követelmények

A folyamatos üzembe helyezés sikerességéhez a címtárstruktúrának kompatibilisnek kell lennie az Azure Functions által elvárt alapszintű mappastruktúrával.

Egy adott függvényalkalmazás összes függvényének kódja egy gazdagépkonfigurációs fájlt tartalmazó gyökérprojekt-mappában található. A host.json fájl futásidejű konfigurációkat tartalmaz, és a függvényalkalmazás gyökérmappájában található. A bin mappa a függvényalkalmazás által igényelt csomagokat és egyéb kódtárfájlokat tartalmazza. A függvényalkalmazás által megkövetelt mappastruktúrák a nyelvtől függnek:

• C#
• Java
• JavaScript
• TypeScript
• PowerShell
• Python

A függvényalkalmazás minden függvényének ugyanazt a nyelvi vermet kell tartalmaznia.

Szolgáltatók létrehozása

A kódprojekt létrehozása az üzembe helyezési folyamat része. Az adott összeállítási folyamat az adott nyelvi veremtől, operációs rendszertől és üzemeltetési tervtől függ. A buildek helyileg vagy távolról is elvégezhetők, az adott üzemeltetéstől függően. További információ: Távoli build.

A Functions az alábbi buildszolgáltatókat támogatja:

Azure Pipelines

Az Azure Pipelines az Azure DevOps egyik szolgáltatása, és az Azure Repos-projektek alapértelmezett buildszolgáltatója. A Pipelines használatával projekteket is készíthet a GitHubról. A Pipelinesban van egy AzureFunctionApp feladat, amelyet kifejezetten az Azure Functionsben való üzembe helyezéshez terveztek. Ezzel a feladattal szabályozhatja a projekt felépítését, csomagolását és üzembe helyezését.

GitHub Actions

A GitHub Actions a GitHub-projektek alapértelmezett buildszolgáltatója. A GitHub Actions segítségével szabályozhatja a projekt felépítését, csomagolását és üzembe helyezését.

App Service (Kudu) szolgáltatás

Az App Service platform natív üzembehelyezési szolgáltatást (Project Kudu) tart fenn, amely támogatja a helyi Git-üzembe helyezést, egyes tárolótelepítéseket és más, a Pipelines vagy a GitHub Actions által nem támogatott központi telepítési forrásokat. A távoli buildelési, csomagolási és egyéb karbantartási feladatokat az alkalmazásnak dedikált altartományban scm.azurewebsites.net hajtja végre, például https://myfunctionapp.scm.azurewebsites.net. Ez a buildelési szolgáltatás csak akkor használható, ha a scm hely az üzembe helyezéssel elérhető. Számos közzétételi eszközhöz alapszintű hitelesítés szükséges a scm végponthoz való csatlakozáshoz. További információ: Az alapszintű hitelesítés engedélyezése az üzemelő példányokhoz.

Ez a buildszolgáltató akkor használatos, ha a kódprojektet a Visual Studio, a Visual Studio Code vagy az Azure Functions Core Tools használatával telepíti. Ha még nem telepítette ezeket az eszközöket, lehetséges, hogy engedélyeznie kell az alapszintű hitelesítést az SCM-végponton.

A buildszolgáltatók közül melyiket használhatja, az adott kódterjesztési forrástól függ.

Üzembehelyezési központ

Az Azure Portal egy üzembehelyezési központot biztosít a függvényalkalmazások számára, amely megkönnyíti a folyamatos üzembe helyezés konfigurálását. A folyamatos üzembe helyezés konfigurálásának módja attól függ, hogy melyik forrásvezérlőben található a kód, és hogy melyik buildszolgáltatót választja.

Az Azure Portalon keresse meg a függvényalkalmazás lapját, és válassza az Üzembe helyezési központ lehetőséget a bal oldali panelEn az Üzembe helyezés csoportban.

Válassza ki azt a forrásadattártípust , amelynél a projektkód karbantartása folyamatban van a támogatott lehetőségek közül:

Azure-adattárak

Az Azure Pipelinest használó Azure-adattárak üzembe helyezései az Azure DevOps portálon vannak definiálva, és nem a függvényalkalmazásból. A pipelines-alapú üzembe helyezés Azure-adattárakból való létrehozásának részletes útmutatója: Folyamatos teljesítés az Azure Pipelines szolgáltatással.

GitHub

Az Azure Pipelinest használó GitHub-üzemelő példányok az Azure DevOps portálon vannak definiálva, és nem a függvényalkalmazásból. A Pipelines-alapú üzembe helyezés GitHubról történő létrehozásáról részletes útmutatót az Azure Pipelines folyamatos teljesítés című témakörben talál.

Bitbucket

A Bitbucketből az Azure Pipelines használatával nem telepíthet. Ehelyett válassza ki az App Service buildszolgáltatóját.

Helyi Git

Az Azure Pipelines használatával nem telepíthet helyi gitből. Ehelyett válassza ki az App Service buildszolgáltatóját.

Azure-adattárak

A GitHub Actions használatával nem telepíthet azure-adattárakból. Válasszon másik buildszolgáltatót.

GitHub

GitHub Actions-munkafolyamat hozzáadása meglévő függvényalkalmazáshoz:

1. Lépjen a függvényalkalmazásra az Azure Portalon, és válassza az Üzembe helyezési központ lehetőséget.

2. Forráskéntválassza a GitHubot. Ha nem jelenik meg az alapértelmezett üzenet a GitHub Actions használatával, válassza a Szolgáltató módosítása lehetőséget, válassza a GitHub Actions lehetőséget, és válassza az OK gombot.

3. Ha még nem engedélyezte a GitHub-hozzáférést, válassza az Engedélyezés lehetőséget. Adja meg a GitHub hitelesítő adatait, és válassza a Bejelentkezés lehetőséget. Egy másik GitHub-fiók engedélyezéséhez válassza a Fiók módosítása lehetőséget, és jelentkezzen be egy másik fiókkal.

4. Válassza ki a GitHub-szervezetet, az adattárat és az ágat. A GitHub Actions használatával történő üzembe helyezéshez írási hozzáféréssel kell rendelkeznie ehhez az adattárhoz.

5. A hitelesítési beállításokban adja meg, hogy a GitHub Actions hitelesítése felhasználó által hozzárendelt identitással vagy egyszerű hitelesítési hitelesítő adatokkal történjen. Az alapszintű hitelesítéshez a rendszer az aktuális hitelesítő adatokat használja.

6. Válassza az Előnézet fájl lehetőséget a GitHub-adattárhoz hozzáadott munkafolyamat-fájl megtekintéséhez.github/workflows/

7. A Mentés gombra kattintva hozzáadhatja a munkafolyamat-fájlt az adattárhoz.

Ha többet szeretne megtudni a GitHub Action üzembe helyezéséről, beleértve a munkafolyamat konfigurációs fájljának létrehozásának egyéb módjait, tekintse meg a Folyamatos teljesítés a GitHub Actions használatával című témakört.

Bitbucket

A GitHub Actions használatával nem telepíthet a Bitbucketből. Ehelyett válassza ki az App Service buildszolgáltatóját.

Helyi Git

A GitHub Actions használatával nem helyezheti üzembe a helyi gitből. Ehelyett válassza ki az App Service buildszolgáltatóját.

Azure-adattárak

1. Lépjen a függvényalkalmazásra az Azure Portalon, és válassza az Üzembe helyezési központ lehetőséget.

2. Forrásként válassza az Azure-adattárak lehetőséget. Ha az App Service buildszolgáltatója nem az alapértelmezett, válassza a Szolgáltató módosítása lehetőséget, válassza az App Service buildszolgáltatást , és válassza az OK gombot.

3. Válassza ki a Szervezet, a Projekt, az Adattár és az Ág értékeit. Csak az Azure-fiókhoz tartozó szervezetek jelennek meg.

4. Válassza a Mentés lehetőséget a webhook létrehozásához az adattárban.

GitHub

1. Lépjen a függvényalkalmazásra az Azure Portalon, és válassza az Üzembe helyezési központ lehetőséget.

2. Forráskéntválassza a GitHubot. Ha az App Service buildszolgáltatója nem az alapértelmezett, válassza a Szolgáltató módosítása lehetőséget, válassza az App Service buildszolgáltatást , és válassza az OK gombot.

3. Ha még nem engedélyezte a GitHub-hozzáférést, válassza az Engedélyezés lehetőséget. Adja meg a GitHub hitelesítő adatait, és válassza a Bejelentkezés lehetőséget. Ha másik GitHub-fiókot kell engedélyeznie, válassza a Fiók módosítása lehetőséget, és jelentkezzen be egy másik fiókkal.

4. Válassza ki a Szervezet, az Adattár és az Ág értékeit. Az értékek a kód helyétől függenek.

5. Tekintse át az összes részletet, és válassza a Mentés lehetőséget. A kiválasztott adattárban egy webhook található.

Amikor a rendszer leküld egy új véglegesítést a kijelölt ágra, a szolgáltatás lekéri a kódot, létrehozza az alkalmazást, és üzembe helyezi azt a függvényalkalmazásban.

Bitbucket

1. Lépjen a függvényalkalmazásra az Azure Portalon, és válassza az Üzembe helyezési központ lehetőséget.

2. Forrásként válassza a Bitbucket lehetőséget.

3. Ha még nem engedélyezte a Bitbucket-hozzáférést, válassza az Engedélyezés , majd a Hozzáférés engedélyezése lehetőséget. Ha szükséges, adja meg a Bitbucket hitelesítő adatait, és válassza a Bejelentkezés lehetőséget. Ha egy másik Bitbucket-fiókot kell engedélyeznie, válassza a Fiók módosítása lehetőséget, és jelentkezzen be egy másik fiókkal.

4. Válassza ki a Szervezet, az Adattár és az Ág értékeit. Az értékek a kód helyétől függenek.

5. Tekintse át az összes részletet, és válassza a Mentés lehetőséget. A kiválasztott adattárban egy webhook található.

Amikor a rendszer leküld egy új véglegesítést a kijelölt ágra, a szolgáltatás lekéri a kódot, létrehozza az alkalmazást, és üzembe helyezi azt a függvényalkalmazásban.

Helyi Git

1. Lépjen a függvényalkalmazásra az Azure Portalon, és válassza az Üzembe helyezési központ lehetőséget.

2. Forráskéntválassza a Helyi git lehetőséget, és válassza a Mentés lehetőséget.

3. A meglévő App Service-csomagban létrejön egy helyi adattár, amely a scm tartományból érhető el. Másolja ki a Git clone URI-t , és használja az új adattár klónjának létrehozásához a helyi számítógépen.

Amikor a rendszer leküld egy új véglegesítést a helyi Git-adattárba, a szolgáltatás lekéri a kódot, létrehozza az alkalmazást, és üzembe helyezi azt a függvényalkalmazásban.

Az üzembe helyezés befejezése után a megadott forrásból származó összes kód üzembe lesz helyezve az alkalmazásban. Ezen a ponton az üzembehelyezési forrás változásai aktiválják a módosítások üzembe helyezését a függvényalkalmazásban az Azure-ban.

Megfontolások

A folyamatos üzembe helyezési stratégia tervezésekor tartsa szem előtt ezeket a szempontokat:

• A GitHub az egyetlen olyan forrás, amely jelenleg támogatja a használatalapú csomagon futó Linux-alkalmazások folyamatos üzembe helyezését, ami a Python-alkalmazások népszerű üzemeltetési lehetősége.

• Az Azure-beli függvények üzembehelyezési egysége a függvényalkalmazás. A függvényalkalmazások összes függvénye ugyanabban az időben és ugyanabban a csomagban lesz üzembe helyezve.

• A folyamatos üzembe helyezés engedélyezése után a függvénykódhoz való hozzáférés az Azure Portalon írásvédettként van konfigurálva, mert az igazság forrása ismert, hogy máshol található.

• Mindig konfigurálja a folyamatos üzembe helyezést egy átmeneti ponthoz, nem pedig az éles ponthoz. Az éles pont használata esetén a kódfrissítések közvetlenül éles környezetbe kerülnek anélkül, hogy ellenőrizték őket az Azure-ban. Ehelyett engedélyezze a folyamatos üzembe helyezést egy átmeneti ponton, ellenőrizze az előkészítési ponton lévő frissítéseket, és miután minden megfelelően fut, felcserélheti az előkészítési pont kódját az éles környezetbe.

• Az Üzembe helyezési központ nem támogatja a folyamatos üzembe helyezés engedélyezését bejövő hálózati korlátozásokkal rendelkező függvényalkalmazások esetében. Ehelyett közvetlenül a GitHubon vagy az Azure Pipelinesban kell konfigurálnia a buildszolgáltatói munkafolyamatot. Ezek a munkafolyamatok azt is megkövetelik, hogy a függvényalkalmazással azonos virtuális hálózatban lévő virtuális gépet használjon, mint egy saját üzemeltetésű ügynök (Pipelines) vagy egy saját üzemeltetésű futó (GitHub).

Folyamatos üzembe helyezés az alkalmazás létrehozása során

Jelenleg a GitHubról konfigurálhatja a folyamatos üzembe helyezést a GitHub Actions használatával, amikor a függvényalkalmazást az Azure Portalon hozza létre. Ezt a Függvényalkalmazás létrehozása lapon, az Üzembe helyezés lapon teheti meg.

Ha egy másik központi telepítési forrást vagy buildszolgáltatót szeretne használni a folyamatos integrációhoz, először hozza létre a függvényalkalmazást, majd térjen vissza a portálra, és állítsa be a folyamatos integrációt a Központi telepítési központban.

Alapszintű hitelesítés engedélyezése központi telepítésekhez

Alapértelmezés szerint a függvényalkalmazás alapszintű hitelesítési hozzáféréssel jön létre a scm végponthoz letiltva. Ez blokkolja a közzétételt minden olyan metódussal, amely nem tud felügyelt identitásokat használni a scm végpont eléréséhez. A végpont letiltásának közzétételi hatásait az scm üzembe helyezés alapszintű hitelesítés nélkül részletezi.

Fontos

Alapszintű hitelesítés használata esetén a hitelesítő adatok világos szövegben lesznek elküldve. A hitelesítő adatok védelméhez csak titkosított kapcsolaton (HTTPS) keresztül érheti el a scm végpontot, ha alapszintű hitelesítést használ. További információ: Biztonságos üzembe helyezés.

Alapszintű hitelesítés engedélyezése a scm végponton:

Azure Portal

1. Az Azure Portalon keresse meg a függvényalkalmazást.

2. Az alkalmazás bal oldali menüjében válassza az Általános konfigurációs>beállítások lehetőséget.

3. Állítsa be az SCM alapszintű hitelesítési hitelesítő adatait, majd válassza a Mentés lehetőséget.

Azure CLI

Az Azure CLI-vel bekapcsolhatja az alapszintű hitelesítést ezzel a az resource update paranccsal a végpontot vezérlő scm erőforrás frissítéséhez.

az resource update --resource-group <RESOURCE_GROUP> --name scm --namespace Microsoft.Web --resource-type basicPublishingCredentialsPolicies --parent sites/<APP_NAME> --set properties.allow=true

Ebben a parancsban cserélje le a helyőrzőket az erőforráscsoport nevére és az alkalmazás nevére.

Következő lépések

Azure Functions – ajánlott eljárások