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

Důležité

Řada služeb Azure má moduly plug-in Jenkinse. Některé z těchto modulů plug-in nebudou k 29. únoru 2024 podporovat. Azure CLI je aktuálně doporučený způsob integrace Jenkinse se službami Azure. Další informace najdete v článku Moduly plug-in Jenkinse pro Azure.

Azure Container Instances (ACI) poskytuje prostředí na vyžádání, burstable 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. Tento článek ukazuje, jak nasadit ACI a přidat ho jako trvalého agenta sestavení pro kontroler Jenkinse.

Další informace o této Azure Container Instances v tématu Informace o Azure Container Instances.

Požadavky

  • Předplatné Azure:Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
  • Server Jenkins:Pokud nemáte nainstalovaný server Jenkins, vytvořte v Azure server Jenkins.

Příprava kontroleru Jenkinse

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

  2. V nabídce vyberte Manage Jenkins (Spravovat Jenkinse).

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

  4. Ověřte, že je adresa URL Jenkinse nastavená na adresu HTTP vaší instalace Jenkinse – .

  5. V nabídce vyberte Manage Jenkins (Spravovat Jenkinse).

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

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

    Příklad konfigurace: Konfigurace portu TCP

  8. Vyberte Uložit.

Vytvoření pracovního agenta Jenkinse

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

  2. V nabídce vyberte Manage Jenkins (Spravovat Jenkinse).

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

  4. V nabídce vyberte Nový uzel.

  5. Zadejte hodnotu node name (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 s hodnotou .

  10. Nastavte Launch method (Metodaspuštění) na Launch agent (Spustit agenta) připojením k hlavnímu serveru.

  11. Ověřte, že jsou zadaná nebo zadaná všechna povinná pole:

    Příklad konfigurace agenta Jenkinse

  12. Vyberte Uložit.

  13. Na stránce stavu agenta by se měly zobrazit a 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.

    Tajný kód build-agent se zobrazí po úspěšném vytvoření.

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

  1. K vytvoření skupiny prostředků Azure použijte az group create.

    az group create --name my-resourcegroup --location westus
    
  2. K vytvoření instance kontejneru Azure použijte az container create. 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 http://jenkinsserver:port , a informacemi o <JENKINS_SECRET><AGENT_NAME> kontroleru a agentovi 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 se úspěšně zahájil

    Poznámka

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

Vytvoření úlohy sestavení

Teď je vytvořená úloha sestavení Jenkinse, která předvede sestavení Jenkinse v instanci kontejneru Azure.

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

    Pole pro název úlohy sestavení a seznam typů projektů

  2. V částiObecné se ujistěte, že je vybraná možnost Omezit, kde lze tento projekt spustit. Jako výraz popisku zadejte linux. Tato konfigurace zajistí, že se tato úloha sestavení spustí v cloudu ACI.

    Karta Obecné s podrobnostmi o konfiguraci

  3. V částiBuild (Sestavení) vyberte Add build step (Přidat krok sestavení) a vyberte Execute Shell (Spustit prostředí). Jako echo "aci-demo" příkaz zadejte .

    Karta Sestavení s výběry pro krok sestavení

  4. Vyberte Uložit.

Spuštění úlohy sestavení

Pokud chcete otestovat úlohu sestavení a Azure Container Instances ručně spustit sestavení.

  1. Vyberte Build Now (Sestavit) a spusťte úlohu sestavení. Po spuštění úlohy se zobrazí stav podobný následujícímu obrázku:

    Informace o historii sestavení se stavem úlohy

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

    Výstup konzoly zobrazí výstup sestavení z konzoly v historii sestavení.

  3. Výběrem možnosti Výstup konzoly zobrazíte výstup sestavení.

    Výstup konzoly zobrazí výstup sestavení z konzoly ve výstupu sestavení.

Další kroky