# Docker Jenkins进阶配置

## 初始化向导

软件的安装参考：[Jenkins环境构建](https://github.com/tuonioooo/engineering-management/blob/master/jenkins-ji-cheng/jenkinshuan-jing-gou-jian/README.md)

系统安装成功后，通过浏览器访问 http\:/ip:port/进入初始页，如果 Jenkins 还没有启动完成，会显示如下内容

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_fd013cd01b1040e3b20c84adced11138.png)

启动完成后，要求输入初始的管理员密码，根据提示密码在/root/.jenkins/secrets/initialAdminPassword这个文件中，找到密码输入，点击继续

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667035951574.jpg)

输入密码,成功进入页面

![](https://github.com/tuonioooo/engineering-management/raw/master/.gitbook/assets/import-jenkins-10.png)

选择安装推荐的插件,插件安装成功后跳至此界面，创建账户

![](https://github.com/tuonioooo/engineering-management/raw/master/.gitbook/assets/import-jenkins-11.png)

实例配置，保存并完成

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667036844388.jpg)

开始使用jenkins

![](https://github.com/tuonioooo/engineering-management/raw/master/.gitbook/assets/import-jenkins-12.png)

跳转到首页

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667037026200.jpg)

## 插件安装

### 配置插件站点地址

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667031462762.jpg)

配置后，需要重启，否则不生效

说明： 配置插件站点地址，是为了防止国外站点链接超时或者下载插件缓慢，这里采用是 `http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/current/update-center.json` 清华大学镜像地址 切记是`http`协议格式 上面页面访问路径是：系统管理（Manage Jenkins）--》插件管理（Manage Plugins）--》高级

### 安装汉化插件 Locale plugin、Localization: Chinese (Simplified)

下图是以前版本，需要下载两个插件

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_Snipaste_2022-10-29_18-09-43.png)

这个是当前版本，貌似需要下载一个插件即可

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667037949263.jpg)

汉化时，可能会出现部分中文简体不翻译的情况，做如下操作：

安装好插件“Locale plugin”和“Localization: Chinese (Simplified)后， 在系统管理（Manage Jenkins）->系统设置（Manage Setting），面板中作如下操作，可以临时完美修复

1. 将语言设定为zh\_US，Jenkins切换为英文。
2. 调用restart重启Jenkins：[http://域名/restart。](http://xn--eqrt2g/restart%E3%80%82)
3. 再次语言设定为zh\_CN，刷新即可。

重启后，还是会出现部分中文简体不翻译的情况，这个不是特别重要

### 安装Publish Over SSH

在 `Manage Plugins` 中直接搜索安装即可

## 配置

### Linux系统配置

示例图如下：

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1003.png)

配置图说明：

* `Jenkins Location` 用于配置jenkins访问URL
* `环境变量` 配置好键值对 在构建项目时 可以 用 `${Key}` 形式使用变量 `key就是变量名`
* `Publish over SSH` 如：\
  Passphrase: \*\*\*\*\*\*\*\*\*\*（是SSH全局连接时的登录密码）\
  Path to key: /root/.ssh/id\_rsa key (文件私钥的路径不是必须的)
* `SSH Servers`\
  Name: 名称\
  Hostname: 主机Ip\
  Username: 主机用户名\
  Remote Directory: 连接主机的目录\
  点高级，勾选 `Use password authentication, or use a different key`，可以配置不同SSH Servers登录的密码，如果没有可以忽略

### windows系统配置

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1006.png)

参数说明: 可以参考Linux配置

### Linux 全局工具配置

示例图如下：

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1002.png)

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1667054663706.jpg)

配置图说明：

* `maven配置`\
  1、手动配置：\
  a.宿主主机需要准备maven配置环境;\
  b.手动设置 `Maven 配置` 默认settings文件位置;\
  c.手动设置 `maven安装` 配置maven的主目录 `/usr/local/apache-maven-3.6.1`。\
  2、自动安装：\
  `maven安装` -> `新增maven` 指定版本后，勾选自动安装，jenkins在部署Java项目时会自动在 `/root/.jenkins/tools/hudson.tasks.Maven_MavenInstallation/` 目录下下载指定版本的maven
* `jdk配置`\
  1、Linux系统直接部署jenkins.war 此种情况，不需要配置jdk（宿主主机已经提前部署好java环境才能运行war包）\
  2、docker部署jenkins镜像\
  a. 手动配置 此种情况需要宿主主机准备Java配置环境，启动容器时挂载宿主主机Jdk目录，在 `新增JDK` 映射容器java主目录即可（如果jenkins自带的jdk版本与应用版本兼容也可以不用设置）\
  b. 自动配置 此种情况宿主主机没有java环境且jenkins自带的版本与开发版本不一致，可以 在 `新增JDK` 勾选 自动安装，选择对应匹配的版本，现在需要登录Oracle鉴权
* 其他配置默认即可

### windows 全局工具配置

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1007.png)

参数说明: 参考Linux 全局工具配置

## 项目构建（windows/Linux/其他平台都可以效仿）

### Linux项目构建

#### 单模块的打包配置实战图

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1004.png)

#### 多模块的打包配置实战图

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1005.png)

### Windows项目构建

![](https://github.com/tuonioooo/engineering-management/raw/master/assets/jenkins_1008.png)

注意，这里采用的是windows 下的cmd命令模式及用bat脚本实现部署Java，具体可以参考本笔记本当中的bat脚本

## Jenkins项目构建中的 SSH Publishers 脚本代码

### Linux脚本代码

#### 单模块传输

```shell
Source files：target/*.jar
Remove prefix：target/
Remote directory：jars/${JOB_NAME}/${BUILD_NUMBER}
Exec command: mkdir -p ~/apps/dev/${JOB_NAME}/logs/ing  
              mkdir -p ~/apps/dev/${JOB_NAME}/logs/sys  
              #/bin/cp ~/run.sh ~/apps/dev/${JOB_NAME}/  
              /bin/cp  ~/jars/${JOB_NAME}/${BUILD_NUMBER}/*.jar  ~/apps/dev/${JOB_NAME}/app.jar  
              sh apps/dev/${JOB_NAME}/run.sh restart dev
```

#### 多模块传输

```shell
Source files：novel-platform/target/*.jar
Remove prefix：novel-platform/target/
Remote directory： jars/${JOB_NAME}/${BUILD_NUMBER}
Exec command: mkdir -p ~/apps/dev/${JOB_NAME}/logs/ing  
              mkdir -p ~/apps/dev/${JOB_NAME}/logs/sys  
              #/bin/cp ~/run.sh ~/apps/dev/${JOB_NAME}/  
              /bin/cp  ~/jars/${JOB_NAME}/${BUILD_NUMBER}/*.jar  ~/apps/dev/${JOB_NAME}/app.jar  
              sh apps/dev/${JOB_NAME}/run.sh restart dev
```

[这个是执行jar包的shell脚本](https://github.com/tuonioooo/engineering-management/blob/master/assets/run.sh)

[这个是执行jenkins.war包的shell脚本](https://github.com/tuonioooo/engineering-management/blob/master/assets/jenkins_run.sh)

### windows脚本代码

```shell
set BASE_PATH=C:\workspace
md %BASE_PATH%\apps\dev\%JOB_NAME%\logs\ing
md %BASE_PATH%\apps\dev\%JOB_NAME%\logs\sys
copy %BASE_PATH%\run.bat %BASE_PATH%\apps\dev\%JOB_NAME%\
copy target\*.jar  %BASE_PATH%\apps\dev\%JOB_NAME%\
cd %BASE_PATH%\apps\dev\%JOB_NAME%
call run.bat
```

[cnm，记住这个是执行jar命令的bat脚本1](https://github.com/tuonioooo/engineering-management/blob/master/assets/run.bat)

[cnm，记住这个是执行jar命令的bat脚本2](https://github.com/tuonioooo/engineering-management/blob/master/assets/monitor.bat)

[cnm，记住这个是执行jenkins.war包的bat脚本](https://github.com/tuonioooo/engineering-management/blob/master/assets/jenkins_run.bat)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tuonioooo-notebook.gitbook.io/docker/advanced/docker-jenkins-advanced.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.