# quick-jenkins

**Repository Path**: zhanglp520/quick-jenkins

## Basic Information

- **Project Name**: quick-jenkins
- **Description**: quick-jenkins数据卷备份
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-11-03
- **Last Updated**: 2023-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# quick-jenkins 镜像使用介绍

## 介绍

tudouge925/quick-jenkins 是 quick 框架 jenkins 的容器，为了自动化部署 quick 框架的数据库、后端服务以及前端。从此不在需要每次人工的去编译打包部署了。

## 开启防火墙

```bash
#启动防火墙
systemctl start firewalld

#放行8080端口
firewall-cmd --zone=public --add-port=8080/tcp --permanent

#重载使其生效
firewall-cmd --reload

#查看放行的端口
firewall-cmd --list-ports

#开启防护墙后必须重启docker服务
systemctl restart docker
```

## 使用数据卷（和全新安装选其一）

如果需要使用之前的数据，使用数据卷方案即可，反之忽略此步。

迁移服务器时使用

### 导出数据卷

将自己的数据卷导出：压缩宿主 jenkins 目录下的，也就是容器挂载的目录。

官方导出的数据卷上传到了 QQ 群：

文件路径：docker 资料/quick-jenkins 数据卷.tar.gz

```bash
QQ群1：558795174

QQ群2：485013155
```

### 导入数据卷

- 将自己在上步操作中导出的数据卷导入解压即可。

- 官方提供的导出数据卷备份：

  QQ 群中下载 docker 资料/quick-jenkins 数据卷.tar.gz 压缩包。上传到宿主机 quick-jenkins 挂载的 jenkins 目录下解压即可。

  切记：此处先创建挂载目录然后再去解压。

  - 官方数据卷中的jenkins登录信息：

        账号：quick

        密码：quick

## 获取镜像

```bash
docker pull tudouge925/quick-jenkins:1.0
```

## 启动容器

```bash
docker run --name quick-jenkins -u root --rm -d \
-p 8080:8080 \
-p 50000:50000 \
--privileged=true \
-v /jenkins/home/:/var/lib/jenkins/ \
tudouge925/quick-jenkins:1.0
```

## 访问 jenkins

浏览器输入：http://ip:8080/

## 全新安装（和数据卷选其一）

一般是首次部署时使用。

```bash

#进入容器
docker exec -it quick-jenkins /bin/bash

#查看密码
cat /var/lib/jenkins/secrets/initialAdminPassword
```

### 界面配置

#### 安装中文插件

插件名：Localization: Chinese (Simplified)

#### 安装 nodejs 插件

插件名：NodeJS

#### 安装 git 插件

插件名：git

```bash
#刚上面通过安装推荐插件的方式git貌似未正常安装，故此通过手动方式安装。
yum install git
```

#### 安装 SSH 插件（远程部署才需要此插件）

插件名：Publish Over SSH

配置 SSH 插件

#### 安装 gitee 插件

### 插件安装完成后，重启服务

```bash
#重启
systemctl restart jenkins

#查看状态
systemctl status jenkins
```

## 创建自动化部署任务

### 后端自动化部署

后端仓库地址：https://gitee.com/zhanglp520/quick-node-Nestjs.git

#### 界面操作

1. 创建 quick-server 任务

2. 配置任务

- 源码管理

  配置 git 地址及分支，由于是开源项目不需要配置 Credentials

- 配置触发器

  使用 gitee webhook 触发构建

- 配置构建环境

  选择 Provide Node & npm bin/ folder to PATH 即可

- 配置 Build Steps

  下拉框中选择执行 shell 并在下面的命令框中填写如下命令

```bash
#!/bin/sh
chmod +x ./deploy/build.sh
./deploy/build.sh
```

- 配置构建后操作（远程部署才需要）

  下拉框中选择 Send build artifacts over SSH 并配置相关信息

  ssh 配置完成后，配置下面属性：

  SSH Server Name： 下拉框中选择上面配置的 ssh 名称（ssh 相关配置查看其他文档，此处不作为重点介绍）
  Transfer Set Source files：temp/dist.tar.gz
  Remove prefix：可以为空
  Remote directory：/ainiteam/quick/server
  Exec command：填写如下脚本文件中的命令

  执行脚本在后端仓库/deploy/startup.sh，将内容拷贝的执行命令框中即可

- 开始构建

  推送代码或者点击立即构建按钮都可以启动构建

## 前端自动化部署

前端仓库地址：https://gitee.com/zhanglp520/github-quick-vue3-admin.git

#### 界面操作

1. 创建 quick-web 任务

2. 配置任务

- 源码管理

  配置 git 地址及分支，由于是开源项目不需要配置 Credentials

- 配置触发器

  使用 gitee webhook 触发构建（giee webhook 配置查看其他文档，此处不作为重点介绍）

- 配置构建环境

  选择 Provide Node & npm bin/ folder to PATH 即可

- 配置 Build Steps

  下拉框中选择执行 shell 并在下面的命令框中填写如下命令

```bash
#!/bin/sh
chmod +x ./deploy/build.sh
./deploy/build.sh
```

- 配置构建后操作（远程部署才需要）

  下拉框中选择 Send build artifacts over SSH 并配置相关信息

  ssh 配置完成后，配置下面属性：

  SSH Server Name： 下拉框中选择上面配置的 ssh 名称（ssh 相关配置查看其他文档，此处不作为重点介绍）
  Transfer Set Source files：temp/dist.tar.gz
  Remove prefix：可以为空
  Remote directory：/ainiteam/quick/web/nginx/html
  Exec command：填写如下脚本文件中的命令

  执行脚本在后端仓库/deploy/startup.sh，将内容拷贝的执行命令框中即可

- 开始构建

  推送代码或者点击立即构建按钮都可以启动构建