Oktatóanyag: Az Azure Container Instances használata Jenkins-buildügynökként

Fontos

Számos Azure-szolgáltatás rendelkezik Jenkins beépülő modulokkal. Ezen beépülő modulok némelyike 2024. február 29-étől nem támogatott. A Jenkins azure-szolgáltatásokkal való integrálásának jelenleg az Azure CLI az ajánlott módja. További információ: Jenkins beépülő modulok az Azure-hoz.

Az Azure Container Instances (ACI) igény szerinti, kipukkasztható és elkülönített környezetet biztosít a tárolóalapú számítási feladatok futtatásához. Ezen attribútumok miatt az ACI nagyszerű platformot biztosít a Jenkins buildelési feladatainak nagy léptékű futtatásához. Ez a cikk bemutatja, hogyan helyezhet üzembe egy ACI-t, és hogyan adhat hozzá állandó buildügynökként egy Jenkins-vezérlőhöz.

Az Azure Container Instances szolgáltatással kapcsolatos további információkért lásd az Azure Container Instances szolgáltatásról szóló témakört.

Előfeltételek

• Azure-előfizetés: Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .
• Jenkins-kiszolgáló: Ha nincs telepítve Jenkins-kiszolgáló, hozzon létre egy Jenkins-kiszolgálót az Azure-ban.

A Jenkins-vezérlő előkészítése

1. Keresse meg a Jenkins portált.

2. A menüben válassza a Jenkins kezelése lehetőséget.

3. A Rendszerkonfiguráció területen válassza a Rendszer konfigurálása lehetőséget.

4. Ellenőrizze, hogy a Jenkins URL-címe a Jenkins-telepítés HTTP-címére van-e állítva – http://<your_host>.<your_domain>:8080/.

5. A menüben válassza a Jenkins kezelése lehetőséget.

6. A Biztonság területen válassza a Globális biztonság konfigurálása lehetőséget.

7. Az Ügynökök területen adja meg a Rögzített portot, és adja meg a környezetének megfelelő portszámot.

   Konfigurációs példa:

8. Válassza a Mentés parancsot.

Jenkins munkaügynök létrehozása

1. Keresse meg a Jenkins portált.

2. A menüben válassza a Jenkins kezelése lehetőséget.

3. A Rendszerkonfiguráció területen válassza a Csomópontok és felhők kezelése lehetőséget.

4. A menüben válassza az Új csomópont lehetőséget.

5. Adjon meg egy értéket a csomópontnévhez.

6. Válassza az Állandó ügynök lehetőséget.

7. Kattintson az OK gombra.

8. Adjon meg egy értéket a távoli gyökérkönyvtárhoz. Például: /home/jenkins/work

9. Címke hozzáadása (A címkékkel több ügynököt csoportosíthat egy logikai csoportba. Egy címke például linux a Linux-ügynökök csoportosításalinux.) értékével.

10. A Főkiszolgálóhoz való csatlakozással állítsa a Launch metódust a Launch agent (Ügynök indítása) értékre.

11. Ellenőrizze, hogy az összes szükséges mező meg van-e adva vagy be lett-e adva:

    

12. Válassza a Mentés parancsot.

13. Az ügynök állapotlapján meg kell jelennie az és AGENT_NAMEa JENKINS_SECRET . Az alábbi képernyőképen az értékek azonosítása látható. Az Azure Container Instance létrehozásakor mindkét értékre szükség van.

    

Azure Container Instance létrehozása parancssori felülettel

1. Azure-erőforráscsoport létrehozása az az group create használatával .

   az group create --name my-resourcegroup --location westus
   

2. Azure Container Instance létrehozása az container create használatával . Cserélje le a helyőrzőket a munkaügynök létrehozásakor kapott értékekre.

   az container create \
     --name my-dock \
     --resource-group my-resourcegroup \
     --ip-address Public --image jenkins/inbound-agent:latest \
     --os-type linux \
     --ports 80 \
     --command-line "jenkins-agent -url http://jenkinsserver:port <JENKINS_SECRET> <AGENT_NAME>"
   

   Cserélje le http://jenkinsserver:porta jenkins-vezérlőt <JENKINS_SECRET>és <AGENT_NAME> az ügynök adatait. A tároló elindítása után automatikusan csatlakozik a Jenkins-vezérlőkiszolgálóhoz.

3. Térjen vissza a Jenkins-irányítópultra, és ellenőrizze az ügynök állapotát.

   

   Megjegyzés:

   A Jenkins-ügynökök porton 5000keresztül csatlakoznak a vezérlőhöz, győződjön meg arról, hogy a port be van kelve a Jenkins-vezérlőbe.

Buildelési feladat létrehozása

Most létrejön egy Jenkins buildelési feladat, amely bemutatja a Jenkins-buildeket egy Azure-tárolópéldányon.

1. Válassza az Új elem lehetőséget, adjon nevet a buildprojektnek, például aci-demo, válassza a Freestyle projektet, és válassza az OK gombot.

   

2. Az Általános csoportban győződjön meg arról, hogy a projekt futtatásának korlátozása jelölőnégyzet be van jelölve. Adja meg a linuxot a címkekifejezéshez. Ez a konfiguráció biztosítja, hogy ez a buildelési feladat az ACI-felhőben fusson.

   

3. A Build területen válassza a Build hozzáadása lépés, majd a Shell végrehajtása lehetőséget. Adja meg echo "aci-demo" a parancsot.

   

4. Válassza a Mentés parancsot.

A buildelési feladat futtatása

A buildelési feladat teszteléséhez és az Azure Container Instances manuális megfigyeléséhez indítsa el a buildet.

1. A buildelési feladat elindításához válassza a Build Now lehetőséget. A feladat elindítása után a következő képhez hasonló állapot jelenik meg:

   

2. Kattintson az 1. buildre a buildelőzményekben.

   

3. Válassza a Konzolkimenet lehetőséget a buildek kimenetének megtekintéséhez.

   

További lépések

Folyamatos integráció/üzembe helyezés az Azure App Service-be