在统信UOS系统上完成微服务Docker端到端部署，需依次确保Docker环境就绪（systemctl状态、cgroup v2、docker组权限）、各服务Dockerfile规范构建、镜像推送至私有仓库、通过docker compose编排启动并验证健康状态。
在统信UOS系统上将微服务项目通过Docker完成端到端部署，需先确保Docker环境就绪、镜像构建可执行、服务间网络互通、配置与数据持久化可靠，跳过任一环节都可能导致服务启动失败或相互调用中断。
确认Docker运行环境已就绪
打开终端，执行 sudo systemctl status docker，检查输出中是否包含 active (running)；若显示 inactive (dead) 或报错“Unit docker.service not found”，说明Docker未安装或服务未启用，必须先完成安装与启动流程。
运行 docker info | grep "Cgroup Version"，确认返回值为 cgroup version: 2；若为 cgroup version: 1，且内核版本 ≥5.4，需在 GRUB 配置中添加 systemd.unified_cgroup_hierarchy=1 并重启，否则多容器网络和资源限制可能异常。
执行 groups，查看当前用户是否在 docker 组中；不在则需补做 sudo usermod -aG docker $USER && newgrp docker，否则后续所有 docker 命令都会提示 permission denied。
准备微服务源码与Dockerfile
将微服务各模块（如 user-service、order-service、api-gateway）分别存放在独立子目录中，每个目录下必须包含可直接运行的二进制文件或 jar 包，以及配套的 Dockerfile。
以 Spring Boot 服务为例，Dockerfile 内容应为：
FROM openjdk:17-jre-slim<br>WORKDIR /app<br>COPY target/*.jar app.jar<br>EXPOSE 8080<br>ENTRYPOINT ["java","-Xms256m","-Xmx512m","-jar","app.jar"]
注意：不要使用 ADD 替代 COPY，否则会触发 Docker 缓存失效并重复下载依赖；也不要省略 -Xms/-Xmx，UOS 默认 JVM 堆内存策略易导致 OOM 被 cgroup kill。
若服务依赖本地配置文件（如 application.yml），须在 COPY 指令后追加 COPY config/ ./config/，并确保该路径在容器内被应用正确加载。
构建并推送各服务镜像
进入 user-service 目录，执行：docker build -t uos-registry.local/user-service:v1.2 .
进入 order-service 目录，执行：docker build -t uos-registry.local/order-service:v1.2 .
进入 api-gateway 目录，执行：docker build -t uos-registry.local/api-gateway:v1.2 .
若企业内部已部署 Harbor 或 Nexus Container Registry，需先执行 docker login uos-registry.local -u admin，再运行 docker push uos-registry.local/user-service:v1.2 推送全部镜像；未配置私有仓库时，镜像仅保留在本机，不可跨节点部署。
用docker-compose编排多服务启动
在项目根目录新建 docker-compose.yml，内容如下：
version: '3.8'<br>services:<br> api-gateway:<br> image: uos-registry.local/api-gateway:v1.2<br> ports:<br> - "8088:8080"<br> environment:<br> - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/<br> depends_on:<br> - eureka-server<br> user-service:<br> image: uos-registry.local/user-service:v1.2<br> environment:<br> - SPRING_PROFILES_ACTIVE=prod<br> - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/<br> depends_on:<br> - eureka-server<br> order-service:<br> image: uos-registry.local/order-service:v1.2<br> environment:<br> - SPRING_PROFILES_ACTIVE=prod<br> - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/<br> depends_on:<br> - eureka-server<br> eureka-server:<br> image: springio/eureka-server:latest<br> ports:<br> - "8761:8761"
执行 docker compose up -d 启动全部服务；不要用 docker-compose（带短横线），UOS 1060e+ 系统默认只识别 docker compose（空格分隔）子命令，否则提示 command not found。
等待约 90 秒后，运行 docker compose ps，确认所有状态列为 running；若某服务显示 exited，立即执行 docker compose logs <service-name></service-name> 查看首屏错误日志，常见原因为配置项缺失、Eureka 注册超时或数据库连接拒绝。
执行 curl http://localhost:8088/actuator/health，返回 {"status":"UP"} 即表示网关层已就绪，微服务注册拓扑建立成功。
