[ 實戰 CI / CD Pipeline ] Jenkins + Ansible + Windows Host

前言

CI / CD Pipeline 該怎麼建 !?

Pipeline 工具該怎麼選擇 !?

該找誰負責 Devs、QAs、Ops !?

老天 : 去看書 !

自動化、可視化、快速回饋

CI / CD 常見的工具有:

• Jenkins
• GitLab CI
• AWS CodePipeline
• Azure DevOps
• Travis CI
• Circle CI
• Drone CI
• …

該選誰呢...?

不管了 !!

先從最老工具的開始練習~~

持續整合一哥 --------- Jenkins

Environment Requirements :

• Jenkins + Ansible (Ubuntu 16.04)
• Remote Host ( Windows 10 )

======== 實驗開始 ========

Jenkins Installation

jenkins-ci.org
jenkins.io
pkg.jenkins.io

Blue Ocean --- Pipeline可視化
AnsiColor --- Logging colors display
Ansible-plugin

讓 Jenkins account 擁有 sudo 權限 ( 不須可跳過 )

1. sudo vim /etc/sudoers
2. add "Jenkins ALL=(ALL) NOPASSWPRD: ALL"

Ansible 2.9.0 Installation

安裝 Windows Remote Control Packages

pip install pywinrm

# create ansible folder
mkdir ansible
cd ansible

vim ansible.cfg

[defaults]
inventory = inventory
log_path = ansible.log

PS C:\Users\Wis> Get-ExecutionPolicy
RemoteSigned

winrm quickconfig
# Enable WinRm Auth
winrm set winrm/config/service/auth '@{Basic="true"}'
# Enable Allow Un-encrypt
winrm set winrm/config/service '@{AllowUnencrypted="true"}'
# Verify WinRm Listener
winrm enumerate winrm/config/listener

vim inventory

[windows]  # group name
win10 ansible_host=10.1.2.1
[windows:vars]  # define variable for windows group
ansible_user=win_user
ansible_password=win_password
ansible_port=5985
ansible_connection=winrm
ansible_winrm_server_cert_validation=ignore

測試一下 Ansible 連線

$> ansible windows -m win_ping
win10 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
連線成功囉!!

Ansible - 資料夾結構

- Jenkinsfile
- ansible
    - ansible.cfg
    - inventory
    - playbook.yml
    - remote_run.py

vim playbook.yml

- hosts: windows
  gather_facts: no
vars:
    py_src_name: remote_run.py
    py_dst_dir: C:\temp\ansible
tasks:
    - name: Create folder on remote host
      win_file:
        path: '{{ py_dst_dir }}'
        state: directory
- name: Copy python file to remote host
      win_copy:
        src: '{{ py_src_name }}'
        dest: '{{ py_dst_dir }}\{{ py_src_name }}'
- name: Execute python program
      win_shell: python '{{ py_dst_dir }}\{{ py_src_name }}'

vim remote_run.py

import time
for i in range(5):
    print("this is loop [{}]".format(i))
    time.sleep(1)

測試一下 Ansible Playbook

# 最後補上 -vvv 可顯示 debug info
ansible-playbook playbook.yml

pipeline {
  agent any
  stages {
    stage('Windows Host Step') {
        steps{
          dir(path: 'ansible') {
            ansiColor(colorMapName: 'xterm') {
              ansiblePlaybook(
                playbook: 'playbook.yml',
                inventory: 'inventory',
                colorized: true)
            }
          }
        }
    }
  }
}

• 自動化 - 未來加入更多自動化測試與工作流程。
• 工作流程可視化 - 藉由 Blue Ocean 的介面，可以得知 Pipeline 的狀態。
• 快速回饋 - 藉由每次的 Code Commit 觸發一個 Jenkins CI Run 達成快速回饋的機制。

Reference:

• DevOps Handbook中文版｜打造世界級技術組織的實踐指南
• Ansible: 建置與執行（二版）
• 現代 IT 人一定要知道的 Ansible 自動化組態技巧
• Ansible — Windows Guides