GitLab CI/CD 的使用

GitLab CI/CD 使用

前置條件：

• 在 GitLab 中建立一個可用於持續繼承的項目；
• 擁有項目「維護者」或「擁有者」權限；
• 有可用的 GitLab Runner 用於運行工做；
• 在倉庫的根目錄建立一個 .gitlab-ci.yml 文件，用於定義工做內容；

檢查可用的 GitLab Runner

在 GitLab 中，Runner 是運行持續集成工做內容的代理。

查看可用的 GitLab Runner：Settings > CI/CD > Runners

有綠色圓圈的 Runner 即爲處於激活狀態。

install GitLab Runner

register a runner

建立 .gitlab-ci.yml 文件

.gitlab-ci.yml 文件用於配置具體的工做內容。

在文件中能夠定義如下內容：

• Runner 應該執行的工做結構和順序；
• 遇到特定條件時，Runner 應作出的決策。

建立步驟：

1. Project overview > Details；
2. 選擇提交的分支，點擊+號，選擇New file；
3. 文件名 .gitlab-ci.yml ，填入示例代碼；
4. 點擊 Commit changes。

build-job:
  stage: build
  script:
    - echo "Hello, $GITLAB_USER_LOGIN!"

test-job1:
  stage: test
  script:
    - echo "This job tests something"

test-job2:
  stage: test
  script:
    - echo "This job tests something, but takes more time than test-job1."
    - echo "After the echo commands complete, it runs the sleep command for 20 seconds"
    - echo "which simulates a test that runs 20 seconds longer than test-job1"
    - sleep 20

deploy-prod:
  stage: deploy
  script:
    - echo "This job deploys something from the $CI_COMMIT_BRANCH branch."

$GITLAB_USER_LOGIN 和 $CI_COMMIT_BRANCH 均爲運行時變量。

.gitlab-ci.yml 文件提示

• Runner 能夠使用 docker 容器去運行工做內容。參考：https://docs.gitlab.com/ee/ci...；
• 能夠使用 CI Lint tool 驗證該文件，工具在全部項目中可用；
• 能夠使用 CI/CD configuration visualization 以圖表形式展現文件內容；
• 完整的語法能夠參考：https://docs.gitlab.com/ee/ci...。

查看 pipeline 和工做內容的狀態

在提交修改後，一個 pipeline 將會被啓動。

查看 pipeline ：

• CI/CD > Pipelines
• 點擊 pipeline ID，能夠查看詳情
• 點擊工做標題，能夠查看詳細的工做過程

若是工做狀態爲 stuck，請檢查項目中是否有可用的 Runner 。

參考：https://docs.gitlab.com/ee/ci...