307 lines
7.7 KiB
Markdown
307 lines
7.7 KiB
Markdown
## GBS Java 应用 Docker 镜像打包操作流程
|
||
|
||
### 目录结构
|
||
|
||
```
|
||
build-tools/
|
||
├── README.md ← 本文档
|
||
├── Dockerfile ← Dockerfile 模板（CentOS 7 + JDK 1.8.0_202）
|
||
├── build.sh ← Shell 构建脚本（在 master 节点上执行）
|
||
├── build_push.py ← Python 构建脚本（在本地 Windows 上执行，自动上传+构建+推送）
|
||
└── install_env.sh ← 构建环境一键安装脚本（在 master 节点上执行）
|
||
```
|
||
|
||
### 环境信息
|
||
|
||
| 项目 | 信息 |
|
||
|------|------|
|
||
| Master 节点 | 192.168.20.100 (root / Zcloud@zcloud100) |
|
||
| OS | CentOS 7 (已 EOL，yum 源已切换阿里云 vault) |
|
||
| JDK | Oracle JDK 1.8.0_202，路径 `/opt/jdk1.8.0_202` |
|
||
| Maven | Apache Maven 3.8.8，路径 `/opt/maven`，阿里云镜像 |
|
||
| Docker | 26.1.4，cgroupdriver=systemd，storage=overlay2 |
|
||
| ACR 仓库 | `jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com` |
|
||
| ACR 命名空间 | `ali_img_ns` |
|
||
| K8s 命名空间 | `jjb-dragon` |
|
||
|
||
### 镜像命名规则
|
||
|
||
完整镜像地址格式：
|
||
|
||
```
|
||
{ACR仓库}/{命名空间}/prod-aly-{环境前缀}-dragon-{应用名}:{环境前缀}-{日期}-{序号}
|
||
```
|
||
|
||
示例：
|
||
|
||
```
|
||
jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
各部分说明：
|
||
|
||
- `prod-aly` — 固定前缀（生产环境-阿里云）
|
||
- `ota` — 环境前缀，对应不同业务模块
|
||
- `dragon` — 项目代号
|
||
- `jjb-saas-safety-eval` — 应用名称
|
||
- `ota-20260626-1` — 标签：环境前缀-年月日-序号（同一天多次构建递增序号）
|
||
|
||
---
|
||
|
||
### 方式一：本地一键构建（推荐）
|
||
|
||
在本地 Windows 机器上执行 `build_push.py`，自动完成 JAR 上传 → Docker 构建 → ACR 推送。
|
||
|
||
**前置条件：** 本地已安装 Python 和 paramiko（`pip install paramiko`）
|
||
|
||
**执行命令：**
|
||
|
||
```bash
|
||
python build_push.py <JAR文件路径> <应用名> <环境前缀> [序号]
|
||
```
|
||
|
||
**示例：**
|
||
|
||
```bash
|
||
python build_push.py E:\projects\safety-eval-service\safety-eval-start\target\safety-eval-start-1.0-SNAPSHOT.jar jjb-saas-safety-eval ota 1
|
||
```
|
||
|
||
**输出：**
|
||
|
||
```
|
||
Image Address:
|
||
jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
---
|
||
|
||
### 方式二：在 Master 节点上构建
|
||
|
||
SSH 登录 master 节点后，使用 `build.sh` 脚本构建。
|
||
|
||
**Step 1 — 上传 JAR 到 master 节点**
|
||
|
||
在本地用 scp 或其他方式上传 JAR：
|
||
|
||
```bash
|
||
scp safety-eval-start-1.0-SNAPSHOT.jar root@192.168.20.100:/tmp/
|
||
```
|
||
|
||
**Step 2 — SSH 登录 master**
|
||
|
||
```bash
|
||
ssh root@192.168.20.100
|
||
# 密码: Zcloud@zcloud100
|
||
```
|
||
|
||
**Step 3 — 执行构建脚本**
|
||
|
||
```bash
|
||
source /etc/profile.d/java.sh
|
||
source /etc/profile.d/maven.sh
|
||
/opt/docker-templates/build.sh jjb-saas-safety-eval ota /tmp/safety-eval-start-1.0-SNAPSHOT.jar 1
|
||
```
|
||
|
||
脚本会自动完成：准备构建上下文 → 复制 JDK → Docker build → Docker login ACR → Docker push。
|
||
|
||
---
|
||
|
||
### 方式三：手动分步操作
|
||
|
||
如果需要手动控制每一步：
|
||
|
||
**Step 1 — 准备构建目录**
|
||
|
||
```bash
|
||
BUILD_DIR=/tmp/manual-build
|
||
rm -rf $BUILD_DIR && mkdir -p $BUILD_DIR/target
|
||
```
|
||
|
||
**Step 2 — 复制 JDK 和 JAR**
|
||
|
||
```bash
|
||
cp -r /opt/jdk1.8.0_202 $BUILD_DIR/
|
||
cp /path/to/your-app.jar $BUILD_DIR/target/
|
||
cp /opt/docker-templates/Dockerfile $BUILD_DIR/
|
||
```
|
||
|
||
**Step 3 — Docker Build**
|
||
|
||
```bash
|
||
docker build -t jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1 $BUILD_DIR
|
||
```
|
||
|
||
**Step 4 — 登录 ACR**
|
||
|
||
```bash
|
||
echo 'idurCT!rIq9EzISD' | docker login --username=10952138@qq.com --password-stdin jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com
|
||
```
|
||
|
||
**Step 5 — 推送镜像**
|
||
|
||
```bash
|
||
docker push jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
**Step 6 — 清理**
|
||
|
||
```bash
|
||
rm -rf $BUILD_DIR
|
||
```
|
||
|
||
---
|
||
|
||
### 从源码构建（Maven 打包 + Docker 构建）
|
||
|
||
如果拿到的是 Java 源码而不是编译好的 JAR：
|
||
|
||
```bash
|
||
source /etc/profile.d/java.sh
|
||
source /etc/profile.d/maven.sh
|
||
|
||
# Maven 编译打包
|
||
cd /path/to/project
|
||
mvn clean package -DskipTests
|
||
|
||
# 然后用编译好的 JAR 走上面的构建流程
|
||
/opt/docker-templates/build.sh <app-name> <env-prefix> target/xxx.jar 1
|
||
```
|
||
|
||
Maven 已配置阿里云镜像（`maven.aliyun.com/repository/public`），依赖下载速度约 200-400 KB/s。
|
||
|
||
---
|
||
|
||
### K8s 部署命令
|
||
|
||
**创建新 Deployment：**
|
||
|
||
```bash
|
||
/usr/bin/kubectl create deployment jjb-saas-safety-eval \
|
||
--image=jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1 \
|
||
-n jjb-dragon --replicas=1
|
||
```
|
||
|
||
**更新已有 Deployment 的镜像：**
|
||
|
||
```bash
|
||
/usr/bin/kubectl set image deployment/jjb-saas-safety-eval \
|
||
jjb-saas-safety-eval=jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1 \
|
||
-n jjb-dragon
|
||
```
|
||
|
||
**查看 Pod 状态：**
|
||
|
||
```bash
|
||
/usr/bin/kubectl get pods -n jjb-dragon | grep safety-eval
|
||
```
|
||
|
||
**查看日志：**
|
||
|
||
```bash
|
||
/usr/bin/kubectl logs -f deployment/jjb-saas-safety-eval -n jjb-dragon
|
||
```
|
||
|
||
**查看 Deployment 详情：**
|
||
|
||
```bash
|
||
/usr/bin/kubectl describe deployment jjb-saas-safety-eval -n jjb-dragon
|
||
```
|
||
|
||
---
|
||
|
||
### 常用查询命令
|
||
|
||
**查看本地镜像：**
|
||
|
||
```bash
|
||
docker images | grep jjb-saas-safety-eval
|
||
```
|
||
|
||
**查看镜像详情：**
|
||
|
||
```bash
|
||
docker inspect jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
**查看镜像构建历史：**
|
||
|
||
```bash
|
||
docker history jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
**本地测试运行：**
|
||
|
||
```bash
|
||
docker run --rm -it --name safety-eval-test \
|
||
-p 8080:8080 \
|
||
jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260626-1
|
||
```
|
||
|
||
**列出 ACR 上所有已有镜像：**
|
||
|
||
```bash
|
||
docker images --format '{{.Repository}}:{{.Tag}}' | grep 'ali_img_ns'
|
||
```
|
||
|
||
---
|
||
|
||
### 构建环境安装
|
||
|
||
首次使用新机器时，运行 `install_env.sh` 一键安装全部构建依赖：
|
||
|
||
```bash
|
||
ssh root@192.168.20.100
|
||
bash install_env.sh
|
||
```
|
||
|
||
该脚本会安装并配置：JDK 1.8.0_202、Maven 3.8.8（阿里云镜像）、Dockerfile 模板、yum vault 源、ACR 登录。
|
||
|
||
---
|
||
|
||
### Dockerfile 结构说明
|
||
|
||
镜像内部结构（从已有运行镜像逆向分析得出）：
|
||
|
||
```
|
||
/
|
||
├── opt/
|
||
│ ├── jdk1.8.0_202/ ← Oracle JDK 1.8.0_202
|
||
│ ├── app.jar ← 应用 JAR 包
|
||
│ └── logs/ ← 日志目录
|
||
```
|
||
|
||
容器启动命令（ENTRYPOINT）：
|
||
|
||
```
|
||
/opt/jdk1.8.0_202/bin/java
|
||
-Dnacos.namespace=jjb-dragon
|
||
-Dnacos.url=prod-nacos:8848
|
||
-Dspring.profiles.active=prod
|
||
-Dmysql.password=***
|
||
-Dmysql.host=192.168.20.100
|
||
-Dmysql.port=33080
|
||
-Dmysql.username=root
|
||
-jar /opt/app.jar
|
||
```
|
||
|
||
运行时可通过 K8s deployment 的 `args` 或 `env` 字段覆盖以上参数。
|
||
|
||
---
|
||
|
||
### 故障排查
|
||
|
||
**问题：`yum install` 报错 404**
|
||
CentOS 7 已 EOL，确认 `/etc/yum.repos.d/CentOS-Base.repo` 使用 `centos-vault` 源（install_env.sh 会自动处理）。
|
||
|
||
**问题：Maven 下载依赖慢**
|
||
检查 `/root/.m2/settings.xml` 是否配置了阿里云镜像，mirrorOf 应为 `central`。
|
||
|
||
**问题：`docker push` 报 unauthorized**
|
||
重新登录 ACR：`echo 'idurCT!rIq9EzISD' | docker login --username=10952138@qq.com --password-stdin jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com`
|
||
|
||
**问题：K8s 拉取镜像失败 (ImagePullBackOff)**
|
||
确认 `jjb-dragon` namespace 下有 `image-pull-secret` 或 `image-pull-secret1`：
|
||
```bash
|
||
/usr/bin/kubectl get secret -n jjb-dragon | grep image-pull
|
||
```
|