Jenkins用户手册官网地址：点击打开

开源 CI&CD 软件
自动化各种任务, build test deploy
支持各种运行方式

Jenkins入门

入门指南

需要java和docker
安装命令
```
java -jar jenkins.war --httpPort=8080
```
打开浏览器进入链接 http://localhost:8080

创建 Hello World 流水线

pipline是一套插件，持续交付 Pipeline 自动化表达了这样一种流程：将基于版本控制管理的软件持续的交付到您的用户和消费者手中
pipline的定义通常被写入到一个文本文件中：Jenkinsfile
New Item -> Pipeline(一般)/Multibranch Pipeline(基于scm仓库)
SCM: Source Code Management
在配置好 Pipeline 之后，Jenkins 会自动检测您仓库中创建的任何新的分支或合并请求，并开始为它们运行 Pipelines

文本示例

// java
Jenkinsfile (Declarative Pipeline)
pipeline {
    agent { docker 'maven:3.3.3' }
    stages {
        stage('build') {
            steps {
                sh 'mvn --version'
            }
        }

# python
Jenkinsfile (Declarative Pipeline)
pipeline {
    agent { docker 'python:3.5.1' }
    stages {
        stage('build') {
            steps {
                sh 'python --version'
            }
        }
    }
}

执行多个步骤

在 Linux、BSD 和 Mac OS（类 Unix ) 系统中的 shell 命令，对应于 Pipeline 中的一个 sh 步骤（step）

Jenkinsfile (Declarative Pipeline)
pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo "Hello World"'
                sh '''
                    echo "Multiline shell steps works too"
                    ls -lah
                '''
            }
        }
    }
}

基于 Windows 的系统使用 bat 步骤表示执行批处理命令

Jenkinsfile (Declarative Pipeline)
pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                bat 'set'
            }
        }
    }
}

pipline的步骤支持重试、超时等

Jenkinsfile (Declarative Pipeline)
pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                retry(3) {
                    sh './flakey-deploy.sh'
                }

                timeout(time: 3, unit: 'MINUTES') {
                    sh './health-check.sh'
                }
            }
        }
    }
}

// 重试部署任务 5 次，但是总共花费的时间不能超过 3 分钟
Jenkinsfile (Declarative Pipeline)
pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                timeout(time: 3, unit: 'MINUTES') {
                    retry(5) {
                        sh './flakey-deploy.sh'
                    }
                }
            }
        }
    }
}

定义执行环境

所有的Pipeline都需要 agent 指令

agent {
    docker { image 'node:7-alpine' }
}

当执行Pipeline时，Jenkins将会自动运行指定的容器
在Pipeline中，混合和搭配不同的容器或者其他代理可以获得更大的灵活性

使用环境变量

全局变量和stage变量

Jenkinsfile (Declarative Pipeline)
pipeline {
    agent any

    environment {
        DISABLE_AUTH = 'true'
        DB_ENGINE    = 'sqlite'
    }

    stages {
        stage('Build') {
            steps {
                sh 'printenv'
            }
        }
    }
}

环境变量的另一个常见用途是设置或者覆盖构建或测试脚本中的凭证

记录测试和构建结果

Jenkins 通常与 junit 步骤捆绑在一起
Jenkins 会持续跟踪并计算测试的趋势和结果
如果存在失败的测试用例，Pipeline 会被标记为 “UNSTABLE”，在网页上用黄色表示
Jenkins 内置支持存储构建结果报告，在 Pipeline 执行期间生成记录文件

清理和通知

post 部分保证在 Pipeline 结束的时候运行

发邮件

post {
    failure {
        mail to: '[email protected]',
             subject: "Failed Pipeline: ${currentBuild.fullDisplayName}",
             body: "Something is wrong with ${env.BUILD_URL}"
    }
}

部署

大多数最基本的持续交付 Pipeline 至少会有三个阶段：构建、测试和部署
使用 input 步骤，支持人工确认是否可以继续运行

教程

持续集成(CI) / 持续交付 (CD)
在Docker中运行Jenkins。将Jenkins作为 Docker 容器并从 jenkinsci/blueocean Docker 镜像中运行
在docker run 添加--name jenkins-tutorials，可以通过docker exec -it jenkins-tutorials bash来访问Jenkins/Blue Ocean 容器
安装步骤：解锁 Jenkins -> 使用插件自定义 Jenkins -> 创建第一个管理员用户 -> Start using Jenkins
停止ctrl+c，重启docker run
创建好pipline后，就会生成Jenkinsfile，这些文件会被添加到你的本地仓库
pipline会使用Jenkins中的Maven自动构建你的Java应用程序
"Pipeline-as-Code"，将持续交付流水线作为应用程序的一部分，与其他代码一样进行版本控制和审查
Maven容器
Docker主机的文件系统在每次重启Docker时都会被清除
Build 阶段，Maven会下载构建你的Java应用所需的工件，这些工件最终会被保存在Jenkins的本地Maven仓库中（Docker的主机文件系统）
一般的原则是，尽量保持你的流水线代码（即 Jenkinsfile）越简洁越好，将更复杂的构建步骤放在多个独立的shell脚本中（尤其对于那些包含2个以上steps的stage）
使用npm构建Node.js和React应用，使用PyInstaller构建Python应用，类似
Where do you store your code? GitHub
通过Blue Ocean创建的流水线项目实际上是 "多分支流水线"
使用Blue Ocean生成Pipeline更多的是UI层面的操作
git checkout master
多分支pipline Where do you store your code?,点击 Git (not GitHub)

