GitLab 配置 CI/CD 自动化部署 Laravel 项目

说明

通过 Gitlab 实现 CI/CD 自动化部署有多种方式，本文只针对使用 shell 这一种方式进行实际操作说明，其他方式可自行查阅文档。

本文实现的 shell 方式，其自动化部署的核心是通过 rsync 命令进行文件同步。

前置条件

• 在 Gitlab 上管理的任意项目。
• 非 Docker 部署，Docker 部署项目需要选择对应镜像，其他步骤大致相同。

安装GitLab-Runner

# 添加yum源
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash

# 安装gitlab-runner
yum -y install gitlab-runner

# 启动 重起 停止gitlab-runner
sudo gitlab-runner start
sudo gitlab-runner restart
sudo gitlab-runner stop

# 查看gitlab-runner运行状态 
sudo gitlab-runner status 

安装后，系统会自动创建 gitlab-runner 用户，并以该用户运行程序，为解决后面部署推送涉及的目录权限问题，改为用 root 用户执行。

# 使用ps查看当前运行用户
ps -aux|grep gitlab-runner

# uninstall gitlab-runner
sudo gitlab-runner uninstall

# 重新安装，指定运行用户，并指定gitlab-runner工作目录
sudo gitlab-runner install --user=root --working-directory=/home/gitlab-runner

# 重启gitlab-runner
sudo gitlab-runner restart

打开 Gitlab ，找到你要配置 Gitlab CI/CD 持续集成的项目，如：outsource-web

1. 依次点击： gitlab-project -> setting -> CI/CD -> Runners
2. 找到 Specific Runners -> Set up a specific Runner manually（手动设置）
3. 记录 Set up a specific Runner manually 该项下的 URL、token

回到 Linux 终端，执行注册命令：

# 注册命令
sudo gitlab-runner register 

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):: 
# 输入上面步骤找到的URL，示例：https://gitlab.xxx.com/
Please enter the gitlab-ci token for this runner: 
# 输入上面步骤找到的token 
Please enter the gitlab-ci description for this runner: 
# 为该gitlab runner自定义一个名称，示例：web  
Please enter the gitlab-ci tags for this runner (comma separated): 
# 为该gitlab runner定义一组tag，以逗号隔开，表示只有匹配到这些tag，才会用该runner执行job。示例：web1
Please enter the executor: docker, docker-ssh, virtualbox, docker-ssh+machine, custom, shell, ssh, docker+machine, kubernetes, parallels: 
# 为该runner指定一个executor，由于这里用shell作为示例，输入：shell 

#注册成功
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

注册内容可在 /etc/gitlab-runner/config.toml 文件中查看，也可在此文件进行修改

至此，Gitlab-Runner 已注册完成，重启服务，输入：

# 重启gitlab-runner
sudo gitlab-runner restart

这时，可以在项目中看到该runner已经配置好，且处于运行中（绿色图标）

在 Runner 下找到 Set up a specific Runner manually 可看到下方 Runners activated for this project

配置 .gitlab-ci.yml 文件

因该文档选择的执行程序为 shell ，故采用 rsync 命令进行目录同步，如有多台机器新增配置即可。

如对 gitlab-runner 进行注册时选择执行程序为 docker 等，该配置并不适用。

before_script:
    - date
stages:
    - build
    - test
    - deploy

deploy_in_web1:
    stage: deploy
    script:
        - git checkout master
        - git pull
        - rsync -rvz --no-owner --no-group --no-perms --progress --exclude=".*" --exclude="/vendor" --delete $CI_PROJECT_DIR/ /data/项目路径
    only:
        - master
    tags:
        - "web1"
        

#配置多台机器，新增配置即可
deploy_in_web2:
    stage: deploy
    script:
        - git checkout master
        - git pull
        - rsync -rvz --no-owner --no-group --no-perms --progress --exclude=".*" --exclude="/vendor" --delete $CI_PROJECT_DIR/ /data/项目路径
    only:
        - master
    tags:
        - "web2"        

rsync 命令 – exclude参数：指定忽略文件或目录

使用 CI/CD

提交该配置文件至项目根目录，提交 master 或合并分支至 master 时代码自动同步至服务器。