Jenkins 流水线自动化部署 Go 项目
自动化流程
企业里常见的项目自动化流程应该构建机从代码仓拉取代码进行构建,构建完成后会将产物推送到制品库中,比如镜像仓, 然后中间会有测试环境,用于进行自动化测试或人工测试,最后进行远程部署。
项目结构
这里我们用的 Go 的项目结构,它大概的结构应该是下面这样的:
|-- my-app
|-- .gitignore
|-- README.md
|-- LICENSE
|-- go.mod
|-- go.sum
|-- main.go
|-- pkg
|-- ...
项目构建
因为这里构建的是 Go 的项目,如果用到私有库,在 go mod tidy 时会要求提供 Git 凭证,我们可以现在 Jenkins 的凭证管理中创建 Username with password 类型的凭证,其中 Username 就是 GitHub 的用户名,password 则是 GitHub 的 AccessToken,这里主要用到的是 AccessToken,Username 其实并不需要。但在 Jenkins Pipeline 中使用 usernamePassword 时要求同时定义用户名变量名 usernameVariable 和 密码变量名 passwordVariable 。
stage('Build'){
steps{
withCredentials(bindings:[
usernamePassword(credentialsId:'GITHUB_CREDENTIAL',usernameVariable:'GITHUB_USER',passwordVariable:'GITHUB_ACCESS_TOKEN'
)
]){
sh'''
git config --global url."https://${GITHUB_ACCESS_TOKEN}:[email protected]/".insteadOf "https://github.com/"
go mod tidy
go build -o bin/my-app main.go
'''
}
}
}
远程部署
在构建完成后,我们会将构建产物推送到制品库,然后我们可以从制品库中拉取构建产物进行部署测试环境并进行测试,在验证通过后,会从制品库中拉取验证通过的产物进行部署上线。
但在本文中,我们的应用相对简单,可以忽略推送产物到制品库以及中间的测试验证环节,目标是实现构建后立即部署上线。
一般来说,线上环境和构建环境不会是同一台机器,所以这个时候我们需要将构建产物复制到另一台服务器上,然后在另一台服务器上进行部署。
由于需要对另一台服务器进行操作,所以我们需要在 Jenkins 上配置 DEPLOY_HOST、DEPLOY_PORT 和 SSH_CREDENTIAL 三个凭证,其中 DEPLOY_HOST 和 DEPLOY_PORT 是 Secret text 类型的凭证,SSH_CREDENTIAL 是 SSH Username with private key 类型的凭证。
stage('Deploy'){
environment{
DEPLOY_HOST=credentials('DEPLOY_HOST')
DEPLOY_PORT=credentials('DEPLOY_PORT')
}
steps{
withCredentials([
sshUserPrivateKey(credentialsId:'SSH_CREDENTIAL',keyFileVariable:'SSH_KEY',usernameVariable:'SSH_USERNAME'),
]){
sh"""
mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo 'StrictHostKeyChecking no' >> /etc/ssh/ssh_config
cat ${SSH_KEY} > ~/.ssh/id_rsa && chmod 400 ~/.ssh/id_rsa
scp -P ${DEPLOY_PORT} bin/my-app ${SSH_USER}@${DEPLOY_HOST}:/data/my-app
ssh -p ${DEPLOY_PORT} ${SSH_USER}@${DEPLOY_HOST} \"nohup /data/my-app >> /data/my-app.log 2>&1 &\"
"""
}
}
}
部署的步骤主要包括:
- 复制构建产物到部署服务器
- 在部署服务器上执行部署命令,比如 nohup /data/my-app >> /data/my-app.log 2>&1 &
其中简化了一些细节,比如在部署前,我们需要先备份数据。所以这里我们可以写一个复杂的部署脚本 deploy.sh 放在项目中,然后在 Jenkins Pipeline 中使用 scp 将部署脚本文件复制到部署服务器,假设放在 /data/deploy.sh,最后只需 ssh -p ${DEPLOY_PORT} {DEPLOY_HOST} /bin/bash /data/deploy.sh 即可。
完整的 Jenkins Pipeline
pipeline{
agent{
docker{
image'golang:1.15-alpine'
args'-v /data/my-app-cache:/go/.cache'
}
}
options{
timeout(time:20,unit:'MINUTES')
disableConcurrentBuilds()
}
stages{
stage('Build'){
steps{
withCredentials(bindings:[
usernamePassword(credentialsId:'GITHUB_CREDENTIAL',usernameVariable:'GITHUB_USER',passwordVariable:'GITHUB_ACCESS_TOKEN'
)
]){
sh'''
git config --global url."https://${GITHUB_ACCESS_TOKEN}:[email protected]/".insteadOf "https://github.com/"
go mod tidy
go build -o bin/my-app main.go
'''
}
}
}
stage('Deploy'){
environment{
DEPLOY_HOST=credentials('DEPLOY_HOST')
DEPLOY_PORT=credentials('DEPLOY_PORT')
}
steps{
withCredentials([
sshUserPrivateKey(credentialsId:'SSH_CREDENTIAL',keyFileVariable:'SSH_KEY',usernameVariable:'SSH_USERNAME'),
]){
sh"""
mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo 'StrictHostKeyChecking no' >> /etc/ssh/ssh_config
cat ${SSH_KEY} > ~/.ssh/id_rsa && chmod 400 ~/.ssh/id_rsa
scp -P ${DEPLOY_PORT} bin/my-app ${SSH_USER}@${DEPLOY_HOST}:/data/my-app
ssh -p ${DEPLOY_PORT} ${SSH_USER}@${DEPLOY_HOST} \"nohup /data/my-app >> /data/my-app.log 2>&1 &\"
"""
}
}
}
}
}
原文链接:https://juejin.cn/post/6969968007690846238
文章转载:DevOps技术栈
(版权归原作者所有,侵删)
点击下方“阅读原文”查看更多
关键词
服务器上
代码
流水线
凭证
部署服务器
最新评论
推荐文章
作者最新文章
你可能感兴趣的文章
Copyright Disclaimer: The copyright of contents (including texts, images, videos and audios) posted above belong to the User who shared or the third-party website which the User shared from. If you found your copyright have been infringed, please send a DMCA takedown notice to [email protected]. For more detail of the source, please click on the button "Read Original Post" below. For other communications, please send to [email protected].
版权声明:以上内容为用户推荐收藏至CareerEngine平台,其内容(含文字、图片、视频、音频等)及知识版权均属用户或用户转发自的第三方网站,如涉嫌侵权,请通知[email protected]进行信息删除。如需查看信息来源,请点击“查看原文”。如需洽谈其它事宜,请联系[email protected]。
版权声明:以上内容为用户推荐收藏至CareerEngine平台,其内容(含文字、图片、视频、音频等)及知识版权均属用户或用户转发自的第三方网站,如涉嫌侵权,请通知[email protected]进行信息删除。如需查看信息来源,请点击“查看原文”。如需洽谈其它事宜,请联系[email protected]。