Kurz: Použití služby Azure Container Instances jako agenta sestavení Jenkinse

Důležité

Mnoho služeb Azure má moduly plug-in Jenkinse. Některé z těchto modulů plug-in budou od 29. února 2024 mimo podporu. Azure CLI je aktuálně doporučený způsob integrace Jenkinse se službami Azure. Další informace najdete v článku Moduly plug-in Jenkins pro Azure.

Azure Container Instances (ACI) poskytuje prostředí na vyžádání, nárazové a izolované prostředí pro spouštění kontejnerizovaných úloh. Díky těmto atributům je ACI skvělou platformou pro spouštění úloh sestavení Jenkinse ve velkém měřítku. V tomto článku se dozvíte, jak nasadit ACI a přidat ho jako trvalého agenta sestavení pro kontroler Jenkins.

Další informace o službě Azure Container Instances najdete v tématu o službě Azure Container Instances.

Požadavky

Příprava kontroleru Jenkinse

  1. Přejděte na portál Jenkinse.

  2. V nabídce vyberte Spravovat Jenkinse.

  3. V části Konfigurace systému vyberte Konfigurovat systém.

  4. Ověřte, že adresa URL Jenkinse je nastavená na adresu HTTP vaší instalace Jenkinse - http://<your_host>.<your_domain>:8080/.

  5. V nabídce vyberte Spravovat Jenkinse.

  6. V části Zabezpečení vyberte Konfigurovat globální zabezpečení.

  7. V části Agenti zadejte pevný port a zadejte příslušné číslo portu pro vaše prostředí.

    Příklad konfigurace: Configure TCP port

  8. Zvolte Uložit.

Vytvoření pracovního agenta Jenkinse

  1. Přejděte na portál Jenkinse.

  2. V nabídce vyberte Spravovat Jenkinse.

  3. V části Konfigurace systému vyberte Spravovat uzly a cloudy.

  4. V nabídce vyberte Nový uzel.

  5. Zadejte hodnotu pro název uzlu.

  6. Vyberte trvalého agenta.

  7. Vyberte OK.

  8. Zadejte hodnotu vzdáleného kořenového adresáře. Například /home/jenkins/work

  9. Přidejte popisek (popisky slouží k seskupení více agentů do jedné logické skupiny. Příkladem popisku je linux seskupení agentů Pro Linux.) s hodnotou linux.

  10. Nastavte metodu Launch na Launch agent připojením k hlavnímu serveru.

  11. Ověřte, že byla zadána nebo zadána všechna požadovaná pole:

    Example Jenkins agent configuration

  12. Zvolte Uložit.

  13. Na stránce se stavem agenta byste měli vidět JENKINS_SECRETAGENT_NAME Následující snímek obrazovky ukazuje, jak identifikovat hodnoty. Obě hodnoty jsou potřeba při vytváření instance kontejneru Azure.

    The build-agent secret is displays after its successful creation.

Vytvoření instance kontejneru Azure pomocí rozhraní příkazového řádku

  1. Pomocí příkazu az group create vytvořte skupinu prostředků Azure.

    az group create --name my-resourcegroup --location westus
    
  2. Pomocí příkazu az container create vytvořte instanci kontejneru Azure. Zástupné symboly nahraďte hodnotami získanými při vytváření pracovního agenta.

    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>"
    

    Nahraďte a <JENKINS_SECRET><AGENT_NAME> nahraďte http://jenkinsserver:portinformacemi o kontroleru a agentech Jenkinse. Po spuštění kontejneru se automaticky připojí k serveru kontroleru Jenkinse.

  3. Vraťte se na řídicí panel Jenkinse a zkontrolujte stav agenta.

    Agent has started successfully

    Poznámka:

    Agenti Jenkins se připojují k řadiči přes port 5000, ujistěte se, že port je povolený pro příchozí spojení do kontroleru Jenkinse.

Vytvoření úlohy sestavení

Teď se vytvoří úloha sestavení Jenkinse, která demonstruje sestavení Jenkinse v instanci kontejneru Azure.

  1. Vyberte Možnost Nová položka, zadejte název projektu sestavení, například aci-demo, vyberte Volný projekt a vyberte OK.

    Box for the name of the build job, and list of project types

  2. V části Obecné se ujistěte, že je vybraná možnost Omezit, kde lze tento projekt spustit . Zadejte linux pro výraz popisku. Tato konfigurace zajišťuje, aby tato úloha sestavení běžela v cloudu ACI.

  3. V části Sestavení vyberte Přidat krok sestavení a vyberte Spustit prostředí. Zadejte echo "aci-demo" jako příkaz.

  4. Zvolte Uložit.

Spuštění úlohy sestavení

Pokud chcete otestovat úlohu sestavení a sledovat službu Azure Container Instances, spusťte sestavení ručně.

  1. Výběrem možnosti Sestavit nyní spusťte úlohu sestavení. Po spuštění úlohy se zobrazí stav podobný následujícímu obrázku:

  2. V historii sestavení klikněte na build č. 1.

  3. Výběrem výstupu konzoly zobrazíte výstup sestavení.

Další kroky