GitHubで複数種類のCI/CDサービスと連携時の必須ステータスチェックの動作を確認してみた

若槻龍太

2020.06.04

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちは、CX事業本部の若槻です。

GitHubにはrequired status checks（必須ステータスチェック）という、指定のCI/CDにPassした時にのみブランチに変更を加えられるようにするブランチ保護の設定があります。

About required status checks - GitHub Help

Required status checks ensure that all required CI tests are passing before collaborators can make changes to a protected branch.

今回は、GitHubで複数種類のCI/CDサービスと連携したRepositoryのPull Requestではこの必須ステータスチェックがちゃんと動作するのか？を確認してみました。

確認してみた

以下の3種類のCI/CDサービスに連携済みのRepositoryで確認を行ってみます。BranchへのPushによりそれぞれのサービス上でCIが実行されるように連携設定済みとなります。

GitHub Actions
CircleCI
Travis CI

参考までに、今回利用した各CI/CDサービスのコンフィグファイルは以下のようになります。

version: 2.1

orbs:
  python: circleci/python@0.2.1

jobs:
  build-and-test:
    executor: python/default
    steps:
      - checkout
      - run:
          name: build and test
          command: |
            pip install pipenv
            pipenv sync
            make lint test-unit
workflows:
  ci:
    jobs:
      - build-and-test

name: Workflow

on:
  push:

jobs:
  cicd:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2

    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: 3.7

    - name: Install dependencies
      run: |
        pip install pipenv
        pipenv sync
    - name: Lint and Test
      run: |
        make lint test-unit
    - name: Deploy to AWS
      if: github.ref == 'refs/heads/master'
      env:
        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        AWS_DEFAULT_REGION: ap-northeast-1
      run: |
        make deploy

language: python
python:
  - "3.7"
install:
  - pip install pipenv
  - pipenv sync
script:
  - make lint test-unit

Branchの必須ステータスチェックを有効化

事前の設定として、Branchの必須ステータスチェックを有効化して、すべてのCI/CDサービスでのCI/CDがPassした時のみPull RequestからmasterBranchへのMergeが可能となるようにするブランチ保護ルールを作成します。

Repositoryの[Settings]タブ - [Branches] - [Branch protection rules]で[Add rule]をクリックします。

[Branch name patter]でmasterを入力します。 [Require status checks to pass before merging]および[Require branches to be up to date before merging]にチェックを入れ、必須条件とさせたいCI/CDの実行にチェック入れます。[Save changes]をクリックします。