Průvodce instalací Jenkins krok za krokem
V tomto článku si ukážeme, jak nainstalovat Jenkins na různé operační systémy.
Přestože se postupy instalace mírně liší v závislosti na operačním systému, konfigurace Jenkins je ve všech případech stejná.
Co je to Jenkins?
Jenkins je open-source nástroj pro automatizaci, určený pro vývojáře k zjednodušení práce na projektech a aplikacích. Je využíván k vytváření a nasazování softwaru. Jedná se o silnou automatizační platformu, která umožňuje kontinuální integraci a dodávání bez ohledu na platformu.
Jelikož je Jenkins aplikací napsanou v jazyce Java, je schopen běžet na jakémkoli počítači s nainstalovaným Java Runtime Environment (JRE).
Pokud se chcete naučit používat Jenkins, doporučujeme online kurz, který vás provede od základů až po pokročilé techniky.
Požadavky
Pro všechny operační systémy je vyžadována instalace JDK8 nebo novější. Nejprve je tedy potřeba stáhnout a nainstalovat příslušnou verzi JDK. Můžete ji získat zde.
Instalace Jenkins na Windows
Po úspěšné instalaci a spuštění JDK můžete přistoupit ke stažení a instalaci samotného Jenkins. Nejnovější instalační balíček Jenkins MSI pro Windows naleznete zde.
- Pro zahájení instalace dvakrát klikněte na soubor
jenkins.msi. - Klikněte na „Další“ a poté na „Instalovat“.
- Pokud chcete instalovat do jiného adresáře, klikněte na „Změnit“. V tomto příkladu ponecháme výchozí nastavení a klikneme na „Další“.
- Po dokončení instalace klikněte na „Dokončit“.
Jak vidíte, instalace Jenkinse na Windows je velmi jednoduchá a probíhá podobně jako instalace jiného běžného softwaru.
Instalace Jenkins na Ubuntu
Jak už bylo zmíněno, ujistěte se, že máte na Ubuntu nainstalován a spuštěn JDK8+. Pokud tomu tak není, použijte následující příkaz pro instalaci:
sudo apt install default-jdk-headless
[email protected]:~$ sudo apt install default-jdk-headless Reading package lists... Done Building dependency tree Reading state information... Done The following NEW packages will be installed: default-jdk-headless 0 upgraded, 1 newly installed, 0 to remove and 102 not upgraded. Need to get 1132 B of archives. After this operation, 6144 B of additional disk space will be used. Get:1 http://archive.ubuntu.com/ubuntu bionic-updates/main amd64 default-jdk-headless amd64 2:1.11-68ubuntu1~18.04.1 [1132 B] Fetched 1132 B in 2s (676 B/s) Selecting previously unselected package default-jdk-headless. (Reading database ... 30061 files and directories currently installed.) Preparing to unpack .../default-jdk-headless_2%3a1.11-68ubuntu1~18.04.1_amd64.deb ... Unpacking default-jdk-headless (2:1.11-68ubuntu1~18.04.1) ... Setting up default-jdk-headless (2:1.11-68ubuntu1~18.04.1) ... [email protected]:~$
Pro ověření úspěšné instalace Javy použijte příkaz:
java --version
[email protected]:~$ java -version openjdk version "11.0.7" 2020-04-14 OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-2ubuntu218.04) OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-2ubuntu218.04, mixed mode, sharing) [email protected]:~$
Jakmile máte Javu nainstalovanou, můžete pokračovat v instalaci Jenkins.
Postup instalace:
Krok 1: Otevřete terminál (Ctrl + Alt + T).
Krok 2: Pro instalaci Jenkinse přidejte do systému klíč úložiště:
wget -q -O - http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key | sudo apt-key add -
[email protected]:~$ wget -q -O - http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key | sudo apt-key add - OK [email protected]:~$
Krok 3: Po přidání klíče musíme přidat adresu úložiště balíčku Debian do systému.
sudo sh -c 'echo deb http://pkg.jenkins-ci.org/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
Krok 4: Aktualizujte seznam balíčků Ubuntu.
sudo apt update
[email protected]:~$ sudo apt update Hit:1 http://archive.ubuntu.com/ubuntu bionic InRelease Get:2 http://archive.ubuntu.com/ubuntu bionic-updates InRelease [88.7 kB] Ign:3 http://pkg.jenkins-ci.org/debian-stable binary/ InRelease Get:4 http://pkg.jenkins-ci.org/debian-stable binary/ Release [2044 B] Get:5 http://pkg.jenkins-ci.org/debian-stable binary/ Release.gpg [195 B] Get:6 http://archive.ubuntu.com/ubuntu bionic-backports InRelease [74.6 kB] Get:7 http://archive.ubuntu.com/ubuntu bionic/universe amd64 Packages [8570 kB] Get:8 http://pkg.jenkins-ci.org/debian-stable binary/ Packages [17.6 kB] Get:9 http://security.ubuntu.com/ubuntu bionic-security InRelease [88.7 kB] Get:10 http://security.ubuntu.com/ubuntu bionic-security/main amd64 Packages [748 kB] Get:11 http://security.ubuntu.com/ubuntu bionic-security/main Translation-en [237 kB] Get:12 http://security.ubuntu.com/ubuntu bionic-security/restricted amd64 Packages [50.8 kB] Get:13 http://security.ubuntu.com/ubuntu bionic-security/restricted Translation-en [12.3 kB] Get:14 http://security.ubuntu.com/ubuntu bionic-security/universe amd64 Packages [673 kB] Get:15 http://security.ubuntu.com/ubuntu bionic-security/universe Translation-en [223 kB] Get:16 http://security.ubuntu.com/ubuntu bionic-security/multiverse amd64 Packages [7808 B] Get:17 http://security.ubuntu.com/ubuntu bionic-security/multiverse Translation-en [2856 B] Get:18 http://archive.ubuntu.com/ubuntu bionic/universe Translation-en [4941 kB] Get:19 http://archive.ubuntu.com/ubuntu bionic/multiverse amd64 Packages [151 kB] Get:20 http://archive.ubuntu.com/ubuntu bionic/multiverse Translation-en [108 kB] Get:21 http://archive.ubuntu.com/ubuntu bionic-updates/main amd64 Packages [969 kB] Get:22 http://archive.ubuntu.com/ubuntu bionic-updates/main Translation-en [329 kB] Get:23 http://archive.ubuntu.com/ubuntu bionic-updates/restricted amd64 Packages [60.5 kB] Get:24 http://archive.ubuntu.com/ubuntu bionic-updates/restricted Translation-en [14.7 kB] Get:25 http://archive.ubuntu.com/ubuntu bionic-updates/universe amd64 Packages [1085 kB] Get:26 http://archive.ubuntu.com/ubuntu bionic-updates/universe Translation-en [337 kB] Get:27 http://archive.ubuntu.com/ubuntu bionic-updates/multiverse amd64 Packages [15.9 kB] Get:28 http://archive.ubuntu.com/ubuntu bionic-updates/multiverse Translation-en [6420 B] Get:29 http://archive.ubuntu.com/ubuntu bionic-backports/main amd64 Packages [7516 B] Get:30 http://archive.ubuntu.com/ubuntu bionic-backports/main Translation-en [4764 B] Get:31 http://archive.ubuntu.com/ubuntu bionic-backports/universe amd64 Packages [7484 B] Get:32 http://archive.ubuntu.com/ubuntu bionic-backports/universe Translation-en [4436 B] Fetched 18.8 MB in 58s (327 kB/s) Reading package lists... Done Building dependency tree Reading state information... Done 102 packages can be upgraded. Run 'apt list --upgradable' to see them. [email protected]:~$
Krok 5: Nakonec nainstalujte Jenkins pomocí příkazu:
sudo apt install jenkins
[email protected]:~$ sudo apt install jenkins Reading package lists... Done Building dependency tree Reading state information... Done The following additional packages will be installed: daemon The following NEW packages will be installed: daemon jenkins 0 upgraded, 2 newly installed, 0 to remove and 102 not upgraded. Need to get 65.7 MB of archives. After this operation, 66.8 MB of additional disk space will be used. Do you want to continue? [Y/n] Y Get:1 http://archive.ubuntu.com/ubuntu bionic/universe amd64 daemon amd64 0.6.4-1build1 [99.5 kB] Get:2 http://pkg.jenkins-ci.org/debian-stable binary/ jenkins 2.235.1 [65.6 MB] Fetched 65.7 MB in 3min 34s (307 kB/s) Selecting previously unselected package daemon. (Reading database ... 29242 files and directories currently installed.) Preparing to unpack .../daemon_0.6.4-1build1_amd64.deb ... Unpacking daemon (0.6.4-1build1) ... Selecting previously unselected package jenkins. Preparing to unpack .../jenkins_2.235.1_all.deb ... Unpacking jenkins (2.235.1) ... Setting up daemon (0.6.4-1build1) ... Setting up jenkins (2.235.1) ... invoke-rc.d: could not determine current runlevel Processing triggers for systemd (237-3ubuntu10.39) ... Processing triggers for man-db (2.8.3-2ubuntu0.1) ... Processing triggers for ureadahead (0.100.0-21) ... [email protected]:~$
Jenkins je nyní úspěšně nainstalován. Můžete spustit Jenkins server.
Krok 6: Spusťte Jenkins pomocí systemctl příkazu:
sudo systemctl start jenkins
Protože systemctl nezobrazuje výstup, můžete zkontrolovat stav pomocí:
sudo systemctl status jenkins
[email protected]:~$ sudo systemctl status jenkins
● jenkins.service - LSB: Start Jenkins at boot time
Loaded: loaded (/etc/init.d/jenkins; generated)
Active: active (exited) since Sat 2020-04-04 10:10:19 UTC; 2 months 16 days ago
Docs: man:systemd-sysv-generator(8)
Tasks: 0 (limit: 4915)
CGroup: /system.slice/jenkins.service
Apr 04 10:10:18 ip-172-31-17-25 systemd[1]: Starting LSB: Start Jenkins at boot time...
Apr 04 10:10:18 ip-172-31-17-25 jenkins[1984]: Correct java version found
Apr 04 10:10:18 ip-172-31-17-25 jenkins[1984]: * Starting Jenkins Automation Server jenkins
Apr 04 10:10:18 ip-172-31-17-25 su[2037]: Successful su for root by root
Apr 04 10:10:18 ip-172-31-17-25 su[2037]: + ??? root:root
Apr 04 10:10:18 ip-172-31-17-25 su[2037]: pam_unix(su:session): session opened for user root by (uid=0)
Apr 04 10:10:18 ip-172-31-17-25 jenkins[1984]: mesg: ttyname failed: Inappropriate ioctl for device
Apr 04 10:10:18 ip-172-31-17-25 su[2037]: pam_unix(su:session): session closed for user root
Apr 04 10:10:19 ip-172-31-17-25 jenkins[1984]: ...done.
Apr 04 10:10:19 ip-172-31-17-25 systemd[1]: Started LSB: Start Jenkins at boot time.
[email protected]:~$
Krok 7: Konfigurace portu (volitelné)
Ve výchozím nastavení je Jenkins spuštěn na portu 8080, který je nutné zpřístupnit. Pro otevření portu použijte:
sudo ufw allow 8080
Stav portu ověříte příkazem:
sudo ufw status
[email protected]:~$ sudo ufw status Status: active To Action From -- ------ ---- 8080 ALLOW Anywhere 8080 (v6) ALLOW Anywhere (v6) [email protected]:~$
Pokud je firewall neaktivní, aktivujte jej pomocí:
sudo ufw allow OpenSSH
a následně
sudo ufw enable
Instalace Jenkins na CentOS
Stejně jako u Ubuntu, nejprve se ujistěte, že máte nainstalovaný JDK8+. Pokud ne, nainstalujte jej příkazem pro OpenJDK 8:
sudo yum install java-1.8.0-openjdk-devel[[email protected] ~]$ sudo yum install java-1.8.0-openjdk-devel CentOS-8 - AppStream 1.0 kB/s | 4.3 kB 00:04 CentOS-8 - AppStream 397 kB/s | 5.8 MB 00:14 CentOS-8 - Base 3.5 kB/s | 3.9 kB 00:01 CentOS-8 - Extras 547 B/s | 1.5 kB 00:02 Jenkins-stable 6.5 kB/s | 2.9 kB 00:00 Dependencies resolved. ================================================================================ Package Arch Version Repository Size ================================================================================ Installing: java-1.8.0-openjdk-devel x86_64 1:1.8.0.252.b09-3.el8_2 AppStream 9.8 M Transaction Summary ================================================================================ Install 1 Package Total download size: 9.8 M Installed size: 41 M Is this ok [y/N]: y Downloading Packages: java-1.8.0-openjdk-devel-1.8.0.252.b09-3.el8_2. 531 kB/s | 9.8 MB 00:18 -------------------------------------------------------------------------------- Total 507 kB/s | 9.8 MB 00:19 Running transaction check Transaction check succeeded. Running transaction test Transaction test succeeded. Running transaction Preparing : 1/1 Installing : java-1.8.0-openjdk-devel-1:1.8.0.252.b09-3.el8_2.x86 1/1 Running scriptlet: java-1.8.0-openjdk-devel-1:1.8.0.252.b09-3.el8_2.x86 1/1 Verifying : java-1.8.0-openjdk-devel-1:1.8.0.252.b09-3.el8_2.x86 1/1 Installed products updated. Installed: java-1.8.0-openjdk-devel-1:1.8.0.252.b09-3.el8_2.x86_64 Complete! [[email protected] ~]$
Úspěšnou instalaci Javy můžete ověřit příkazem:
java -version[[email protected] ~]$ java -version openjdk version "1.8.0_252" OpenJDK Runtime Environment (build 1.8.0_252-b09) OpenJDK 64-Bit Server VM (build 25.252-b09, mixed mode) [[email protected] ~]$
Po instalaci Javy můžete přistoupit k instalaci Jenkins.
Postup instalace
Krok 1: Otevřete terminál.
Krok 2: Pro instalaci Jenkinse je potřeba nejdříve stáhnout a přidat GPG klíč Jenkins:
sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo[[email protected] ~]$ sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo --2020-06-21 04:29:52-- http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo Resolving pkg.jenkins-ci.org (pkg.jenkins-ci.org)... 52.202.51.185, 64:ff9b::34ca:33b9 Connecting to pkg.jenkins-ci.org (pkg.jenkins-ci.org)|52.202.51.185|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 85 Saving to: ‘/etc/yum.repos.d/jenkins.repo’ /etc/yum.repos.d/je 100%[==================>] 85 --.-KB/s in 0s 2020-06-21 04:29:54 (2.61 MB/s) - ‘/etc/yum.repos.d/jenkins.repo’ saved [85/85] [[email protected] ~]$
Krok 3: Importujte Jenkins GPG klíč:
sudo rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.keyKrok 4: Aktualizujte balíčky CentOS:
sudo yum update[[email protected] ~]$ sudo yum update Last metadata expiration check: 0:17:09 ago on Sun 21 Jun 2020 04:21:20 AM PDT. Dependencies resolved. Nothing to do. Complete! [[email protected] ~]$
Krok 5: Po aktualizaci můžete nainstalovat Jenkins:
sudo yum install jenkins[[email protected] ~]$ sudo yum install jenkins Last metadata expiration check: 0:19:26 ago on Sun 21 Jun 2020 04:21:20 AM PDT. Dependencies resolved. =============================================================================== Package Architecture Version Repository Size =============================================================================== Installing: jenkins noarch 2.235.1-1.1 jenkins 63 M Transaction Summary =============================================================================== Install 1 Package Total download size: 63 M Installed size: 63 M Is this ok [y/N]: y Downloading Packages: jenkins-2.235.1-1.1.noarch.rpm 172 kB/s | 63 MB 06:16 ------------------------------------------------------------------------------- Total 172 kB/s | 63 MB 06:16 Running transaction check Transaction check succeeded. Running transaction test Transaction test succeeded. Running transaction Preparing : 1/1 Running scriptlet: jenkins-2.235.1-1.1.noarch 1/1 Installing : jenkins-2.235.1-1.1.noarch 1/1 Running scriptlet: jenkins-2.235.1-1.1.noarch 1/1 Verifying : jenkins-2.235.1-1.1.noarch 1/1 Installed products updated. Installed: jenkins-2.235.1-1.1.noarch Complete! [[email protected] ~]$
Krok 6: Spusťte Jenkins pomocí systemctl:
sudo systemctl start jenkinsPro kontrolu stavu použijte:
sudo systemctl status jenkins
[[email protected] ~]$ sudo systemctl status jenkins
[sudo] password for etechblog.cz:
● jenkins.service - LSB: Jenkins Automation Server
Loaded: loaded (/etc/rc.d/init.d/jenkins; generated)
Active: active (running)
Docs: man:systemd-sysv-generator(8)
Jun 20 11:15:22 localhost.localdomain systemd[1]: Starting LSB: Jenkins Automa>
Jun 20 11:15:23 localhost.localdomain runuser[1456]: pam_unix(runuser:session)>
Jun 20 11:15:33 localhost.localdomain jenkins[1433]: Starting Jenkins [ OK ]
Jun 20 11:15:33 localhost.localdomain systemd[1]: Started LSB: Jenkins Automat>
Jun 21 04:23:04 localhost.localdomain systemd[1]: Stopping LSB: Jenkins Automa>
[[email protected] ~]$
Krok 7: Konfigurace portu (volitelné)
Ve výchozím stavu běží Jenkins na portu 8080, který je nutné zpřístupnit. Pro otevření portu použijte:
sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp[[email protected] ~]$ sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp success [[email protected] ~]$
Po konfiguraci portu je nutné znovu načíst firewall:
sudo firewall-cmd --reload[[email protected] ~]$ sudo firewall-cmd --reload success [[email protected] ~]$
Konfigurace Jenkinse
Po instalaci Jenkins běží na portu 8080. Pro konfiguraci přejděte ve vašem webovém prohlížeči na adresu http://localhost:8080.
Krok 1: Otevřete http://localhost:8080.
Krok 2: Pro odemčení Jenkins zkopírujte heslo administrátora ze souboru, který se nachází v:
C:Program Files (x86)JenkinssecretsinitialAdminPassword (Windows)
/var/lib/jenkins/secrets/initialAdminPassword (Linux)
Toto heslo vložte do pole Heslo administrátora a klikněte na Pokračovat.
Krok 3: Můžete vybrat, zda chcete nainstalovat navržené pluginy, nebo si vybrat konkrétní pluginy. V tomto případě nainstalujeme navržené pluginy.
Krok 4: Počkejte, dokud se nenainstalují všechny pluginy. Po dokončení instalace klikněte na „Pokračovat“.
Krok 5: Vytvořte profil administrátora pro Jenkins. Zadejte požadované údaje a klikněte na „Uložit a pokračovat“.
Krok 6: Můžete změnit Jenkins URL, ale doporučujeme ponechat výchozí hodnotu http://localhost:8080. Klikněte na „Uložit a dokončit“ a následně na „Začít používat Jenkins“.
Tím je konfigurace dokončena a zobrazí se uvítací stránka Jenkins.
Kroky konfigurace Jenkinse jsou pro všechny operační systémy obdobné. Jediný rozdíl je v kroku 2, kde musíme získat a zadat heslo administrátora. Heslo naleznete v souboru uvedeném v rozhraní „Odemknout Jenkins“.
Závěr
Výše uvedené kroky představují instalaci Jenkinse na vámi preferovaný operační systém. V dalším kroku se můžete naučit, jak vytvořit svůj první Jenkins Pipeline.
Instalace Jenkinse je snadná. Pokud provádíte nastavení pro vzdálený tým, můžete si buď pronajmout cloudový virtuální stroj a nainstalovat Jenkins sami, nebo využít hostingovou platformu Jenkins.