正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

GitHubリポジトリでGitLab CI/CDを使用する

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

GitLab CI/CDは、GitHub.comおよびGitHub Enterpriseで、CI/CDプロジェクトを作成して、GitHubリポジトリをGitLabに接続することで使用できます。

GitHubリポジトリでGitLab CI/CDパイプラインを使用するのビデオをご覧ください。

GitHubの制限事項により、外部CI/CDリポジトリとしてGitHub OAuthを使用してGitHubで認証することはできません。

パーソナルアクセストークンで接続

パーソナルアクセストークンは、GitHub.comリポジトリをGitLabに接続するためにのみ使用でき、GitHubユーザーはオーナーロールを持っている必要があります。

GitHubで1回限りの認可を実行して、GitLabにリポジトリへのアクセスを許可するには、次の手順に従います:

  1. GitHubで、トークンを作成します:
    1. https://github.com/settings/tokens/newを開きます。
    2. パーソナルアクセストークンを作成します。
    3. トークンの説明を入力し、repoとadmin:repo_hookを許可するようにスコープを更新して、GitLabがプロジェクトにアクセスし、コミットステータスを更新し、新しいコミットをGitLabに通知するWebhookを作成できるようにします。
  2. GitLabで、プロジェクトを作成します:
    1. 左側のサイドバーの上部で、新規作成（ plus ）を選択し、新規プロジェクト/リポジトリを選択します。
    2. 外部リポジトリのCI/CDを実行を選択します。
    3. GitHubを選択します。
    4. パーソナルアクセストークンには、トークンを貼り付けます。
    5. List Repositories（リポジトリ一覧）を選択します。
    6. 接続を選択して、リポジトリを選択します。
  3. GitHubで、.gitlab-ci.ymlを追加して、GitLab CI/CDを構成します。

GitLab:

  1. プロジェクトをインポートします。
  2. プルミラーリングを有効にします。
  3. GitHubプロジェクトインテグレーションを有効にします。
  4. GitHubにWebhookを作成して、新しいコミットをGitLabに通知します。

手動で接続

GitHub EnterpriseをGitLab.comで使用するには、この方法を使用します。

リポジトリのGitLab CI/CDを手動で有効にするには、次の手順に従います:

  1. GitHubで、トークンを作成します:

    1. https://github.com/settings/tokens/newを開きます。
    2. パーソナルアクセストークンを作成します。
    3. トークンの説明を入力し、repoを許可するようにスコープを更新して、GitLabがプロジェクトにアクセスし、コミットステータスを更新できるようにします。

  2. GitLabで、プロジェクトを作成します:

    1. 左側のサイドバーの上部で、新規作成（ plus ）を選択し、新規プロジェクト/リポジトリを選択します。
    2. 外部リポジトリのCI/CDを実行とリポジトリのURLを選択します。
    3. GitリポジトリのURLフィールドに、GitHubリポジトリのHTTPS URLを入力します。プロジェクトがプライベートの場合は、作成したばかりのパーソナルアクセストークンを認証に使用します。
    4. 他のすべてのフィールドに入力し、プロジェクトを作成を選択します。GitLabは、ポーリングベースのプルミラーリングを自動的に構成します。

  3. GitLabで、GitHubプロジェクトインテグレーションを有効にします:

    1. 左側のサイドバーで、設定 > インテグレーションを選択します。
    2. 有効チェックボックスを選択します。
    3. パーソナルアクセストークンとHTTPSリポジトリのURLをフォームに貼り付け、保存を選択します。

  4. GitLabで、APIスコープのパーソナルアクセストークンを作成して、新しいコミットをGitLabに通知するGitHub Webhookを認証します。

  5. GitHubで、設定 > Webhooksから、新しいコミットをGitLabに通知するWebhookを作成します。

    Webhook URLは、GitLabパーソナルアクセストークンを使用して、GitLab APIに設定し、プルミラーリングをトリガーする必要があります:

    https://gitlab.com/api/v4/projects/<NAMESPACE>%2F<PROJECT>/mirror/pull?private_token=<PERSONAL_ACCESS_TOKEN>

    Let me select individual events（個別のイベントを選択させてください）オプションを選択し、プルリクエストチェックボックスとプッシュチェックボックスをオンにします。これらの設定は、外部プルリクエストのパイプラインに必要です。

  6. GitHubで、.gitlab-ci.ymlを追加して、GitLab CI/CDを構成します。