README.zh-tw.md

drone-gitlab-ci

繁體中文 | 简体中文 | English

Drone 插件用於觸發 gitlab-ci 任務。

GitLab 設定

請參閱 Pipeline trigger tokens API 的詳細文檔。您可以創建個人訪問令牌來進行身份驗證：

1. GitLab API。
2. GitLab 儲存庫。
3. GitLab 註冊表。

請參閱 GitLab token 概述。

如何獲取項目 ID？前往您的項目 設定 ➔ 一般 下的一般項目。

構建或下載二進制文件

可以從 發佈頁面 下載預編譯的二進制文件。支持以下操作系統類型。

• Windows amd64/386
• Linux amd64/386
• Darwin amd64/386

安裝 Go

go install github.com/appleboy/drone-gitlab-ci

或使用以下命令構建二進制文件：

make build

用法

有三種方式觸發 gitlab-ci 任務。

從二進制文件使用

觸發任務。

drone-gitlab-ci \
  --host https://gitlab.com/ \
  --token XXXXXXXX \
  --ref master \
  --project-id gitlab-ci-project-id

啟用調試模式。

drone-gitlab-ci \
  --host https://gitlab.com/ \
  --token XXXXXXXX \
  --ref master \
  --project-id gitlab-ci-project-id \
  --debug

從 docker 使用

觸發任務。

docker run --rm \
  -e GITLAB_HOST=https://gitlab.com/
  -e GITLAB_TOKEN=xxxxx
  -e GITLAB_REF=master
  -e GITLAB_ID=gitlab-ci-project-id
  appleboy/drone-gitlab-ci

啟用調試模式。

docker run --rm \
  -e GITLAB_HOST=https://gitlab.com/ \
  -e GITLAB_TOKEN=xxxxx \
  -e GITLAB_REF=master \
  -e GITLAB_ID=gitlab-ci-project-id \
  -e GITLAB_DEBUG=true \
  appleboy/drone-gitlab-ci

從 drone ci 使用

從工作目錄執行：

docker run --rm \
  -e PLUGIN_HOST=https://gitlab.com/ \
  -e PLUGIN_TOKEN=xxxxx \
  -e PLUGIN_REF=master \
  -e PLUGIN_ID=gitlab-ci-project-id \
  -e PLUGIN_DEBUG=true \
  -v $(pwd):$(pwd) \
  -w $(pwd) \
  appleboy/drone-gitlab-ci

您可以獲取更多有關如何在 drone 中使用 scp 插件的信息。

測試

使用以下命令測試包：

make test