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

Tento článek ukazuje, jak nainstalovat Jenkinse na virtuální počítač Ubuntu Linux s nástroji a moduly plug-in nakonfigurované pro práci s Azure.

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

  • Vytvoření instalačního souboru, který stáhne a nainstaluje Jenkinse
  • Vytvoření skupiny prostředků
  • Vytvoření virtuálního počítače s instalačním souborem
  • Otevření portu 8080 pro přístup k Jenkins 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ě v GitHub
  • 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ření Cloud Shell

  1. Pokud už máte otevřenou Cloud Shell, můžete přeskočit 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.

    Otevřete Cloud Shell v horní nabídce v Azure Portal.

  5. Pokud jste zásady ještě nepouží Cloud Shell, nakonfigurujte nastavení prostředí a úložiště.

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

    Vyberte rozhraní příkazového řádku, které chcete použít v 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-8-jdk -y
      - wget -qO - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
      - sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
      - 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. Protože Jenkins běží na portu 8080, spuštěním příkazu az vm open otevřete na novém virtuálním počítači port 8080.

    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řes SSH k virtuálnímu počítači. Budete muset žádost o připojení potvrdit.

    ssh azureuser@<ip_address>
    

    Klíčové body:

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

    service jenkins status
    

    Klíčové body:

    • Pokud se zobrazí chyba týkající se služby, která ještě není k dispozici, možná budete muset několik minut počkat, než se vše 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.

    Počáteční stránka pro odemknutí Jenkinse

  7. Vyberte Select plug-in to install (Vybrat modul plug-in) a nainstalujte .

    Vyberte možnost instalace vybraných modulů plug-in.

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

    Instalace GitHub modulů plug-in

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

    Zadání informací pro prvního uživatele s rolí správce

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

    Stránka potvrzení pro konfiguraci instance

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

    Jenkins je připraven!

5. Vytvoření první úlohy

  1. Na domovské stránce Jenkinse vyberte Create a job (Vytvořit úlohu).

    Domovská stránka konzoly Jenkinse

  2. Zadejte název úlohy mySampleApp , vyberte mySampleAppa vyberte OK.

    Vytvoření nové úlohy

  3. Vyberte kartu Source Code Management (Správa zdrojového kódu). Povolte Git a jako hodnotu Repository URL (Adresa URL úložiště) zadejte následující adresu URL: . Pak změňte specifikátor větve na .

    Definování úložiště Git

  4. Vyberte kartu Build (Sestavení) a pak vyberte Add build step (Přidat krok sestavení).

    Přidání nového kroku sestavení

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

    Vyberte možnost Skript Gradle.

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

    Možnosti skriptu Gradle

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

    Pokročilé možnosti skriptu Gradle

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

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

  1. Jakmile se zobrazí domovská stránka projektu, vyberte Build Now (Sestavit). Kód se zkompiluje a ukázková aplikace se zabalí.

    Project domovská stránka

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

    Probíhající sestavování úloh

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

    Vyberte odkaz na pracovní prostor.

  4. Přejděte na complete/build/libs a podívejte se, že .jar se soubor úspěšně sestaví.

    Cílová knihovna ověří úspěšné sestavení.

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

Řešení potíží

Pokud narazíte na problémy s konfigurací Jenkinse, nejnovější pokyny a známé problémy najdete na stránce instalace Jenkinse.

Další kroky