Ubuntu Docker如何部署微服务

在 Ubuntu 上使用 Docker 部署微服务的实操指南

一 环境准备与安装

• 更新系统并安装依赖：
  • sudo apt update && sudo apt upgrade -y
  • sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
• 添加 Docker 官方 GPG 密钥与 APT 源（适配 x86_64/arm64）：
  • curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  • echo “deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
• 安装 Docker 引擎并启动：
  • sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io
  • sudo systemctl start docker && sudo systemctl enable docker
• 可选 安装 Docker Compose v2（插件方式）：
  • sudo apt install -y docker-compose-plugin
  • 验证：docker compose version（或 docker-compose version，如 apt 安装的是 v1）
• 验证安装：
  • docker run --rm hello-world

二 构建微服务镜像

• Java Spring Boot 示例 Dockerfile（多阶段构建，减小体积）：
  • FROM eclipse-temurin:17-jdk-alpine AS builder WORKDIR /app COPY pom.xml . COPY src ./src RUN ./mvnw package -DskipTests
  • FROM eclipse-temurin:17-jre-alpine WORKDIR /app COPY --from=builder /app/target/*.jar app.jar EXPOSE 8080 CMD [“java”,“-jar”,“/app.jar”]
• Node.js 示例 Dockerfile：
  • FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . EXPOSE 3000 CMD [“node”,“server.js”]
• 构建镜像（在包含 Dockerfile 的目录执行）：
  • docker build -t yourorg/user-service:1.0.0 .
  • docker build -t yourorg/gateway:1.0.0 .

三 使用 Docker Compose 编排多服务

• 目录约定：

  • project/
    • docker-compose.yml
    • gateway/
    • user-service/
    • order-service/

• 示例 docker-compose.yml（含 MySQL 8.0、Redis 6、Nacos 2.x、业务服务与网关）：

  • version: “3.8” services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: RootPass!23 MYSQL_DATABASE: demo ports: - “3306:3306” volumes: - mysql_data:/var/lib/mysql healthcheck: test: [“CMD”, “mysqladmin”, “ping”, “-h”, “localhost”, “-u$$MYSQL_USER”, “-p$$MYSQL_PASSWORD”] interval: 10s timeout: 5s retries: 5

    redis: image: redis:6-alpine ports: - “6379:6379” healthcheck: test: [“CMD”, “redis-cli”, “ping”] interval: 10s timeout: 5s retries: 5

    nacos: image: nacos/nacos-server:v2.4.3 environment: MODE: standalone SPRING_DATASOURCE_PLATFORM: mysql MYSQL_SERVICE_HOST: mysql MYSQL_SERVICE_PORT: 3306 MYSQL_SERVICE_DB_NAME: nacos MYSQL_SERVICE_USER: root MYSQL_SERVICE_PASSWORD: RootPass!23 ports: - “8848:8848” depends_on: mysql: condition: service_healthy healthcheck: test: [“CMD”, “curl”, “-f”, “http://localhost:8848/nacos/”] interval: 10s timeout: 5s retries: 5

    gateway: build: ./gateway ports: - “8080:8080” depends_on: nacos: condition: service_healthy environment: SPRING_PROFILES_ACTIVE: prod NACOS_SERVER_ADDR: nacos:8848

    user-service: build: ./user-service depends_on: mysql: condition: service_healthy redis: condition: service_healthy nacos: condition: service_healthy environment: SPRING_PROFILES_ACTIVE: prod NACOS_SERVER_ADDR: nacos:8848 DB_HOST: mysql DB_PORT: 3306 DB_NAME: demo DB_USER: root DB_PASSWORD: RootPass!23 REDIS_HOST: redis REDIS_PORT: 6379

    order-service: build: ./order-service depends_on: mysql: condition: service_healthy nacos: condition: service_healthy environment: SPRING_PROFILES_ACTIVE: prod NACOS_SERVER_ADDR: nacos:8848

    volumes: mysql_data:

• 启动与常用命令：

  • 构建并启动：docker compose up --build -d
  • 查看状态：docker compose ps
  • 查看日志：docker compose logs -f gateway user-service
  • 重启：docker compose restart gateway
  • 下线：docker compose down（加 -v 同时清理卷）

四 配置与网络要点

• 服务发现与配置：将微服务的配置中心/注册中心地址改为 Docker 内部域名，例如 nacos:8848；数据库与缓存使用服务名（如 mysql:3306、redis:6379），避免写 localhost。

• 健康检查与启动顺序：为 MySQL、Redis、Nacos 配置 healthcheck，业务服务通过 depends_on 的 condition 等待依赖就绪，减少启动期连接失败。

• 数据与配置持久化：数据库使用命名卷（如示例的 mysql_data）；Nacos 如需外置配置，可挂载 config 目录或接入外部数据库。

• 构建与运行最佳实践：Java 使用多阶段构建减小镜像；Node 使用多阶段或 dist 构建；镜像标签包含版本号；Compose 文件使用 3.8 及以上版本以获得健康检查与 depends_on condition 支持。

五 可视化管理与后续演进

• 可视化管理：部署 Portainer 管理容器与 Stack，图形化执行 docker-compose.yml、查看日志与资源使用，适合团队协作与运维。

• 监控与日志：引入 Prometheus + Grafana 做指标监控，使用 ELK/EFK 或 Loki 收集容器日志，便于故障排查与容量规划。

• 编排演进：单机多容器用 Docker Compose 足够；需要集群与弹性伸缩时，可迁移到 Docker Swarm 或 Kubernetes。