服务部署

本节通过jenkins来进行简单的服务部署到k8s演示。

准备工作#

  • k8s集群安装
  • gitlab环境安装
  • jenkins环境安装
  • redis&mysql&nginx&etcd安装
  • goctl安装
tip

goctl确保k8s每个node节点上都有

以上环境安装请自行google,这里不做篇幅介绍。

服务部署#

1、gitlab代码仓库相关准备#

1.1、添加SSH Key#

进入gitlab,点击用户中心,找到Settings,在左侧找到SSH Keystab ssh key

  • 1、在jenkins所在机器上查看公钥
$ cat ~/.ssh/id_rsa.pub
  • 2、如果没有,则需要生成,如果存在,请跳转到第3步
$ ssh-keygen -t rsa -b 2048 -C "email@example.com"

"email@example.com" 可以替换为自己的邮箱

完成生成后,重复第一步操作

  • 3、将公钥添加到gitlab中

1.2、上传代码到gitlab仓库#

新建工程go-zero-demo并上传代码,这里不做细节描述。

2、jenkins#

2.1、添加凭据#

  • 查看jenkins所在机器的私钥,与前面gitlab公钥对应
$ cat id_rsa
  • 进入jenkins,依次点击Manage Jenkins-> Manage Credentials credentials

  • 进入全局凭据页面,添加凭据,Username是一个标识,后面添加pipeline你知道这个标识是代表gitlab的凭据就行,Private Key`即上面获取的私钥 jenkins-add-credentials

2.2、 添加全局变量#

进入Manage Jenkins->Configure System,滑动到全局属性条目,添加docker私有仓库相关信息,如图为docker用户名docker用户密码docker私有仓库地址 docker_server

tip

docker_user 修改为你的docker用户名

docker_pass 修改为你的docker用户密码

docker_server 修改为你的docker服务器地址

这里我使用的私有仓库,如果没有云厂商提供的私有仓库使用,可以自行搭建一个私有仓库,这里就不赘述了,大家自行google。

2.3、配置git#

进入Manage Jenkins->Global Tool Configureation,找到Git条目,填写jenkins所在机器git可执行文件所在path,如果没有的话,需要在jenkins插件管理中下载Git插件。 jenkins-git

jenkins-configure

2.4、 添加一个Pipeline#

pipeline用于构建项目,从gitlab拉取代码->生成Dockerfile->部署到k8s均在这个步骤去做,这里是演示环境,为了保证部署流程顺利, 需要将jenkins安装在和k8s集群的其中过一个节点所在机器上,我这里安装在master上的。

  • 获取凭据id 进入凭据页面,找到Username为gitlab的凭据id jenkins-credentials-id

  • 进入jenkins首页,点击新建Item,名称为user jenkins-add-item

  • 查看项目git地址 gitlab-git-url

  • 添加服务类型Choice Parameter,在General中勾选This project is parameterized ,点击添加参数选择Choice Parameter,按照图中添加选择的值常量(api、rpc)及接收值的变量(type),后续在Pipeline script中会用到。 jenkins-choice-parameter

  • 配置user,在user配置页面,向下滑动找到Pipeline script,填写脚本内容

pipeline {
agent any
parameters {
gitParameter name: 'branch',
type: 'PT_BRANCH',
branchFilter: 'origin/(.*)',
defaultValue: 'master',
selectedValue: 'DEFAULT',
sortMode: 'ASCENDING_SMART',
description: '选择需要构建的分支'
}
stages {
stage('服务信息') {
steps {
sh 'echo 分支:$branch'
sh 'echo 构建服务类型:${JOB_NAME}-$type'
}
}
stage('check out') {
steps {
checkout([$class: 'GitSCM',
branches: [[name: '$branch']],
doGenerateSubmoduleConfigurations: false,
extensions: [],
submoduleCfg: [],
userRemoteConfigs: [[credentialsId: '${credentialsId}', url: '${gitUrl}']]])
}
}
stage('获取commit_id') {
steps {
echo '获取commit_id'
git credentialsId: '${credentialsId}', url: '${gitUrl}'
script {
env.commit_id = sh(returnStdout: true, script: 'git rev-parse --short HEAD').trim()
}
}
}
stage('goctl版本检测') {
steps{
sh '/usr/local/bin/goctl -v'
}
}
stage('Dockerfile Build') {
steps{
sh '/usr/local/bin/goctl docker -go service/${JOB_NAME}/${type}/${JOB_NAME}.go'
script{
env.image = sh(returnStdout: true, script: 'echo ${JOB_NAME}-${type}:${commit_id}').trim()
}
sh 'echo 镜像名称:${image}'
sh 'docker build -t ${image} .'
}
}
stage('上传到镜像仓库') {
steps{
sh '/root/dockerlogin.sh'
sh 'docker tag ${image} ${dockerServer}/${image}'
sh 'docker push ${dockerServer}/${image}'
}
}
stage('部署到k8s') {
steps{
script{
env.deployYaml = sh(returnStdout: true, script: 'echo ${JOB_NAME}-${type}-deploy.yaml').trim()
env.port=sh(returnStdout: true, script: '/root/port.sh ${JOB_NAME}-${type}').trim()
}
sh 'echo ${port}'
sh 'rm -f ${deployYaml}'
sh '/usr/local/bin/goctl kube deploy -secret dockersecret -replicas 2 -nodePort 3${port} -requestCpu 200 -requestMem 50 -limitCpu 300 -limitMem 100 -name ${JOB_NAME}-${type} -namespace hey-go-zero -image ${dockerServer}/${image} -o ${deployYaml} -port ${port}'
sh '/usr/bin/kubectl apply -f ${deployYaml}'
}
}
stage('Clean') {
steps{
sh 'docker rmi -f ${image}'
sh 'docker rmi -f ${dockerServer}/${image}'
cleanWs notFailBuild: true
}
}
}
}
tip

${credentialsId} 要替换为你的具体凭据值, 即 [添加凭据] 模块中的一串字符串, ${gitUrl} 需要替换为你代码的git仓库地址,其他的 ${..} 形式的变量无需修改, 保持原样即可.

user-pipepine-script

port.sh参考内容如下#

case $1 in
"user-api") echo 1000
;;
"user-rpc") echo 1001
;;
"course-api") echo 1002
;;
"course-rpc") echo 1003
;;
"selection-api") echo 1004
esac

其中dockerlogin.sh内容

#!/bin/bash
docker login --username=$docker-user --password=$docker-pass $docker-server
  • $docker-user: docker登录用户名
  • $docker-pass: docker登录用户密码
  • $docker-server: docker私有地址

查看pipeline#

build with parameters build with parameters

查看k8s服务#

k8s01

最后更新 日期: