## 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 <应用名> <环境前缀> [序号] ``` **示例：** ```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 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 ```