怎么用Gitlab-CI持续部署到远程机器

发布时间：2021-09-10 10:52:33 作者：chen
来源：亿速云阅读：159

# 怎么用Gitlab-CI持续部署到远程机器

## 前言

在现代软件开发中，持续集成和持续部署(CI/CD)已成为提升交付效率的关键实践。GitLab-CI作为GitLab内置的持续集成工具，能够帮助团队自动化完成代码构建、测试和部署的全流程。本文将详细介绍如何利用GitLab-CI将应用持续部署到远程服务器，涵盖从基础配置到高级实践的完整方案。

## 一、GitLab-CI基础概念

### 1.1 核心组件

- **Runner**：执行CI/CD作业的轻量级代理程序
- **.gitlab-ci.yml**：定义CI/CD流程的配置文件
- **Pipeline**：由多个阶段(stages)组成的工作流
- **Job**：每个阶段中的具体执行任务

### 1.2 工作原理

```mermaid
graph LR
    A[代码推送] --> B(触发Pipeline)
    B --> C{执行构建}
    C --> D{运行测试}
    D --> E[部署到服务器]

二、部署到远程服务器的三种方式

2.1 SSH直接连接（推荐）

配置步骤：

在服务器生成SSH密钥对：
```
ssh-keygen -t ed25519 -C "gitlab-ci"
```
将公钥添加到目标服务器的~/.ssh/authorized_keys
在GitLab项目的CI/CD变量中添加：
- SSH_PRIVATE_KEY：私钥内容
- SERVER_IP：目标服务器IP
- DEPLOY_USER：部署用户名
示例.gitlab-ci.yml配置：

deploy_production:
  stage: deploy
  script:
    - mkdir -p ~/.ssh
    - echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
    - chmod 600 ~/.ssh/id_ed25519
    - ssh-keyscan $SERVER_IP >> ~/.ssh/known_hosts
    - ssh $DEPLOY_USER@$SERVER_IP "cd /var/www/app && git pull && docker-compose up -d"
  only:
    - main

2.2 使用Docker执行器

适合已在服务器部署Docker的环境：

deploy:
  image: alpine/ssh
  script:
    - apk add --no-cache openssh-client
    - ssh $USER@$SERVER "bash deploy-script.sh"

2.3 通过API触发部署（适合复杂系统）

在目标服务器部署webhook接收器
CI阶段调用部署API：

deploy:
  script:
    - curl -X POST https://deploy-api.example.com/trigger \
      -H "Authorization: Token $DEPLOY_TOKEN" \
      -d '{"ref": "$CI_COMMIT_REF_NAME"}'

三、高级配置技巧

3.1 多环境部署配置

stages:
  - test
  - deploy

deploy_staging:
  stage: deploy
  environment:
    name: staging
    url: https://staging.example.com
  script: 
    - ./deploy.sh staging
  only:
    - develop

deploy_production:
  stage: deploy
  environment:
    name: production
    url: https://example.com
  script:
    - ./deploy.sh production
  when: manual
  only:
    - main

3.2 回滚机制实现

在服务器上维护版本快照
添加回滚任务：

rollback_prod:
  stage: deploy
  script:
    - ssh $DEPLOY_USER@$SERVER "./rollback.sh"
  when: manual

3.3 使用Ansible进行部署

deploy:
  before_script:
    - apt-get update -y && apt-get install -y ansible
  script:
    - ansible-playbook -i $SERVER_IP, deploy-playbook.yml

四、安全最佳实践

密钥管理：
- 使用GitLab的受保护变量
- 定期轮换密钥
- 限制SSH用户的权限
网络防护：
- 部署服务器应限制访问IP
- 使用VPN或跳板机架构

审计日志： “`yaml deploy: script:

   - echo "$(date): Deployed by $GITLAB_USER_NAME" >> /var/log/deploy.log

”`

五、常见问题排查

5.1 连接失败排查步骤

测试SSH连接：

ssh -T -i ~/.ssh/id_ed25519 $USER@$SERVER

检查服务器日志：
```
tail -f /var/log/auth.log
```
验证GitLab Runner权限

5.2 部署超时处理

variables:
  SSH_OPTS: "-o ConnectTimeout=30 -o ServerAliveInterval=60"

5.3 磁盘空间不足

添加清理任务：

cleanup:
  script:
    - ssh $SERVER "docker system prune -f"

六、完整示例项目

参考配置结构：

├── .gitlab-ci.yml
├── deploy/
│   ├── staging.sh
│   └── production.sh
└── ansible/
    ├── inventory
    └── playbook.yml

结语

通过GitLab-CI实现自动化远程部署可以显著提升交付效率，但需要注意安全防护和异常处理。建议从简单部署开始，逐步实现多环境、蓝绿部署等高级方案。实际配置时，应根据项目需求选择合适的部署策略，并建立完善的监控和回滚机制。

提示：GitLab 15.0+版本提供了更强大的部署功能，建议查看官方文档获取最新特性。 “`

（全文约1750字）