構成YAMLの概要

Bitrise CIの設定はYAMLファイル内で定義および保存されます。Workflow EditorのGUIで設定を変更すると、YAMLファイルが変更されます。これらのファイルでは、以下を定義します。

• ビルドが使用するBitrise CLIのフォーマットバージョン。このフォーマットバージョン番号によって、その設定を実行できるBitrise CLIのバージョンが決まります。
• プロジェクトの種類(例: AndroidやiOS)。
• デフォルトで使用されるStepsのソース。
• ビルド、および特定のWorkflowsまたはPipelinesのstackとmachine type。
• Gitイベントに基づくビルドトリガー。
• ビルドからアクセスできる、appおよびWorkflowレベルのEnvironment Variables。
• ビルドで使用されるWorkflowsおよびSteps。

デフォルトの設定YAMLファイルはbitrise.ymlと呼ばれます。各Bitriseprojectにはbitrise.ymlファイルがあります。bitrise.ymlファイルの詳細なリファレンス情報については、設定YAMLリファレンスを参照してください。

設定をローカルで編集する

オフラインWorkflow Editorは、お使いのコンピューター上で動作します。bitrise.ioにログインしなくてもプロジェクトの設定YAMLファイルを編集でき、設定がネットワークの外に出ることはありません。Workflow Editorの機能のほとんどを利用できます。

設定YAMLファイルは、以下の場所に保存できます。

• Bitrise website。これがデフォルトの設定です。
• 独自のGitリポジトリ。

独自のGitリポジトリに設定を保存している場合、Workflow Editorはブラウザから直接変更をプッシュできます。ブランチを選択して読み込み、変更を加えて、Bitriseを離れることなくコミットして戻せます。この機能はGitHubおよびGitLabでホストされているリポジトリで利用できます。Bitbucket Cloudではサポートされていません。

独自のGitリポジトリにYAML設定を保存している場合は、モジュール化されたYAML設定を使用することもできます。これは、デフォルトのbitrise.yml設定ファイルに加えて、追加設定を含むYAMLファイルを1つ以上使用することを意味します。これにより、大規模な設定をより小さくモジュール化されたコンポーネントに分割できるだけでなく、複数の異なるリポジトリやBitriseproject間で設定セグメントを効率的に再利用できます。詳しくは、モジュール化されたYAML設定を参照してください。

Enterpriseのみ

モジュール化されたYAML設定は、Enterpriseプランを利用しているWorkspacesでのみ使用できます。現時点では、YAML設定をbitrise.ioに保存している場合は利用できません。