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

Důležité

Zatímco mnoho služeb Azure má plug-iny pro Jenkins, většina z nich ukončí podporu k 29. únoru 2024. 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řte agentní stroj
• Přidání agenta do Jenkinse
• Vytvoření nové freestylové úlohy Jenkinse
• Spuštění úlohy na agentu 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 JDK.

   Operační systém 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 pro 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í ke vzdálené ploše.

   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. Vyberte 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é. U názvu je povolen libovolný speciální znak z následujícího seznamu: ?*/\%!@#$^&|<>[]:;.

   • Vzdálený kořenový adresář: Agent musí mít adresář, který je vyhrazený pro Jenkins. 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 hlavní verze. 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áhněte si agent.jar z https://<your_jenkins_host_name>/jnlpJars/agent.jar. Například: https://localhost:8443/jnlpJars/agent.jar.

       • Nahrajte agent.jar do svého virtuálního počítače

       • 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. Vyberte Uložit.

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

Vytvoření úlohy v Jenkinsi

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

2. Zadejte demoproject1 pro název.

3. Vyberte projekt Freestyle.

4. Vyberte OK.

5. Na kartě Obecné zvolte Omezit, kde lze projekt spustit a zadejte ubuntu do Výrazu popisku. Zobrazí se zpráva s potvrzením, že štítek zprostředkovává konfigurace cloudu vytvořená v předchozím kroku.

   

6. Na kartě Správa zdrojového kódu vyberte Git a do pole Adresa URL úložiště přidejte 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ě). Zadejte package do pole Cíle .

8. Vyberte Uložit.

Sestavení nové úlohy na agentu virtuálního počítače Azure

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

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

3. Po dokončení sestavení přejděte do výstupu konzoly. Uvidíte, že se sestavení provedlo vzdáleně v agentu Azure.

   

Další kroky

CI/CD na Azure App Service