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 staging helyhez, nem pedig a production helyhez. Amikor az éles helyet használja, a kódfrissítések közvetlenül a termelési környezetbe kerülnek, anélkül hogy az Azure-ban ellenőrizték volna őket. 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 produkciós helyhez csatlakozik, győződjön meg arról, hogy csak produkciós minőségű kód kerül 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.

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

Azure Repos

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óval együtt 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 build szolgáltató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.

Megjegyzés

A cikkben tárgyalt folyamatos üzembe helyezési lehetőségek kizárólag kódalapú telepítésekre vonatkoznak. A tárolóalapú függvényalkalmazások üzembe helyezéséről a tárolók Azure-ba való folyamatos üzembe helyezésének engedélyezése című szakaszában talál további információt a Tárolók és az Azure Functions használata című szakaszban.

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ó.

Megjegyzé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).

Szolgáltató kiválasztása a buildhez

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.

Az Azure 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. 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. Az Azure Pipelines támogatja a felügyelt identitásokat.

GitHub-műveletek

A GitHub-projektek alapértelmezett buildszolgáltatója a GitHub Actions. Lehetővé teszi a projekt létrehozásának, csomagolásának és üzembe helyezésének szabályozását. Ez a szolgáltató támogatja a felügyelt identitásokat.

App Service (Kudu) szolgáltatás

Az App Service platform egy Project Kudu nevű natív üzembehelyezési szolgáltatást tart fenn. Ez a szolgáltatás 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 scm.azurewebsites.net altartományban, például https://myfunctionapp.scm.azurewebsites.net történnek. Ez a build szolgáltatás csak akkor használható, ha az üzembe helyezés hozzáfér a scm helyhez. 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 használta ezeket az eszközöket a kód a függvényalkalmazásban való üzembe helyezéséhez, lehetséges, hogy engedélyeznie kell az alapszintű hitelesítést a hely használatához.scm

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 Repos

Az Azure Repos üzembe helyezései, amelyek Azure Pipelines-t használnak, 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

GitHub-telepítések, amelyek az Azure Pipelines-t használják, az Azure DevOps portálon vannak meghatározva, nem pedig 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 az App Service build-szolgáltatót.

Azure Repos

Nem telepíthet az Azure Repos adattárakból GitHub Actions használatával. 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 Építés a GitHub Actions segítségével, válassza a Szolgáltató módosítása lehetőséget, válassza a GitHub Actions-t, majd kattintson az OK gombra.

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 build szolgá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 build szolgáltatót.

Azure Repos

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 a GitHub-hozzáférés még nincs engedélyezve, 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 a Bitbucket-hozzáférés még nincs engedélyezve, 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 egy új commitet leküldenek a kiválasztott ágra, a szolgáltatás lekéri a kódot, létrehozza az alkalmazást, és üzembe helyezi azt a függvényalkalmazásba.

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 beállítást a Függvényalkalmazás létrehozása lapon, az Üzembe helyezés lapon teheti meg.

Ha egy másik üzembehelyezé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 az Üzembe helyezési központban.

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

Bizonyos esetekben a függvényalkalmazás a scm végponthoz való alapszintű hitelesítési hozzáférés letiltásával jön létre. 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