- Bitriseドキュメントへようこそ!
- 参考文献
- ワークフローリファレンス
ワークフローリファレンス
すべてのbitrise.ymlプロパティ
利用可能なプロパティの完全なリストは、 bitrise.ymlフォーマットの仕様/リファレンス CLIのドキュメント。
ワークフローは、単一のステップ、環境変数、およびその他の構成のコレクションです。 bitrise run
。
ワークフローの唯一の要件はIDです。例として、この構成では、IDを使用して1つのワークフローを宣言しました test
。
format_version: 1.3.1 workflows: test:
複数のワークフローを定義し、特定のワークフローを実行できます。 bitrise run WORKFLOWID
。
2つのワークフローの定義:
format_version: 1.3.1 workflows: first: second:
利用可能なすべてのワークフローを bitrise.yml
ファイル:
bitrise run
または、代わりに:
bitrise workflows
ワークフローにステップを追加するには、次のようにするだけです。 steps:
次に、ステップを追加します。
format_version: 11 default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git workflows: test: steps: - script: title: First step - script: title: Second step
ワークフロー固有のパラメーターと環境変数を定義できます。ワークフローの環境変数は、ワークフローの実行時に使用され、ワークフローのすべてのステップで使用できます。
format_version: 11 default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git workflows: test: envs: - ENV_VAR_ONE: first value - ENV_VAR_TWO: second value
ワークフローをチェーンして、特定のワークフローの前後に複数のワークフローを実行できます。
format_version: 1.3.1 default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git workflows: send-notifications: steps: # send notifications setup: steps: # setup Steps to run test: before_run: - setup envs: - IS_TEST: "true" steps: # test Steps to run ci: before_run: - test after_run: - send-notifications deploy: before_run: - test steps: # steps to deploy after_run: - send-notifications
上記の例に基づいて、次のコマンドを実行すると、次のようになります。
-
bitrise run send-notifications
:のステップのみsend-notifications
ワークフローが実行されます。 -
bitrise run setup
:のステップのみsetup
ワークフローが実行されます。 -
bitrise run test
:最初のステップsetup
ワークフローが実行され、次にで宣言されたステップtest
ワークフロー。 -
bitrise run ci
:ワークフローのステップを次の順序で実行します。-
setup
-
test
-
ci
(NSci
ワークフローにはステップがありませんが、それは問題ではありません。これは、ここではステップが実行されず、ビルドがチェーン内の次のワークフローで続行されることを意味します)。 -
send-notifications
-
-
bitrise run deploy
:ワークフローのステップを次の順序で実行します。-
setup
-
test
-
deploy
-
send-notifications
-
これは、何を定義できることを意味します setup
と test
であなたのプロジェクトで行う必要があります setup
と test
ワークフローは1回だけで、他のワークフローで再利用できます。ワークフロー間でステップを複製する必要はありません。
Bitrise CLIは、ユーティリティワークフローと呼ばれる小さな表記をサポートしています。たとえば、IDがアンダースコア文字で始まるワークフローです。 _setup
。ユーティリティワークフローは、で直接実行することはできません bitrise run
コマンド:それらはで参照できます before_run
と after_run
プロパティ。
実行すると、ワークフローリストの最後にユーティリティワークフローが表示されます。 bitrise run
また bitrise workflows
:
The following workflows are available: * ci * deploy You can run a selected workflow with: $ bitrise run WORKFLOW-ID The following utility workflows are defined: * _send-notifications * _setup * _test