Уже более 4 лет используется Jenkins для публикации проектов, и было сделано множество улучшений, чтобы минимизировать настройку Jenkins и написание сценариев выпуска. от начального构建一个自由风格的软件项目
прибыть流水线项目
до сих пор流水线+docker
, конвейер может сделать процесс выпуска проекта более понятным,docker
можно значительно сократитьJenkins
конфигурация.
Далее будет показан самый простой и быстрый способ использования Jenkins, не нужно настраивать git, maven, jdk, node и другие среды, все делается с помощью докера, вам нужно только писать скрипты, а другие не нужно настраивать
Это руководство является только расширенным руководством.Для конкретной установки jenkins, настройки учетных данных git, отправки электронной почты и т. д. вам необходимо найти руководство по настройке.
Среда, используемая в этом руководстве
- centos7
- docker-ce 18.09.1 (необходимо использовать docker-ce, старая версия docker сделает демон docker недоступным в Jenkins)
Готов к работе
установить докер
yum install docker-ce
Настройте ускоритель Docker (необязательно)
很多厂商都提供docker加速服务,比如阿里云,腾讯云 详情请自行百度。不配置国内加速器,下载镜像可能很缓慢。
Установите Дженкинс с помощью докера
docker pull jenkins/jenkins,切勿docker pull jenkins已经废弃
Начать Дженкинс
docker run -u root -itd --name jenkins -p 6001:8080 -v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime:ro -v /volume1/docker/jenkins:/var/jenkins_home jenkins/jenkins
Значение команды запуска
-p 6001:8080
Порт доступа к веб-странице Jenkins по умолчанию — 8080, что сопоставляет порт с внешним хостом.
-v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock
Сделать команды докера доступными внутри Jenkins
-e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime:ro
Настройте часовой пояс контейнера Jenkins.
-v /volume1/docker/jenkins:/var/jenkins_home
Сопоставьте конфигурацию Jenkins с внешним томом хоста, удаление контейнера по-прежнему сохраняет конфигурацию
Войдите в контейнер Jenkins, чтобы определить, выполняется ли команда docker нормально.
docker exec -it jenkins bash
docker info
Вам может потребоваться установить libltdl7, если вам нужно выполнить следующую команду
apt-get update
apt-get install -y libltdl7
Настроить Дженкинс
http://主机IP:6001
Доступ к веб-странице Jenkins возможен, другие процессы игнорируются, и все они могут быть установлены по умолчанию.
Не нужно настраивать git, maven, jdk, node и другие среды, мы используем docker для решения
Создайте новый проект трубопровода
Существует два способа написания скриптов пайплайна, официальных документов
Использование Docker с Pipeline, официальная документация
писать сценарии
Поделитесь сценарием выпуска моего собственного проекта, подходящего для проектов с весенней загрузкой, детали необходимо изменить самостоятельно. Этот сценарий должен использовать Dockfile, см. следующий раздел.
import java.text.SimpleDateFormat
node {
try {
//名字这么写是为了可以发布到腾讯docker仓库,可随意更改
def dockerId='tengxun'
def dockerUrl='ccr.ccs.tencentyun.com'
def dockerNamespace='esms'
def dockerName='esms-api'
def env='test'
def dateFormat = new SimpleDateFormat("yyyyMMddHHmm")
def dockerTag = dateFormat.format(new Date())
stage('git pull'){
sh 'pwd'
git credentialsId: '此处填写git凭证,需要在Jenkins凭据中配置', url: '此处填写git地址'
}
stage('mvn install') {
sh 'pwd'
docker.image('maven:3.6.0-jdk-8-alpine').inside('-v /volume1/docker/.m2:/root/.m2') {
sh 'mvn --version'
sh 'mvn clean install'
}
}
stage('docker run') {
dir("esms-main") {
sh 'pwd'
def imageUrl = "${dockerUrl}/${dockerNamespace}/${dockerName}:${dockerTag}"
def customImage = docker.build(imageUrl)
sh "docker rm -f ${dockerName} | true"
//--network esms-net配置网络信息,需要先docker network create esms-net,用于多个服务交互,可选
customImage.run("-it -d --name ${dockerName} -p 8090:8090 --network esms-net -e SPRING_PROFILES_ACTIVE=${env}")
//only retain last 3 images,自动删除老的容器,只保留最近3个
sh """docker rmi \$(docker images | grep ${dockerName} | sed -n '4,\$p' | awk '{print \$3}') || true"""
}
}
currentBuild.result="SUCCESS"
} catch (e) {
currentBuild.result="FAILURE"
throw e
} finally {
//此处若想发布邮件,需要在系统管理-系统设置中配置邮件服务器
mail to: 'xxxx@qq.com',subject: "Jenkins: ${currentBuild.fullDisplayName},${currentBuild.result}",body:"${currentBuild.result}"
}
}
После окончательного релиза посмотрите на образы докеров, формат имени аналогичен следующему, например, имя после выпуска приведенного выше кода будет
ccr.ccs.tencentyun.com/esms/esms-api
Структура проекта Spring Boot и файл Dockerfile
Написание Dockerfile, только для справки, в соответствии с вашей собственной структурой проекта
FROM openjdk:8-jdk-alpine
MAINTAINER liunewshine@qq.com
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone && mkdir -p /esms
WORKDIR /esms
EXPOSE 8090
ADD ./target/esms.jar ./
CMD java -Djava.security.egd=file:/dev/./urandom -jar esms.jar
Опубликовать проект
Вы можете создать его напрямую, не выполняя git webhook, вы не можете связать git push и т. д. Вы можете добавить его самостоятельно, если вам это нужно.
Суммировать
В целом процесс очень простой, главное установить Jenkins -> написать скрипты пайплайна -> написать скрипты Dockerfile.