Debian Docker如何简化应用部署流程

在 Debian 上用 Docker 简化应用部署的实操方案

一标准化环境与一键部署

安装 Docker 与 Docker Compose（推荐插件方式）
- 更新索引并安装依赖：sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates curl gnupg software-properties-common
- 添加官方 GPG 密钥与 APT 源（使用 keyring 更安全）：
  - curl -fsSL https://download.docker.com/linux/debian/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/debian $(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /devref
- 安装并验证：sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
- 非 root 使用与开机自启：sudo usermod -aG docker $USER && sudo systemctl enable --now docker
目标机准备
- 建议预置应用目录（如 /opt/myapp）与 docker-compose.yml，CI 只负责 pull 与 up，减少在 CI 中传递敏感配置
- 如需在 CI 中远程部署，为目标机配置 SSH 免密登录（将 CI 的公钥加入目标机 ~/.ssh/authorized_keys）

二极简应用模板与 Compose 编排

单容器示例 Dockerfile（基于 Debian 的 Nginx）
- FROM debian:bookworm-slim
- RUN apt-get update && apt-get install -y --no-install-recommends nginx && rm -rf /var/lib/apt/lists/*
- EXPOSE 80
- CMD [“nginx”, “-g”, “daemon off;”]
构建与运行
- 构建：docker build -t my-debian-nginx .
- 运行：docker run -d -p 8080:80 --name my-nginx my-debian-nginx
多容器示例 docker-compose.yml（Flask + PostgreSQL）
- version: ‘3.8’
- services:
  - web:
    - build: .
    - ports: [“5000:5000”]
    - depends_on: [db]
    - environment: [“DATABASE_URL=postgresql://user:password@db:5432/mydb”]
  - db:
    - image: postgres:15-alpine
    - environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=mydb
    - volumes: [“postgres_data:/var/lib/postgresql/data”]
- volumes:
  - postgres_data:
部署与更新
- 启动：docker compose up -d
- 更新：在 CI 或目标机执行 docker compose pull && docker compose up -d --force-recreate

三 CI/CD 自动化部署

GitHub Actions 云端构建与远程部署
- 触发分支：如 main
- 关键步骤：拉取代码 → 登录镜像仓库（DOCKERHUB_USERNAME / DOCKERHUB_TOKEN）→ 构建并推送镜像（带 git sha 与 latest 标签）→ 通过 SSH 在 Debian 目标机执行部署脚本
- 示例工作流要点（精简版）
  - name: Deploy Docker
  - on: push: branches: [ main ]
  - jobs:
    - build-and-deploy:
      - runs-on: ubuntu-latest
      - steps:
        
        uses: actions/checkout@v4
        
        uses: docker/login-action@v3（登录 Docker Hub）
        
        uses: docker/build-push-action@v5（推送 ${{ secrets.DOCKERHUB_USERNAME }}/myapp:${{ github.sha }} 与 latest）
        
        uses: appleboy/ssh-action@v1（在目标机执行：cd /opt/myapp && docker compose pull && docker compose up -d --force-recreate）
- 仓库 Secrets：DOCKERHUB_USERNAME、DOCKERHUB_TOKEN、PROD_HOST、PROD_USER、PROD_SSH_KEY
Jenkins 在 Debian 上编排全流程
- 安装与权限：sudo apt-get install -y openjdk-11-jdk；按官方源安装 Jenkins；sudo usermod -aG docker jenkins；sudo systemctl enable --now jenkins
- Pipeline 要点：Checkout → Build（docker build -t $IMAGE） → Push（使用 withRegistry 推送 BUILD_NUMBER 与 latest） → Deploy（SSH 执行：cd /opt/myapp && docker compose pull && docker compose up -d --force-recreate）

四生产可用的最佳实践

镜像与标签
- 避免使用 latest 作为发布标签，使用 git sha 或 语义化版本；CI 同时打 latest 仅作便捷拉取
部署策略
- 优先使用 Docker Compose 管理服务；在部署脚本中使用 pull + up -d --force-recreate 或 docker compose up -d --no-deps 做滚动更新；必要时增加 healthcheck 与回滚流程
安全
- 禁止在镜像中硬编码 密钥/密码；通过 Secrets 注入或使用 Docker Secrets/外部配置中心；SSH 使用密钥且最小权限
可观测性
- 容器设置 restart=unless-stopped；统一日志驱动（如 json-file 或对接 ELK/Fluentd）；为关键路径添加 健康检查 与超时
回滚与演练
- 保留最近 N 个镜像标签；在 CI/CD 中提供 手动回滚 选项（如部署前记录当前 digest，回滚时指定该 digest 重新部署）
多机与编排
- 多实例/多环境建议引入 Swarm/Kubernetes；若仅单机多服务，使用 Compose 的 profiles 与 depends_on 管理依赖与启动顺序

最新问答