添加 Others/release-it做私服版本控制.md
This commit is contained in:
parent
62b4ddc9b6
commit
8b7959dc65
1 changed files with 190 additions and 0 deletions
190
Others/release-it做私服版本控制.md
Normal file
190
Others/release-it做私服版本控制.md
Normal file
|
|
@ -0,0 +1,190 @@
|
|||
## 背景介绍
|
||||
公司项目抽取出来的公共组件，用于项目的快速开发。但是因各项目使用的组件版本不同，需要做版本管理。
|
||||
|
||||
## 需求分析
|
||||
### 功能需求
|
||||
1、每次提交代码，自动构建
|
||||
2、自动发布到nexus私服
|
||||
3、git repository中自动添加tag（tag自动递增）
|
||||
4、自动生成changelog
|
||||
|
||||
### 工具选择
|
||||
jenkins结合release-it（js编写的工具）可以满足以上所有需求。
|
||||
|
||||
## 实现方案
|
||||
### 1.开发支持
|
||||
#### 1-1.安装nodejs
|
||||
```shell
|
||||
# 下载nodejs
|
||||
# 下载地址：https://nodejs.org/dist/v21.2.0/node-v21.2.0-linux-x64.tar.xz
|
||||
# 解压
|
||||
tar -xvf node-v21.2.0-linux-x64.tar.xz
|
||||
# 移动到指定目录
|
||||
mv node-v21.2.0-linux-x64 /usr/local/
|
||||
# 配置环境变量，以linux系统为例
|
||||
export NODE_HOME=/usr/local/node-v21.2.0-linux-x64/bin/node
|
||||
export PATH=$PATH:$NODE_HOME
|
||||
# 验证是否安装成功
|
||||
node -v
|
||||
```
|
||||
#### 1-2.初始化并安装release-it
|
||||
```shell
|
||||
# 在项目目录中初始化
|
||||
npm init -y
|
||||
# 全局安装release-it
|
||||
npm install -g release-it
|
||||
npm install -g @release-it/conventional-changelog
|
||||
# 验证是否安装成功
|
||||
release-it -V
|
||||
```
|
||||
#### 1-3.创建配置文件
|
||||
```shell
|
||||
# 项目根目录下创建.release-it.json文件
|
||||
# 参照https://raw.githubusercontent.com/release-it/release-it/main/config/release-it.json
|
||||
cat > .release-it.json << EOF
|
||||
{
|
||||
"git": {
|
||||
"requireBranch": false,
|
||||
"commitMessage": "release: v${version} [ci-skip]"
|
||||
},
|
||||
"npm": {
|
||||
"publish": false
|
||||
},
|
||||
"hooks": {
|
||||
"after:bump": "echo 更新版本成功，版本: v${version}",
|
||||
"after:git:release": "npm run publish",
|
||||
"after:release": "echo Successfully released ${name} v${version} to ${repo.repository}."
|
||||
},
|
||||
"plugins": {
|
||||
"@release-it/conventional-changelog": {
|
||||
"preset": "angular",
|
||||
"infile": "CHANGELOG.md"
|
||||
}
|
||||
}
|
||||
}
|
||||
EOF
|
||||
# 修改package.json文件
|
||||
cat > package.json << EOF
|
||||
{
|
||||
"name": "echo-plugins",
|
||||
"group": "com.turingsyn.framework.plugin",
|
||||
"version": "1.1.30",
|
||||
"description": "plugins",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
"test": "gradlew check",
|
||||
"clean": "gradlew clean",
|
||||
"publish": "sh gradlew clean build publish",
|
||||
"release": "release-it"
|
||||
},
|
||||
"author": "turingsyc",
|
||||
"license": "ISC",
|
||||
"devDependencies": {
|
||||
"@release-it/conventional-changelog": "^8.0.1",
|
||||
"release-it": "^17.0.0"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://gitee.com/turningsyn/echo-libs.git"
|
||||
}
|
||||
}
|
||||
EOF
|
||||
# 添加nexus私服链接及认证信息
|
||||
cat >> gradle.properties << EOF
|
||||
# nexus私服链接
|
||||
NEXUS_URL=http://nexus-server-svc:8081
|
||||
# nexus私服认证信息
|
||||
NEXUS_USERNAME=admin
|
||||
NEXUS_PASSWORD=admin
|
||||
EOF
|
||||
# build.gradle添加如下配置
|
||||
cat > build.gradle << EOF
|
||||
allprojects {
|
||||
repositories {
|
||||
maven {
|
||||
credentials {
|
||||
username = NEXUS_USERNAME
|
||||
password = NEXUS_PASSWORD
|
||||
}
|
||||
allowInsecureProtocol true
|
||||
url "${NEXUS_URL}/repository/maven-public/"
|
||||
}
|
||||
}
|
||||
}
|
||||
EOF
|
||||
```
|
||||
**以下以gitee为例配置**
|
||||
### 2.生成公私钥
|
||||
使用如下命令生成公私钥。
|
||||
```shell
|
||||
# 一直回车即可生成无密码的公私钥。
|
||||
# 公私钥一般生成在用户家目录下的.ssh目录，私钥为id_ed25519，公钥为id_ed25519.pub，
|
||||
# windows系统在C:\Users\用户名\.ssh\
|
||||
ssh-keygen -t ed25519 -C "gitee"
|
||||
```
|
||||
### 3.gitee配置SSH公钥
|
||||
移动鼠标至用户名，在下拉框中选择[设置]，[安全设置]下的[SSH公钥]，自定义公钥名称，把公钥内容粘贴到[公钥]中，点击[确定]。
|
||||
使用如下命令测试是否配置成功。
|
||||
```shell
|
||||
ssh -T git@gitee.com
|
||||
```
|
||||
|
||||
### 4.安装配置jenkins
|
||||
安装，略。安装相应插件。因需要自动构建，因此需要安装对应代码仓库的plugin。
|
||||
如gitlab需要安装gitlab plugin，gitee需要安装gitee plugin等。
|
||||
|
||||
#### 4-1.全局安全配置
|
||||
在[系统管理]，[安全]配置下，选择[全局安全配置]，在[Git Host Key Verification Configuration]下的[Host Key Verification Strategy]选择[Manually provided keys]，在[Approved Host Keys]中填写.ssh/known_hosts文件的内容，点击[保存]。
|
||||
#### 4-2.凭证管理
|
||||
##### 4-2-1.添加源码管理凭证
|
||||
在[全局凭证]中添加类型为[SSH Username with private key]的凭证，凭证ID为[gitee]，用户名为gitee的用户名，私钥为.ssh/id_ed25519，点击[创建]。
|
||||
##### 4-2-2.添加用于release-it拉取/推送的凭证
|
||||
在[全局凭证]中添加类型为[Secret file]的凭证，凭证ID为[giteePrivate]，file为.ssh/id_ed25519，点击[创建]。
|
||||
##### 4-2-3.添加gitee用户名凭证
|
||||
在[全局凭证]中添加类型为[Secret text]的凭证，凭证ID为[giteeUsername]，value为gitee的用户名，点击[创建]。
|
||||
##### 4-2-4.添加gitee邮箱凭证
|
||||
在[全局凭证]中添加类型为[Secret text]的凭证，凭证ID为[giteeEmail]，value为gitee的邮箱，点击[创建]。
|
||||
|
||||
#### 4-2.新建自由风格job
|
||||
略。
|
||||
#### 4-3.配置job
|
||||
本文档主要讲解业务需求配置，其他配置略。
|
||||
|
||||
##### 4-3-1.源码管理
|
||||
使用ssh方式拉取代码。
|
||||
在[源码管理]，[Git]，点击[添加]，选择[Git]，在[Repository URL]中填写gitee的ssh仓库地址，在[Credentials]中选择[gitee]，点击[保存]。
|
||||
|
||||
##### 4-3-2.构建触发器
|
||||
选中[Gitee webhook 触发构建]，[Gitee触发构建策略]选择[推送代码]。
|
||||
[构建指令过滤]选择[[ci-skip] 指令跳过构建]。
|
||||
[允许触发构建的分支]选择[根据分支名过滤]，[包含]填写[master]（或对应的分支名）
|
||||
[Gitee WebHook 密码]，点击[生成]。
|
||||
|
||||
##### 4-3-3.gitee代码库配置webhook
|
||||
在gitee仓库的[设置]，[Webhooks]，点击[添加webhook]，填写[URL]为jenkins的webhook地址，[WebHook密码/签名密钥]选择[WebHook密码]，密码为Jenkins生成的webhook密码，[选择事件]为[push]、[tag push]、[pull request]、[激活]。
|
||||
|
||||
##### 4-3-4.构建环境
|
||||
选择[Use secret test(s) or file(s)]，添加以下变量。
|
||||
1.添加[Secret file]类型，自定义命名，如[PRIVATEKEY]，并指定凭证为[giteePrivate]
|
||||
2.添加[Secret text]类型，自定义命名，如[USERNAME]，并指定凭证为[giteeUsername]
|
||||
3.添加[Secret text]类型，自定义命名，如[EMAIL]，并指定凭证为[giteeEmail]
|
||||
|
||||
##### 4-3-5.构建步骤
|
||||
选择[Execute shell]，在[Command]中填写以下内容。
|
||||
```shell
|
||||
npm config set registry https://registry.npm.taobao.org && npm install
|
||||
git branch && git checkout master
|
||||
#sh gradlew clean build --no-daemon
|
||||
|
||||
mkdir ~/.ssh && chmod 700 ~/.ssh && cp ${PRIVATEKEY} ~/.ssh
|
||||
ssh-keyscan -t ssh-ed25519 gitee.com > ~/.ssh/known_hosts
|
||||
git config --global user.email "${EMAIL}"
|
||||
git config --global user.name "${USERNAME}"
|
||||
#git checkout .
|
||||
npx release-it --ci
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue