Azure Functions – folyamatos üzembe helyezés

Az Azure Functions lehetővé teszi a forrásvezérlő-adattárban végrehajtott módosítások folyamatos üzembe helyezését egy csatlakoztatott függvényalkalmazásban. Ez 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.

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. Ha egy éles ponthoz csatlakozik, győződjön meg arról, hogy csak éles minőségű kód teszi azt az integrált kódágba.

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. Ezek a lépések egy előkészítést vagy egy éles pontot célozhatnak meg.

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 Repos?

GitHub

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

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

Az Azure-beli függvények üzembehelyezési egysége a függvényalkalmazás. Ahhoz, hogy a folyamatos üzembe helyezés sikeres legyen, a projekt címtárszerkezetének kompatibilisnek kell lennie az Azure Functions által elvárt alapszintű mappastruktúrával. Amikor az Azure Functions Core Tools, a Visual Studio Code vagy a Visual Studio használatával hozza létre a kódprojektet, az Azure Functions-sablonok a megfelelő könyvtárszerkezettel rendelkező kódprojektek létrehozásához használhatók. 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ó.

Feljegyzés

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 (Azure Pipelines) vagy egy saját üzemeltetésű futó (GitHub).

Buildszolgáltató kiválasztá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.

Fontos

A nagyobb biztonság érdekében érdemes lehet olyan buildszolgáltatót használni, amely támogatja a felügyelt identitásokat, például az Azure Pipelinest és a GitHub Actionst. Az App Service (Kudu) szolgáltatáshoz engedélyeznie kell az alapszintű hitelesítést , és szöveges hitelesítő adatokkal kell dolgoznia.

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

Azure-folyamatok

Az Azure Pipelines az Azure DevOps egyik szolgáltatása, és az Azure Repos-projektek alapértelmezett buildszolgáltatója. Az Azure Pipelines használatával projekteket is készíthet a GitHubról. Az Azure 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. Támogatja a felügyelt identitásokat.

GitHub-műveletek

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. Támogatja a felügyelt identitásokat.

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 az Azure Pipelines vagy a GitHub Actions által nem támogatott egyéb üzembehelyezési forrásokat. A távoli buildelési, csomagolási és egyéb karbantartási feladatok az alkalmazáshoz dedikált altartományban scm.azurewebsites.net , például https://myfunctionapp.scm.azurewebsites.neta . Ez a buildelési szolgáltatás csak akkor használható, ha a scm hely az üzembe helyezéssel elérhető. Bár identitások használatával csatlakozhat a scm végponthoz, számos közzétételi eszköznek alapszintű hitelesítésre van szüksége a scm végponthoz való csatlakozáshoz.

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ített kódot a függvényalkalmazásban ezen eszközök egyikével, lehetséges, hogy számára.

A forráskövetési integráció engedélyezésekor tartsa szem előtt ezeknek a szolgáltatóknak az erősségeit és korlátait. Előfordulhat, hogy módosítania kell az adattár forrástípusát, hogy kihasználhassa egy adott szolgáltató előnyeit.

Folyamatos üzembe helyezés konfigurálása

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 konkrét módja a forrásvezérlő adattár típusától és a választott buildszolgáltatótól függ.

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. Az Azure Repos-szal történő Azure Pipelines-alapú üzembe helyezés részletes útmutatójáért tekintse meg a Folyamatos teljesítés az Azure Pipelines szolgáltatással útmutatót.

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. Az Azure Pipelines-alapú üzembe helyezés GitHubról történő létrehozásáról részletes útmutatót a Folyamatos teljesítés az Azure Pipelines szolgáltatással 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. Nyissa meg a függvényalkalmazást az Azure Portalon , és válassza az Üzembe helyezési központ lehetőséget.

2. A Forrás számára válassza az Azure Repos-t. Ha nem az App Service build szolgáltató az alapértelmezett, válassza a Szolgáltató módosítása lehetőséget, válassza az App Service build szolgáltatást, majd 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. Nyissa meg a függvényalkalmazást az Azure Portalon , és válassza az Üzembe helyezési központ lehetőséget.

2. A Forrásként válassza a GitHubot. Ha nem az App Service build szolgáltató az alapértelmezett, válassza a Szolgáltató módosítása lehetőséget, válassza az App Service build szolgáltatást, majd 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. Nyissa meg a függvényalkalmazást az Azure Portalon , és válassza az Üzembe helyezési központ lehetőséget.

2. A Forrás mezőben 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. Nyissa meg a függvényalkalmazást az Azure Portalon , és válassza az Üzembe helyezési központ lehetőséget.

2. A Forrás területen válassza a Helyi git, majd 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.

Folyamatos üzembe helyezés engedélyezése 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

Bizonyos esetekben 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 című témakörben találja.

Fontos

Alapszintű hitelesítés használata esetén a hitelesítő adatokat a rendszer tiszta szövegben küldi el. A hitelesítő adatok védelméhez csak titkosított kapcsolaton (HTTPS) keresztül férhet hozzá a scm végponthoz alapszintű hitelesítés esetén. 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 nyissa meg a függvényalkalmazást.

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

3. Állítsa az SCM alapszintű hitelesítési adatokatBe, 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