跳至主要內容

Integrating Docker into CI/CD Pipelines - Building Automated Software Delivery Workflows

老马啸西风2025/8/31大约 4 分钟Dockercontainer-docker

将 Docker 集成到 CI/CD 流水线

CI/CD 流水线概述

持续集成和持续部署（CI/CD）是现代软件开发的核心实践，旨在通过自动化流程提高软件交付的速度和质量。Docker 作为容器化技术的代表，为 CI/CD 流水线提供了标准化的环境，确保应用在不同阶段的一致性。

CI/CD 的核心阶段

  1. 持续集成（CI）：

    • 代码提交自动触发构建
    • 自动化测试验证代码质量
    • 快速反馈开发问题

  2. 持续部署（CD）：

    • 自动化部署到测试环境
    • 自动化部署到生产环境
    • 快速交付价值给用户

Docker 在 CI/CD 中的优势

环境一致性

Docker 确保了从开发到生产的环境一致性：

# Dockerfile 确保环境一致性
FROM node:14-alpine

# 安装依赖
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

# 复制应用代码
COPY . .

# 运行应用
EXPOSE 3000
CMD ["node", "server.js"]

快速构建和部署

Docker 镜像的分层特性加速了构建过程：

# 利用构建缓存加速构建
docker build -t myapp:v1.0 .

# 快速部署到不同环境
docker run -d -p 3000:3000 myapp:v1.0

资源隔离

每个构建任务在独立的容器中运行，避免相互干扰：

# GitLab CI 示例
build:
  image: node:14
  script:
    - npm ci
    - npm test
  only:
    - main

主流 CI/CD 工具与 Docker 集成

Jenkins 与 Docker

Jenkins 提供了丰富的 Docker 插件支持：

// Jenkinsfile 示例
pipeline {
    agent any
    
    stages {
        stage('Build') {
            agent {
                docker {
                    image 'node:14'
                }
            }
            steps {
                sh 'npm ci'
                sh 'npm run build'
            }
        }
        
        stage('Test') {
            agent {
                docker {
                    image 'node:14'
                }
            }
            steps {
                sh 'npm test'
            }
        }
        
        stage('Build Docker Image') {
            steps {
                script {
                    docker.build("myapp:${env.BUILD_ID}")
                }
            }
        }
        
        stage('Deploy') {
            steps {
                script {
                    docker.withRegistry('https://registry.example.com', 'docker-registry') {
                        docker.image("myapp:${env.BUILD_ID}").push()
                        docker.image("myapp:${env.BUILD_ID}").push('latest')
                    }
                }
            }
        }
    }
}

GitLab CI 与 Docker

GitLab CI 原生支持 Docker：

# .gitlab-ci.yml 示例
stages:
  - build
  - test
  - deploy

variables:
  DOCKER_DRIVER: overlay2
  DOCKER_TLS_CERTDIR: "/certs"

build:
  stage: build
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
  only:
    - main

test:
  stage: test
  image: node:14
  script:
    - npm ci
    - npm test
  only:
    - main

deploy:
  stage: deploy
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker pull $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
    - docker tag $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA $CI_REGISTRY_IMAGE:latest
    - docker push $CI_REGISTRY_IMAGE:latest
  only:
    - main

GitHub Actions 与 Docker

GitHub Actions 提供了 Docker 容器操作：

# .github/workflows/ci.yml 示例
name: CI/CD Pipeline

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v2
    
    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v1
    
    - name: Login to DockerHub
      uses: docker/login-action@v1
      with:
        username: ${{ secrets.DOCKERHUB_USERNAME }}
        password: ${{ secrets.DOCKERHUB_TOKEN }}
    
    - name: Build and push
      uses: docker/build-push-action@v2
      with:
        context: .
        push: true
        tags: myapp:latest
    
    - name: Run tests in container
      run: |
        docker run myapp:latest npm test

Docker 镜像构建优化

多阶段构建

使用多阶段构建减小镜像大小：

# 多阶段构建示例
# 构建阶段
FROM node:14 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# 运行阶段
FROM node:14-alpine AS runtime
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY --from=builder /app/dist ./dist
EXPOSE 3000
CMD ["node", "dist/index.js"]

构建缓存优化

合理组织 Dockerfile 指令以利用缓存：

# 优化前
FROM node:14
WORKDIR /app
COPY . .
RUN npm ci
RUN npm run build

# 优化后
FROM node:14
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

容器化测试环境

创建测试环境镜像

# test-environment.Dockerfile
FROM node:14

# 安装测试工具
RUN npm install -g mocha chai supertest

# 安装应用依赖
WORKDIR /app
COPY package*.json ./
RUN npm ci

# 复制应用代码
COPY . .

# 暴露测试端口
EXPOSE 3000

# 运行测试
CMD ["npm", "test"]

集成测试环境

# docker-compose.test.yml
version: '3.8'

services:
  app:
    build: .
    environment:
      - NODE_ENV=test
      - DATABASE_URL=postgresql://test:test@db:5432/test
    depends_on:
      - db

  db:
    image: postgres:13
    environment:
      - POSTGRES_USER=test
      - POSTGRES_PASSWORD=test
      - POSTGRES_DB=test
    ports:
      - "5432:5432"

  test:
    build:
      context: .
      dockerfile: test-environment.Dockerfile
    depends_on:
      - app
      - db
    command: ["npm", "test"]

安全考虑

镜像安全扫描

# 使用 Clair 扫描镜像
clair-scanner --ip YOUR_LOCAL_IP myapp:latest

# 使用 Trivy 扫描镜像
trivy image myapp:latest

最小化基础镜像

# 使用最小基础镜像
FROM alpine:latest
# 或
FROM node:14-alpine
# 而不是
FROM ubuntu:latest

非 root 用户运行

# 以非 root 用户运行
RUN addgroup -g 1001 -S appgroup && \
    adduser -S appuser -u 1001 -G appgroup

USER appuser

最佳实践

镜像标签策略

# 使用 Git 提交哈希作为标签
docker build -t myapp:${CI_COMMIT_SHA} .

# 使用语义化版本
docker build -t myapp:v1.2.3 .

# 使用分支名称
docker build -t myapp:${CI_COMMIT_REF_NAME} .

并行构建

# 并行构建多个服务
build-app:
  stage: build
  script:
    - docker build -t myapp:${CI_COMMIT_SHA} .

build-worker:
  stage: build
  script:
    - docker build -t myworker:${CI_COMMIT_SHA} .

构建参数化

# 使用构建参数
ARG NODE_VERSION=14
FROM node:${NODE_VERSION}

ARG APP_ENV=production
ENV NODE_ENV=${APP_ENV}
# 传递构建参数
docker build --build-arg NODE_VERSION=16 --build-arg APP_ENV=staging -t myapp:latest .

缓存管理

# GitLab CI 缓存示例
build:
  script:
    - docker build -t myapp:${CI_COMMIT_SHA} .
  cache:
    key: ${CI_COMMIT_REF_SLUG}
    paths:
      - .npm/

通过本节内容，我们深入了解了如何将 Docker 集成到 CI/CD 流水线中，包括与主流 CI/CD 工具的集成、镜像构建优化、容器化测试环境等方面。掌握这些技能将帮助您构建高效、可靠的自动化软件交付流程。

我是老马，期待与你的下次重逢
Copyright © 2025 老马啸西风