前端 CI/CD 流程与自动化部署实践

GitLab CI 配置

# .gitlab-ci.yml
stages:
  - test
  - build
  - deploy
test:
  stage: test
  image: node:16
  script:
    - npm install
    - npm test
  only:
    - main
build:
  stage: build
  image: node:16
  script:
    - npm install
    - npm run build
  artifacts:
    paths:
      - build/
  only:
    - main
deploy:
  stage: deploy
  image: alpine:latest
  script:
    - apk add --no-cache rsync openssh
    - mkdir -p ~/.ssh
    - echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
    - chmod 600 ~/.ssh/id_rsa
    - ssh-keyscan -H $REMOTE_HOST >> ~/.ssh/known_hosts
    - rsync -avz --delete build/ $REMOTE_USER@$REMOTE_HOST:$REMOTE_TARGET
    - ssh $REMOTE_USER@$REMOTE_HOST "sudo systemctl restart nginx"
  only:
    - main
  environment:
    name: production

Jenkins 配置

// Jenkinsfile
pipeline {
  agent any
  stages {
    stage('Checkout') {
      steps {
        checkout scm
      }
    }
    stage('Install Dependencies') {
      steps {
        sh 'npm install'
      }
    }
    stage('Test') {
      steps {
        sh 'npm test'
      }
    }
    stage('Build') {
      steps {
        sh 'npm run build'
      }
    }
    stage('Deploy') {
      steps {
        sh '''
          scp -r build/* user@server:/var/www/html/
          ssh user@server "sudo systemctl restart nginx"
        '''
      }
    }
  }
  post {
    always {
      echo 'Pipeline completed'
    }
    success {
      echo 'Deployment successful'
    }
    failure {
      echo 'Deployment failed'
    }
  }
}

环境变量配置

# .env
REMOTE_HOST=your-server.com
REMOTE_USER=deploy
REMOTE_TARGET=/var/www/html/
# SSH 密钥请在 CI/CD 平台的 secrets 中配置，勿直接写入

注意事项

CI/CD 能提高部署效率，但需避免滥用导致流程复杂化。配置耗时过长可能得不偿失，应调试配置而非盲目自动化。过度配置包含不必要步骤会延长部署时间，例如运行无关测试。大型项目必不可少，小型项目需权衡成本。CI/CD 目的是提高效率和可靠性，若配置导致更慢或不可靠则失去意义。