CircleCI Orbのテストを自動化しよう


CircleCIのOrbなんとテスト書けますが、ドキュメントを読んでも自動化までなかなか遠かったので書き残しておきます。

Orbのテストを書く記事なので、Orbはすでに書いてある前提で書いていきます。

circleci/[email protected] で動作確認済です。
https://circleci.com/orbs/registry/orb/circleci/orb-tools?version=9.0.0

前準備

CircleCIのPersonal API Tokens

Orbの公開などするためにCircleCIのAPI Tokenを払い出し、環境変数CIRCLE_TOKENにセットします。プロジェクトごとにTokenを発行するのが面倒なので、Contextsにセットしておくと便利です。
ちなみに、プロジェクトのAPI Tokenでは動きませんでした。

テストを書く

テストを.circleci/config.ymlに書いていきます。
circleci/orb-toolsに便利なJobが揃ってるので、これを活用して書いていきます。
https://circleci.com/orbs/registry/orb/circleci/orb-tools

大まかな流れとしては

  1. orbをpackする (orb-tools/pack)
  2. dev:alphaとしてOrb Registryにpublishする (orb-tools/publish-dev)
  3. run-integration-tests Pipeline Parameterをtrueにしてorbのテストが書かれているworkflowをkickする (orb-tools/trigger-integration-tests-workflow)
  4. テストのstepを流す (orb-tools/test-in-builds)

ポイントはテストしたいorbのpublishと、実際のテストはworkflowが分かれているいて、publishした後にテストのworkflowがkickしていることです。
workflowが読み込まれた時点でorbを読み込まれているので、workflow実行中に上書きしても、そのdev:alphaは前回Publishしたものを使ってしまいます。

version: 2.1

orbs:
  orb-tools: circleci/[email protected]
  # For test
 <orb-name>-alpha: <namespace/orb-name>@dev:alpha

# https://circleci.com/docs/2.0/pipeline-variables/
parameters:
  run-integration-tests:
    type: boolean
    default: false
  dev-orb-version:
    type: string
    default: "dev:alpha"

workflows:
  version: 2
  dev:
    # これを書かないと無限ループする
    unless: << pipeline.parameters.run-integration-tests >>
    jobs:
      - orb-tools/pack:
          name: pack-dev
      - orb-tools/publish-dev:
          name: publish-dev
      # Contextsを使う場合
          # もしくは環境変数`CIRCLE_TOKEN`が設定がされていればOK
          context: orb-publishing
          requires: [pack-dev]
          orb-name: <namespace/orb-name>
          publish-token-variable: CIRCLE_TOKEN
          validate: true
          checkout: false
          attach-workspace: true
      # このjob内で pipeline.parameters.run-integration-tests がtrueに変わる
      - orb-tools/trigger-integration-workflow:
          name: trigger-integration-workflow-dev
      # Contextsを使う場合
          # もしくは環境変数`CIRCLE_TOKEN`が設定がされていればOK
          context: orb-publishing
          requires: [publish-dev]

  integration_dev:
    when: << pipeline.parameters.run-integration-tests >>
    jobs:
      - orb-tools/pack:
          name: pack-integration_dev
      - orb-tools/test-in-builds:
          name: test-in-builds-integration_dev
          requires: [pack-integration_dev]
          orb-name: <orb-name>-alpha
          attach-workspace: true
          test-steps:
            - run: echo "ここにテストを書く"

個人の好みが出ているところを少しだけ補足しておくと、
workflow中でorbを使ったjobにわざわざnameをつけているのは、job名が重複したときにorb-tools/pack-1とか出るが嫌だからです。nameで一意なjob名をつけておくことで、見た目がスッキリしますし、(未だこれをやなくて被害を被ったことはないけど)GitHubの「Require status checks to pass before merging」のブランチの設定がズレる心配もないので安心します。

参考

orb-toolsの実装は大変参考になります。
https://github.com/CircleCI-Public/orb-tools-orb/blob/e302710073ca365243bf990bfe3dfb66573843a1/.circleci/config.yml

↑を参考に自分で作ってみたorbです。
https://github.com/sawadashota/envsubst-orb