CI/CD： GitLab Runner安裝注冊配置管理

作者：Lizeyang 2023-04-27 08:18:25

GitLab Runner是用Go編寫的，可以作為一個二進制文件運行，不需要特定于語言的要求。它旨在在GNU / Linux，macOS和Windows操作系統上運行。只要您可以在其他操作系統上編譯Go二進制文件，其他操作系統就可能會運行。

GitLab Runner是一個開源項目，用于運行您的作業并將結果發送回GitLab。它與GitLab CI結合使用，GitLab CI是GitLab隨附的用于協調作業的開源持續集成服務。

安裝要求

如果要使用Docker，請安裝最新版本。GitLab Runner需要最少的Docker v1.13.0。

GitLab Runner版本應與GitLab版本同步。

可以在GNU / Linux，macOS，FreeBSD和Windows上安裝和使用GitLab Runner 。您可以使用Docker安裝它，手動下載二進制文件，也可以使用GitLab提供的rpm / deb軟件包的存儲庫。

基于centos安裝

curl -LJO https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_<arch>.rpm
rpm -i gitlab-runner_<arch>.rpm
rpm -Uvh gitlab-runner_<arch>.rpm

基于macos系統安裝

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/v12.6/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
gitlab-runner install
gitlab-runner start

基于Docker運行

mkdir ~/data/gitlab-runner/config
docker run --rm -t -id -v ~/data/gitlab-runner/config:/etc/gitlab-runner gitlab/gitlab-runner:v12.9.0

GitLab Runner注冊

類型

shared ：運行整個平臺項目的作業（gitlab）
group：運行特定group下的所有項目的作業（group）
specific: 運行指定的項目作業（project）

狀態
locked：鎖定無法運行項目作業
paused：暫停不會運行作業

獲取shared類型runnertoken

獲取group類型的runnertoken

進入group -> Settings -> CI/CD -> Runners -> Group Runners

獲取specific類型的runnertoken

進入具體的項目 -> Settings -> CI/CD -> Runners -> Specific Runners。

啟動容器交互式注冊

docker run --rm -t -i -v ~/data/gitlab-runner/config:/etc/gitlab-runner gitlab/gitlab-runner:v12.6.0 register

Runtime platform                                    arch=amd64 os=linux pid=6 revisinotallow=ac8e767a versinotallow=12.6.0
Running in system-mode.
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
http://192.168.1.105
Please enter the gitlab-ci token for this runner:
4tutaeWWL3srNEcmHs1s
Please enter the gitlab-ci description for this runner:
[00e4f023b5ae]: devops-service-runner
Please enter the gitlab-ci tags for this runner (comma separated):
build
Registering runner... succeeded                     runner=4tutaeWW
Please enter the executor: parallels, virtualbox, docker-ssh+machine, kubernetes, docker+machine, custom, docker, docker-ssh, shell, ssh:
shell
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

非交互式注冊

docker run -itd --rm -v ~/data/gitlab-runner/config:/etc/gitlab-runner  gitlab/gitlab-runner:v12.6.0 register \
  --non-interactive \
  --executor "shell" \
  --url "http://192.168.1.200:30088/" \
  --registration-token "JRzzw2j1Ji6aBjwvkxAv" \
  --description "devops-runner" \
  --tag-list "build,deploy" \
  --run-untagged="true" \
  --locked="false" \
  --access-level="not_protected"

效果：

常用命令

啟動命令：

gitlab-runner --debug <command>   #調試模式排查錯誤特別有用。
gitlab-runner <command> --help    #獲取幫助信息
gitlab-runner run       #普通用戶模式  配置文件位置 ~/.gitlab-runner/config.toml
sudo gitlab-runner run  # 超級用戶模式  配置文件位置/etc/gitlab-runner/config.toml

注冊命令：

gitlab-runner register  #默認交互模式下使用，非交互模式添加 --non-interactive
gitlab-runner list      #此命令列出了保存在配置文件中的所有運行程序
gitlab-runner verify    #此命令檢查注冊的runner是否可以連接，但不驗證GitLab服務是否正在使用runner。--delete 刪除
gitlab-runner unregister   #該命令使用GitLab取消已注冊的runner。
#使用令牌注銷
gitlab-runner unregister --url http://gitlab.example.com/ --token t0k3n
#使用名稱注銷（同名刪除第一個）
gitlab-runner unregister --name test-runner
#注銷所有
gitlab-runner unregister --all-runners

服務管理：

gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
# --user指定將用于執行構建的用戶
#`--working-directory  指定將使用**Shell** executor 運行構建時所有數據將存儲在其中的根目錄
gitlab-runner uninstall #該命令停止運行并從服務中卸載GitLab Runner。
gitlab-runner start     #該命令啟動GitLab Runner服務。
gitlab-runner stop      #該命令停止GitLab Runner服務。
gitlab-runner restart   #該命令將停止，然后啟動GitLab Runner服務。
gitlab-runner status #此命令顯示GitLab Runner服務的狀態。當服務正在運行時，退出代碼為零；而當服務未運行時，退出代碼為非零。

運行Pipeline

stages:
  - build
  - deploy
build:
  stage: build
  tags:
    - build
  only:
    - master
  script:
    - echo "mvn clean "
    - echo "mvn install"
deploy:
  stage: deploy
  tags:
    - deploy
  only:
    - master
  script:
    - echo "hello deploy"

GitLabCI 有助于DevOps人員，例如敏捷開發中，開發與運維是同一個人，最便捷的開發方式。JenkinsCI適合在多角色團隊中，職責分明、配置與代碼分離、插件豐富。

責任編輯：姜華來源： DevOps云學堂

GitLab 開源