Začínáme: Instalace Jenkinse na virtuální počítač Azure s Linuxem

Tento článek ukazuje, jak nainstalovat Jenkins na virtuální počítač s Ubuntu Linuxem pomocí nástrojů a modulů plug-in nakonfigurovaných pro práci s Azure.

V tomto článku se naučíte:

  • Vytvoření instalačního souboru, který stáhne a nainstaluje Jenkins
  • Vytvoření skupiny zdrojů
  • Vytvoření virtuálního počítače s instalačním souborem
  • Otevřete port 8080 pro přístup k Jenkinsi na virtuálním počítači.
  • Připojení k virtuálnímu počítači přes SSH
  • Konfigurace ukázkové úlohy Jenkinse na základě ukázkové aplikace v Javě na GitHubu
  • Sestavení ukázkové úlohy Jenkinse

1. Konfigurace prostředí

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

2. Otevřete Cloud Shell

  1. Pokud už máte otevřenou relaci Cloud Shellu, můžete přejít k další části.

  2. Přejděte na Azure Portal.

  3. V případě potřeby se přihlaste ke svému předplatnému Azure a změňte adresář Azure.

  4. Otevřete Cloud Shell.

    Open Cloud Shell from the top menu in the Azure portal.

  5. Pokud jste cloud Shell ještě nepoužívali, nakonfigurujte prostředí a nastavení úložiště.

  6. Vyberte prostředí příkazového řádku.

    Select the CLI you want to use in Cloud Shell.

3. Vytvoření virtuálního počítače

  1. Vytvořte testovací adresář s názvem jenkins-get-started.

  2. Přepněte do testovacího adresáře.

  3. Vytvořte soubor s názvem cloud-init-jenkins.txt.

  4. Do nového souboru vložte následující kód:

    #cloud-config
    package_upgrade: true
    runcmd:
      - sudo apt install openjdk-11-jre -y
      - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
      -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
      - sudo apt-get update && sudo apt-get install jenkins -y
      - sudo service jenkins restart
    
    
    
  5. Spuštěním příkazu az group create vytvořte skupinu prostředků.

    az group create --name jenkins-get-started-rg --location eastus
    
  6. Spuštěním příkazu az vm create vytvořte virtuální počítač.

    az vm create \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm \
    --image UbuntuLTS \
    --admin-username "azureuser" \
    --generate-ssh-keys \
    --public-ip-sku Standard \
    --custom-data cloud-init-jenkins.txt
    
  7. Spuštěním příkazu az vm list ověřte vytvoření (a stav) nového virtuálního počítače.

    az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
    
  8. Když Jenkins běží na portu 8080, spusťte az vm open a otevřete port 8080 na novém virtuálním počítači.

    az vm open-port \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm  \
    --port 8080 --priority 1010
    

4. Konfigurace Jenkinse

  1. Spuštěním příkazu az vm show získejte veřejnou IP adresu ukázkového virtuálního počítače.

    az vm show \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm -d \
    --query [publicIps] \
    --output tsv
    

    Klíčové body:

    • Parametr --query omezuje výstup na veřejné IP adresy virtuálního počítače.
  2. Pomocí IP adresy načtené v předchozím kroku se připojte přes SSH k virtuálnímu počítači. Budete muset potvrdit žádost o připojení.

    ssh azureuser@<ip_address>
    

    Klíčové body:

    • Po úspěšném připojení obsahuje výzva Cloud Shellu uživatelské jméno a název virtuálního počítače: azureuser@jenkins-get-started-vm.
  3. Ověřte, že je Jenkins spuštěný, a to získáním stavu služby Jenkins.

    service jenkins status
    

    Klíčové body:

    • Pokud se zobrazí chyba týkající se služby, která neexistuje, možná budete muset několik minut počkat, než se všechno nainstaluje a inicializuje.
  4. Získejte automaticky vygenerované heslo Jenkinse.

    sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    
  5. Pomocí IP adresy otevřete v prohlížeči následující adresu URL: http://<ip_address>:8080

  6. Zadejte heslo, které jste získali dříve, a vyberte Pokračovat.

    Initial page to unlock Jenkins

  7. Vyberte vybrat modul plug-in, který chcete nainstalovat.

    Select the option to install selected plug-ins

  8. Do pole filtru v horní části stránky zadejte github. Vyberte modul plug-in GitHub a vyberte Nainstalovat.

    Install the GitHub plug-ins

  9. Zadejte informace pro prvního uživatele správce a vyberte Uložit a pokračovat.

    Enter information for first admin user

  10. Na stránce Konfigurace instance vyberte Uložit a dokončit.

    Confirmation page for instance configuration

  11. Vyberte Začít používat Jenkinse.

    Jenkins is ready!

5. Vytvoření první úlohy

  1. Na domovské stránce Jenkinse vyberte Vytvořit úlohu.

    Jenkins console home page

  2. Zadejte název mySampleAppúlohy , vyberte Volný projekt a vyberte OK.

    New job creation

  3. Vyberte kartu Správa zdrojového kódu. Povolte Git a zadejte následující adresu URL pro hodnotu adresy URL úložiště: https://github.com/spring-guides/gs-spring-boot.git. Potom změňte specifikátor větve na */main.

    Define the Git repo

  4. Vyberte kartu Sestavení a pak vyberte Přidat krok sestavení.

    Add a new build step

  5. V rozevírací nabídce vyberte Vyvolat skript Gradle.

    Select the Gradle script option

  6. Vyberte Use Gradle Wrapper (Použít obálku Gradle) a pak zadejte complete do pole Wrapper location (Umístění obálky) a build do pole Tasks (Úlohy).

    Gradle script options

  7. Vyberte Upřesnit a zadejte complete do pole Kořenový skript sestavení.

    Advanced Gradle script options

  8. Posuňte se do dolní části stránky a vyberte Uložit.

6. Sestavení ukázkové aplikace v Javě

  1. Když se zobrazí domovská stránka projektu, vyberte Sestavit a zkompilujte kód a zabalte ukázkovou aplikaci.

    Project home page

  2. Obrázek pod nadpisem Historie sestavení označuje, že se úloha sestavuje.

    Job-build in progress

  3. Po dokončení sestavení vyberte odkaz Pracovní prostor .

    Select the workspace link.

  4. Přejděte, abyste complete/build/libs viděli, že .jar soubor byl úspěšně sestaven.

    The target library verifies the build succeeded.

  5. Váš server Jenkins je teď připravený k vytváření vlastních projektů v Azure!

Řešení problému

Pokud při konfiguraci Jenkinse narazíte na problémy, projděte si stránku instalace Jenkinse s nejnovějšími pokyny a známými problémy.

Další kroky