動機

ローカル環境でCircleCIの設定ファイルのデバッグを行いたかった．

環境

Homebrew: 2.2.2
circleci version: 0.1.5879+416032d

前提

CLI利用時の前提条件がいくつかある．リファレンスを参照．

手順

設定ファイルのバリデーション

# ヘルプ
$ circleci config validate -h
Check that the config file is well formed.

Usage:
  circleci config validate <path> [flags]
Aliases:
  validate, check

# 実行
$ circleci config validate -c .circleci/config.yml
$ circleci config check -c .circleci/config.yml

ジョブの実行

CircleCI v2.1はサポートされていないとのこと．以前Issueにはあがっていたが，クローズされてしまっているので，今後対応されるかは不明．

バージョン2.0用の設定に置き換え

# 標準出力
$ circleci config process .circleci/config.yml

# ファイル出力
$ circleci config process .circleci/config.yml > ci_local.yml

実行

失敗

$ circleci local execute -c ci_local.yml
Docker image digest: sha256:1e869e97892e5398d1b1e91beb9ddb69403ac9ba4b3b74d2940a0d37a2471dd4
====>> Spin up Environment
Build-agent version 1.0.16017-6bc91f58 (2019-09-23T16:08:17+0000)
Error: Configuration errors: 1 error occurred:

* Cannot find a job named `build` to run in the `jobs:` section of your configuration file.
If you expected a workflow to run, check your config contains a top-level key called 'workflows:'
Step failed
Task failed
Error: 1 error occurred:

* Cannot find a job named `build` to run in the `jobs:` section of your configuration file.
If you expected a workflow to run, check your config contains a top-level key called 'workflows:'

ジョブ名のデフォルト値は"build"なので，異なる場合はジョブ名を付与する必要があった


$ circleci local execute --help | grep job
Run a job in a container on the local machine
      --job string            job to be executed (default "build")

$ circleci local execute --job test -c ci_local.yml

ちなみにこちらでも同様の結果が得られた．


$ circleci build --job test -c ci_local.yml

課題

下記のコマンドどちらでもジョブを実行することができたが，両者の違いまでは調べていない．


$ circleci build --job test -c ci_local.yml
$ circleci local execute --job test -c ci_local.yml

ヘルプの内容も同一だった．


$ circleci local execute -h
Run a job in a container on the local machine


Usage:
  circleci build [flags]

Flags:
      --branch string         Git branch
      --checkout-key string   Git Checkout key (default "~/.ssh/id_rsa")
  -c, --config string         config file (default ".circleci/config.yml")
  -e, --env -e VAR=VAL        Set environment variables, e.g. -e VAR=VAL
  -h, --help                  help for build
      --index int             node index of parallelism
      --job string            job to be executed (default "build")
      --node-total int        total number of parallel nodes (default 1)
      --repo-url string       Git Url
      --revision string       Git Revision
      --skip-checkout         use local path as-is (default true)
  -v, --volume strings        Volume bind-mounting

Global Flags:
      --host string    URL to your CircleCI host, also CIRCLECI_CLI_HOST (default "https://circleci.com")
      --token string   your token for using CircleCI, also CIRCLECI_CLI_TOKEN

参考