Kurz: škálování nasazení Jenkinse pomocí virtuálního počítače běžícího v Azure

Důležité

Mnoho služeb Azure má Jenkinse moduly plug-in. Některé z těchto modulů plug-in se od 29. února 2024 nepodporují. Azure CLI je aktuálně doporučeným způsobem, jak integrovat Jenkinse se službami Azure. Další informace najdete v článku Jenkinse moduly plug-in pro Azure.

V tomto kurzu se dozvíte, jak vytvořit virtuální počítače se systémem Linux v Azure a přidat virtuální počítač jako pracovní uzel do Jenkinse.

V tomto kurzu:

  • Vytvořit počítač agenta
  • Přidat agenta do Jenkinse
  • Vytvoření nové volné úlohy Jenkinse
  • Spuštění úlohy v agentovi virtuálního počítače Azure

Požadavky

Konfigurace virtuálního počítače agenta

  1. Pomocí AZ Group Create vytvořte skupinu prostředků Azure.

    az group create --name <resource_group> --location <location>
    
  2. Pomocí AZ VM Create vytvořte virtuální počítač.

    az vm create --resource-group <resource-group> --name <vm_name> --image UbuntuLTS --admin-username azureuser --admin-password "<password>"
    

    Klíčové body:

    • Můžete také odeslat klíč SSH pomocí následujícího příkazu --ssh-key-value <ssh_path> .
  3. Nainstalujte JDK.

    1. Přihlaste se k virtuálnímu počítači pomocí nástroje SSH.

      ssh username@123.123.123.123
      
    2. Nainstalujte JDK s apt. Můžete ji také nainstalovat pomocí dalších nástrojů Správce balíčků, jako je Yumu nebo Pacman.

      sudo apt-get install -y default-jdk
      
    3. Po dokončení instalace spusťte příkaz java -version a ověřte prostředí Java. Výstup bude obsahovat čísla verzí přidružená k různým částem JDK.

Konfigurace adresy URL Jenkinse

Pokud používáte JNLP, budete muset nakonfigurovat Jenkinse adresu URL.

  1. V nabídce vyberte Spravovat Jenkinse.

  2. V části Konfigurace systémuvyberte Konfigurovat systém.

  3. Ověřte, jestli je Adresa URL Jenkinse nastavená na adresu http instalace Jenkinse .

  4. Vyberte Uložit.

Přidat agenta do Jenkinse

  1. V nabídce vyberte Spravovat Jenkinse.

  2. V části Konfigurace systémuvyberte Spravovat uzly a cloudy.

  3. V nabídce vyberte nový uzel.

  4. Zadejte hodnotu pro název uzlu.

  5. Vyberte trvalého agenta.

  6. Vyberte OK.

  7. Zadejte hodnoty pro následující pole:

    • Název: Zadejte jedinečný název, který identifikuje agenta v rámci nové instalace Jenkinse. Tato hodnota se může lišit od názvu hostitele agenta. Je ale vhodné, aby byly dvě hodnoty stejné. Hodnota name má povolený libovolný speciální znak z následujícího seznamu: ?*/\%!@#$^&|<>[]:; .

    • Vzdálený kořenový adresář: Agent musí mít adresář vyhrazený pro Jenkinse. Zadejte cestu k tomuto adresáři v agentovi. Je nejvhodnější použít absolutní cestu, například /home/azureuser/work nebo c:\jenkins . Mělo by se jednat o místní cestu k počítači agenta. Není nutné, aby byla tato cesta viditelná z hlavního serveru. Pokud použijete relativní cestu, například./Jenkins-agent, cesta bude relativní vzhledem k pracovnímu adresáři poskytnutému metodou spuštění.

    • Labels: popisky slouží k seskupení sémanticky souvisejících agentů do jedné logické skupiny. Můžete například definovat popisek UBUNTU pro všechny agenty, kteří používají Ubuntu distribuce systému Linux.

    • Metoda spuštění: ke spuštění vzdáleného uzlu Jenkinse existují dvě možnosti: Spustit agenty přes SSH a Spustit agenta prostřednictvím příkazu na hlavním serveru:

      • Spustit agenty prostřednictvím SSH: zadejte hodnoty pro následující pole:

        • Hostitel: veřejná IP adresa virtuálního počítače nebo název domény. Příkladem je 123.123.123.123 nebo example.com.

        • Přihlašovací údaje: Vyberte přihlašovací údaje, které se mají použít pro přihlášení ke vzdálenému hostiteli. Můžete také vybrat tlačítko Přidat a definovat nové přihlašovací údaje a po vytvoření nové přihlašovací údaje vybrat.

        • Strategie ověřování klíčů hostitele: Určuje, jak Jenkinse ověřuje klíč SSH prezentovaný vzdáleným hostitelem během připojování.

        Příklad konfigurace uzlu určení metody spuštění agentů spouštění prostřednictvím SSH.

      • Spustit agenta prostřednictvím příkazu na hlavním serveru:

        • Stáhněte si agent.jar z https://<your_jenkins_host_name>/jnlpJars/agent.jar . Například, https://localhost:8443/jnlpJars/agent.jar.

        • Upload agent.jar k virtuálnímu počítači

        • Spusťte Jenkinse pomocí příkazu ssh <node_host> java -jar <remote_agentjar_path> . Například, ssh azureuser@99.99.999.9 java -jar /home/azureuser/agent.jar.

        Příklad konfigurace uzlu určení metody spuštění pro spuštění agenta prostřednictvím spuštění příkazu v hlavní nabídce.

  8. Vyberte Uložit.

Po definování konfigurací Jenkinse přidá virtuální počítač jako nový pracovní uzel.

Příklad virtuálního počítače jako nového pracovního uzlu

Vytvoření úlohy v Jenkinsu

  1. V nabídce vyberte možnost Nová položka.

  2. demoproject1Jako název zadejte.

  3. Vyberte Freestyle project (Projekt Freestyle).

  4. Vyberte OK.

  5. Na kartě General (Obecné) zvolte možnost Restrict where project can be run (Omezit, kde je možné projekt spustit) a do pole Label Expression (Výraz popisku) zadejte . Zobrazí se zpráva potvrzující, že tento popisek obsluhuje konfigurace cloudu vytvořená v předchozím kroku.

    Nastavení nové úlohy Jenkinse

  6. Na kartě Source Code Management (Správa zdrojového kódu), vyberte Git a do pole Repository URL (Adresa URL úložiště) zadejte následující adresu URL: .

  7. Na kartě Build (Sestavení) vyberte Add build step (Přidat krok sestavení) a pak Invoke top-level Maven targets (Vyvolat cíle Maven nejvyšší úrovně). Do pole package (Cíle) zadejte package.

  8. Vyberte Uložit.

Sestavení nové úlohy v agentovi virtuálního počítače Azure

  1. Vyberte úlohu, kterou jste vytvořili v předchozím kroku.

  2. Vyberte sestavit hned. Nové sestavení je zařazené do fronty, ale nespustí se, dokud se ve vašem předplatném Azure nevytvoří virtuální počítač agenta.

  3. Jakmile bude sestavování dokončeno, přejděte na Console output (Výstup konzoly). Uvidíte, že se sestavení provedlo vzdáleně v agentovi Azure.

    Výstup konzoly

Další kroky