when 指令 (和它们的branch 条件一起)决定是否 stages (包括这些 when 指令) 会被执行。如果 branch 条件的值(即模式) 与Jenkins运行构建的分支名匹配, 包含 when 和 branch 概念的stage 就会被执行

stage('Deliver for development') {
            when {
                branch 'development' 
            }
            steps {
                sh './jenkins/scripts/deliver-for-development.sh'
                input message: 'Finished using the web site? (Click "Proceed" to continue)'
                sh './jenkins/scripts/kill.sh'
            }
        }
        stage('Deploy for production') {
            when {
                branch 'production'  
            }
            steps {
                sh './jenkins/scripts/deploy-for-production.sh'
                input message: 'Finished using the web site? (Click "Proceed" to continue)'
                sh './jenkins/scripts/kill.sh'
            }
        }

每个分支都会在Jenkins的主目录中有他自己的工作区目录，意味着资源需要重新下载
Chrome: chrome://serviceworker-internals/
Firefox: about:serviceworkers

用户手册

Docker容器实际上是Docker镜像的“运行实例”，镜像永久存储（只要镜像更新发布），而容器暂时存储
建议使用的Docker镜像是jenkinsci/blueocean image(来自 the Docker Hub repository)
Jenkins控制台日志 docker logs <docker-container-name> 可以使用docker ps 命令获得docker-container-name
Jenkins主目录docker exec -it <docker-container-name> bash
credentials用于访问控制
为了最大限度地提高安全性，在Jenins中配置的 credentials 以加密形式存储在Jenkins 主节点上（用Jenkins ID加密），并且只能通过 credentials ID在Pipeline项目中获取
创建 Jenkinsfile并提交它到源代码控制中提供了一些即时的好处：
- 自动地为所有分支创建流水线构建过程并拉取请求。
- 在流水线上代码复查/迭代 (以及剩余的源代码)。
- 对流水线进行审计跟踪。
- 该流水线的真正的源代码 [3], 可以被项目的多个成员查看和编辑。
本质上，Jenkins 是一个自动化引擎
pipline流水线
声明式流水线语法和脚本化流水线语法
DSL domain-specific language 领域特定语言
创建pipline的方式：Blue Ocean、UI、Jenkinsfile
通过UI创建pipline，Jenkinsfile是存储在Jenkins主目录的，而其他2种方式是存储在源代码目录的
Pipeline script from SCM
当你更新指定的仓库时，只要流水线配置了版本管理系统的轮询触发器，就会触发一个新的构建
全局变量 env params currentBuild
Directive Generator指令生成器
Groovy
Jenkinsfile 文件不能替代现有的构建工具，如 GNU/Make、Maven、Gradle 等，而应视其为一个将项目的开发生命周期的多个阶段（构建、测试、部署等）绑定在一起的粘合层
currentBuild.result 变量确定是否有任何测试的失败 currentBuild.result == null || currentBuild.result == 'SUCCESS'
如果任务试图从流水线中显示这些凭据变量的值（如 echo $AWS_SECRET_ACCESS_KEY），Jenkins 只会返回 “****” 来降低机密信息被写到控制台输出和任何日志中的风险
不要允许不受信任的流水线任务使用受信任的凭据
通过 post节段支持强大的故障处理
SSH https://jenkins.io/zh/doc/book/pipeline/jenkinsfile/
Multibranch Pipeline
周期性地重新索引有助于配置多分支流水线

docker args设置缓存

docker {
            image 'maven:3-alpine'
            args '-v $HOME/.m2:/root/.m2'
        }

Docker Label是一个全局选项，用来指定运行基于Docker的流水线的代理
Docker注册表
共享库，在多个项目之间共享流水线有助于减少冗余并保持代码 "DRY"
Blue Ocean Pipeline Editor
"replay" Pipeline Runs with Modifications
流水线的主要瓶颈之一是它经常将临时数据写入磁盘，以便于运行流水线能够处理意外的Jenkins重启或系统崩溃。对于许多用户来说，这种持久性是有用，但是它的性能成本是一个问题
Blue Ocean 这个名字来自书籍 Blue Ocean Strategy
Blue Ocean 旨在为pipeline 提供绝佳的体验
Dashboard
Health icon
JNLP
文件访问规则可用于验证从代理到主服务器的文件访问请求
Jenkins CLI
大多数脚本默认在Groovy沙箱运行，包括所有的Jenkins流水线
Groovy是一种基于JVM（Java虚拟机）的敏捷开发语言
两个轴是正交的
servlet容器
禁用安全
结束，这玩意感觉是english直接通过google translate过来的！

版权申明：本文为博主原创文章，转载请保留原文链接及作者。

点读系列《Jenkins用户文档》