Kurz: Škálování nasazení Jenkinse s využitím virtuálního počítače běžícího v Azure

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.

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

V tomto kurzu:

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

Požadavky

• Instalace Jenkinse: Pokud nemáte přístup k instalaci Jenkinse, nakonfigurujte Jenkinse pomocí Azure CLI.

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

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

   az group create --name <resource_group> --location <location>
   

2. K vytvoření virtuálního počítače použijte příkaz az vm create .

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

   Klíčové body:

   • Klíč ssh můžete nahrát také pomocí následujícího příkazu --ssh-key-value <ssh_path>.

3. Nainstalujte sadu JDK.

   Linux

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

      ssh username@123.123.123.123
      

   2. Nainstalujte sadu JDK pomocí apt. Můžete také nainstalovat s jinými nástroji správce balíčků, jako je yum nebo pacman.

      sudo apt-get install -y default-jdk
      

   3. Po dokončení instalace spusťte java -version ověření prostředí Java. Výstup bude obsahovat čísla verzí přidružená k různým částem sady JDK.

   Windows

   1. Přihlaste se k virtuálnímu počítači pomocí nástroje SSH nebo pomocí Připojení Vzdálené plochy.

   2. Stáhněte sadu JDK , která je vhodná pro vaše prostředí.

   3. Instalace sady JDK

Konfigurace adresy URL Jenkinse

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

1. V nabídce vyberte Spravovat Jenkinse.

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

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

4. Zvolte Uložit.

Přidání agenta do Jenkinse

1. V nabídce vyberte Spravovat Jenkinse.

2. V části Konfigurace systému vyberte 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 zbývají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 názvu je povolena libovolný speciální znak z následujícího seznamu: ?*/\%!@#$^&|<>[]:;.

   • Vzdálený kořenový adresář: Agent musí mít adresář vyhrazený jenkinsi. Zadejte cestu k tomuto adresáři v agentu. Nejlepší je použít absolutní cestu, například /home/azureuser/work nebo c:\jenkins. To by měla být cesta místní k počítači agenta. Tato cesta nemusí být viditelná z předlohy. Pokud použijete relativní cestu, například ./jenkins-agent, bude cesta relativní k pracovnímu adresáři poskytnutému metodou Launch.

   • Popisky: Popisky slouží k seskupení sémanticky souvisejících agentů do jedné logické skupiny. Můžete například definovat popisek UBUNTU pro všechny vaše agenty, na kterých běží distribuce Ubuntu Linuxu.

   • Metoda spuštění: Vzdálené uzel Jenkinse můžete spustit dvěma způsoby: Spuštění agentů přes SSH a Spuštění agenta spuštěním příkazu na hlavním serveru:

     • Spuštění agentů přes SSH: Zadejte hodnoty následujících polí:

       • Hostitel: Veřejná IP adresa nebo název domény virtuálního počítače. Příklad: 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 , abyste definovali nové přihlašovací údaje, a po vytvoření pak tyto nové přihlašovací údaje vyberte.

       • Strategie ověření klíče hostitele: Řídí, jak Jenkins ověřuje klíč SSH prezentovaný vzdáleným hostitelem při připojování.

       

     • Spuštění agenta spuštěním příkazu na hlavním serveru:

       • Stáhnout z agent.jarhttps://<your_jenkins_host_name>/jnlpJars/agent.jar. Například https://localhost:8443/jnlpJars/agent.jar.

       • Nahrání agent.jar na virtuální počítač

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

       

8. Zvolte Uložit.

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

Vytvoření úlohy v Jenkinsu

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

2. Zadejte demoproject1 název.

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 ubuntu. Zobrazí se zpráva potvrzující, že tento popisek obsluhuje konfigurace cloudu vytvořená v předchozím kroku.

   

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: https://github.com/spring-projects/spring-petclinic.git.

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 Goals (Cíle) zadejte package.

8. Zvolte 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. Nové sestavení se zařadí do fronty, ale nespustí se, dokud se ve vašem předplatném Azure nevytvořil 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.

   

Další kroky

Průběžná integrace a doručování do služby Azure App Service