Topic 8: Setup Jenkins Server

- Part 1: รีโมทเข้าเครื่อง Server

  1. เปิดใช้งาน Ubuntu Server ผ่าน VMware

  2. login ด้วย username และ password ที่ใช้ติดตั้ง Ubuntu Server

   3. ใช้คำสั่งตรวจสอบ ip address ของเครื่อง Ubuntu Server คือ

ifconfig

   4. รีโมทเข้าเครื่อง Ubuntu Server

4.1 สำหรับ Windows ให้เปิดโปรแกรม PuTTY ในเครื่องคอมพิวเตอร์ที่ใช้งาน จากนั้นกรอก ip address ขอ เครื่อง Ubuntu Server เลือก SSH และกด open

จากนั้นกรอก username และ password ของ Ubuntu Server

4.2 สำหรับ MAC ให้เปิด Terminal ในเครื่องคอมพิวเตอร์ที่ใช้งาน จากนั้นใช้คำสั่งรีโมทเข้าเครื่อง Server คือ

ssh username@ip_or_domain:port

- Part 2: ติดตั้ง Jenkins

  1. ติดตั้ง Jenkins repository โดยใช้คำสั่ง

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo 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 -y jenkins ant git-core curl unzip

2. เข้า Jenkins ผ่าน url ดังนี้

http://ip_or_domain:8080

 3. จากนั้นเข้าไปยัง path ที่แสดงใน Jenkins เพื่อรับรหัสผ่าน โดยใช้คำสั่ง

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

 จากนั้นกด Continue

4. เลือกติดตั้ง Jenkins แบบ “Install suggested plugins”

 หมายเหตุ: ถ้าหากติดตั้งไม่สำเร็จให้กด Retry อีกครั้ง

 5. จากนั้นเลือก “Continue as admin” เพื่อใช้รหัสเป็น admin และกด “Start using Jenkins”

หมายเหตุ: ในการล๊อกอินเข้า Jenkins ในครั้งต่อไป username คือ admin

อ้างอิง: https://pkg.jenkins.io/debian-stable/

 6. เปลี่ยนรหัสผ่าน เพื่อให้ง่ายต่อการล๊อกอินเข้า Jenkins โดยเข้าไปที่

admin > Configure > Password

7. เปลี่ยนเป็นใช้ผู้ใช้งานแบบ Jenkins โดยใช้คำสั่ง

sudo su jenkins
cd ~

8. บันทึกรหัสผ่านของผู้ใช้งาน Jenkins โดยใช้คำสั่ง

echo 'JCLIUSER=admin' >> ~/.bashrc
echo 'JCLIPASS=YOUR_PASSWORD' >> ~/.bashrc
cat ~/.bashrc
source ~/.bashrc

- Part 3: ติดตั้ง plugins ให้กับ Jenkins เพื่อใช้งาน PHP

  1. ดาวน์โหลด Plugin โดยใช้คำสั่ง

wget http://ip_or_domain:8080/jnlpJars/jenkins-cli.jar
java -jar jenkins-cli.jar -s http://ip_or_domain:8080 install-plugin xunit  --username $JCLIUSER --password $JCLIPASSjava -jar jenkins-cli.jar -s http://ip_or_domain:8080 safe-restart --username $JCLIUSER --password $JCLIPASS
/etc/init.d/jenkins restart

หมายเหตุ: Plugin ที่ใช้งานใน Jenkins สำหรับ PHPUnit คือ xUnit ซึ่งเป็นเครื่องมือที่ใช้ในแสดง report จากการทดสอบของ PHPUnit ใน Jenkins

2. ติดตั้ง Plugins เพิ่มเติม โดยเข้าไปที่

Manage Jenkins > Manage Plugins > Available

จากนั้นค้นหา Plugins และกด “Install without restart”

GitLab Plugins

- Part 4: ติดตั้ง PHP และ extensions

  1. ออกจากผู้ใช้งานแบบ Jenkins โดยใช้คำสั่ง

exit

  2. ดาวน์โหลดและติดตั้ง JDK โดยใช้คำสั่ง

sudo LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
sudo apt-get update 
sudo apt-get install -y openjdk-8-jdk

3. ดาวน์โหลดและติดตั้ง PHP 7.2 โดยใช้คำสั่ง

sudo apt-get install -y php7.2 php7.2-xdebug php7.2-xsl php7.2-dom php7.2-zip php7.2-mbstring php7.2-xml

- Part 5: ติดตั้ง Composer

  1. ดาวน์โหลดและติดตั้ง Composer โดยใช้คำสั่ง

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
sudo chown -R $USER:$USER ~/.composer/

  2. ติดตั้ง Tools ต่าง ๆ โดยเปลี่ยนเป็นใช้ผู้ใช้งานแบบ Jenkins โดยใช้คำสั่ง

sudo su jenkins
cd ~

  3. ดาวน์โหลดและติดตั้ง Composer แบบ global โดยใช้คำสั่ง

composer global require phpunit/phpunit:^6.5

หมายเหตุ: ถ้าหากไม่สามารถติดตั้งได้ให้ update php และเปลี่ยน version ของ php ดังนี้

sudo apt-get install -y php7.2 php7.2-xdebug php7.2-xsl php7.2-dom php7.2-zip php7.2-mbstring php7.2-xml

4. ตรวจสอบการติดตั้ง composer โดยใช้คำสั่ง

cd /var/lib/jenkins/.composermore composer.json
cd ~

5. กำหนด Path ของ Composer ให้กับ Jenkins โดยเข้าไปที่

Manage Jenkins > Configure System > Global properties

เลือก Environment variables และกด Add ในส่วนของ Name ให้ตั้งเป็น “PATH” และในส่วนของ Value กำหนดเป็น “$PATH:vendor/bin:/var/lib/jenkins/.composer/vendor/bin/” จากนั้นกด Save

อ้างอิง: https://modess.io/jenkins-php/