- Bitriseドキュメントへようこそ!
- ビルドとパイプライン
- ビルド設定の構成
- アプリのbitrise.ymlファイルの管理
アプリのbitrise.ymlファイルの管理
ビルドの中心はbitrise.ymlファイルです。使用するステップ、プロジェクトタイプ、トリガーマップを構成し、アプリレベルおよびワークフローレベルの環境変数を指定できます。
NS bitrise.yml
ファイルはBitriseセットアップの中心であり、アプリのビルド構成全体を保存します。スタック、トリガーマップ、および含まれるワークフローとステップを指定します。ワークフローエディターのグラフィカルUIでワークフローを編集する場合、実際には bitrise.yml
ファイル。
YAMLファイルのサイズ制限
の合計サイズに注意してください bitrise.yml
そしてその bitrise.secrets.yml
ファイルは400KBを超えることはできません。
管理する方法は2つあります bitrise.yml
アプリのファイル:
-
ファイルをGitリポジトリに保持します。このソリューションを使用すると、
bitrise.yml
ファイル。 -
続けて bitrise.io:Bitriseは構成を保存し、Webサイトからいつでもアクセスできます。このソリューションでは、構成ファイルはリポジトリから完全に独立しています。
2つのソリューションはいつでも切り替えることができます。
bitrise.ymlリファレンス
あなたはについての詳細な参照情報を見つけることができます bitrise.yml
関連ガイドのファイル: bitrise.ymlの基本。
bitrise.ymlファイルをリポジトリに保存する
GitHub Enterprise
残念ながら、この機能はGitHubEnterpriseユーザーにはまだサポートされていません。
この回避策は、たとえば、GitHubEnterpriseおよびBitbucketServerユーザーに対して機能します。
あなたが保存するとき bitrise.yml
リポジトリ内の構成ファイルの場合、Bitriseのビルドプロセスはそのファイルを使用してビルドを実行します。この意味は:
-
構成ファイルのバージョン管理を完全に制御できます。
-
ワークフローまたはトリガーマップに変更を加えるたびに、リポジトリ内のファイルに変更をコミットする必要があります。
自分で作成する必要はありません bitrise.yml
事前にファイル:に保存されているファイルを使用できます bitrise.io。を保存する方法を見てみましょう bitrise.yml
まだ含まれていないリポジトリ内のファイル。
同じリポジトリを持つ複数のアプリ
1つしか保存できません bitrise.yml
特定のリポジトリ内のファイル。 Bitriseはルートディレクトリでファイルを検索するため、現在、2つを別々のフォルダに含める方法はありません。
2つ以上のBitriseアプリが同じリポジトリに接続されている場合は、それらのすべてのワークフローを同じリポジトリに保存できます bitrise.yml
ファイル。もちろん、ワークフローごとに異なる名前を付ける必要があります。2つにすることはできません。 primary
たとえば、同じファイル内のワークフロー。
-
Bitriseでアプリを開き、に移動します チーム タブ。
-
確認してください サービスクレデンシャルユーザー セクション。サービスクレデンシャルユーザーは、少なくとも
read
リポジトリへのアクセス。サービスクレデンシャルの統合
アプリがサービスクレデンシャルユーザー統合がサポートされていないリポジトリを使用している場合(たとえば、リポジトリはプライベートIPサブネットでのみアクセス可能)、Webサイトが取得できないため、この機能は機能しないことに注意してください。
bitrise.yml
IPアドレスの制限による。 -
に移動します ワークフロー タブ。
-
ワークフローエディタで、に移動します bitrise.yml タブ。
-
クリック アプリリポジトリに保存する。
-
追加するように求められたら
bitrise.yml
アプリのリポジトリには、次の2つのオプションがあります。-
現在のコンテンツをコピーします
bitrise.yml
クリップボードにファイルします。次に、独自のファイルを作成して、その内容をコピーできます。 -
現在のダウンロード
bitrise.yml
ファイル。
-
-
リポジトリで、コミットします
bitrise.yml
デフォルトのブランチのルートにファイルします。リポジトリのブランチ
アプリのデフォルトブランチには常に
bitrise.yml
その上にファイルします。あなたは別のものを保存することができますbitrise.yml
他のブランチのファイル: リポジトリ内の複数のブランチにbitrise.ymlファイルを保存する。Bitriseアプリのデフォルトブランチはで確認できます bitrise.io に行くことによって 設定 タブと検索 デフォルトのブランチ オプション。
-
Bitriseで、をクリックします 設定を更新。
-
確認するように求められたら
bitrise.yml
ファイルが有効です。クリックしてください 継続する。ファイルが有効であることを確認してください
NS
bitrise.yml
リポジトリ内のファイルは常に有効である必要があります。誤った構文が含まれていると、ビルドが破損する可能性があります。
すべてがうまくいけば、あなたはあなたのを正常に変更したという確認を受け取るはずです bitrise.yml
ストレージ設定。
Bitrise Web サイトの IP アドレスを許可リストに登録する
コードを保存するために何らかの形式の自己ホスト型ソリューションを使用する場合、Bitrise Web サイトとそのバックグラウンド ワーカーの静的 IP アドレスを許可リストに登録する必要がある場合があります。これにより、保存などの機能を使用できます。 bitrise.yml
ファイルを自分のリポジトリに置くか、Bitrise からビルド ステータスの更新を受け取ります。 Bitrise Web サイトの IP アドレス.
リポジトリに保存されているbitrise.ymlを更新しています
あなたが保存するとき bitrise.yml
リポジトリ内のファイルでも、オンラインワークフローエディタを使用してビルド構成を変更できます。ワークフローエディタに保存した後、変更をコミットする必要があります。
-
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
[ワークフローとパイプライン] ページでは、次のことができます。
-
クリック bitrise.yml を編集する にアクセスするためのボタン ビットライズ.yml ワークフローエディターのタブ。
-
クリック
ワークフロー名の横にある ボタンをクリックして、ワークフロー エディターでワークフローを開きます。
-
-
更新するワークフローに変更を加えます。
-
クリック 保存する 右上隅にあります。
-
を更新するように求められます
bitrise.yml
リポジトリ内のファイル。 2つのオプションがあります。-
現在のコンテンツをコピーします
bitrise.yml
クリップボードにファイルします。次に、独自のファイルを作成して、その内容をコピーできます。 -
現在のダウンロード
bitrise.yml
ファイル。
-
-
リポジトリで、コミットします
bitrise.yml
ファイル。リポジトリのブランチ
アプリのデフォルトブランチには常に
bitrise.yml
その上にファイルします。あなたは別のものを保存することができますbitrise.yml
他のブランチのファイル: リポジトリ内の複数のブランチにbitrise.ymlファイルを保存する。 -
Bitriseで、をクリックします 私はこれで終わりです をフェッチするには
bitrise.yml
リポジトリから。[完了]をクリックする前に変更をコミットします
リポジトリへの変更をコミットしていない場合、これにより変更が上書きされます。
リポジトリ内の複数のブランチにbitrise.ymlファイルを保存する
最初に追加するとき bitrise.yml
リポジトリに、デフォルトのブランチにコミットする必要があります。あなたはでアプリのデフォルトのブランチをチェックアウトすることができます bitrise.io 下 設定 タブ。
保存することを選択した場合 bitrise.yml
リポジトリ内のファイルの場合、デフォルトのブランチには bitrise.yml
!
ただし、初期構成を行って、 bitrise.yml
リポジトリから、保存できます bitrise.yml
他のブランチ上のファイルを作成し、それらのいずれかを使用してビルドを実行します。 Bitriseでリポジトリのブランチを構築する場合は、 bitrise.yml
そのブランチ上のファイル。そして、あなたは常に維持する必要があることを忘れないでください bitrise.yml
デフォルトのブランチにあるファイル。
FantasticAppというアプリがあるとしましょう。 FantasticAppのGitリポジトリでは、デフォルトのブランチが呼び出されます main
。もあります deploy
ブランチ。
コードのプッシュまたはプルリクエスト main
と呼ばれるワークフローをトリガーします main-workflow
。コードのプッシュまたはプルリクエスト deploy
と呼ばれるワークフローをトリガーします deploy-workflow
。
リポジトリには、 bitrise.yml
両方のファイル main
そしてその deploy
両方のワークフローを含むブランチ。ワークフローに変更を加えると、FantasticAppチームは変更されたものをコミットします bitrise.yml
両方のブランチにファイルして、ワークフローが両方で最新であることを確認します。
bitrise.ymlファイルをbitrise.ioに戻す
デフォルト設定では、 bitrise.yml
上のファイル bitrise.io:新しいアプリを追加すると、自動的に作成されます bitrise.yml
あなたのためのファイルとそれは私たちのウェブサイトに保存されています。これがうまくいけば、何も変更する必要はありません!
ただし、ストレージ設定を変更して構成ファイルをリポジトリに保持している場合は、いつでも簡単に元に戻してファイルを保存できます。 bitrise.io。
-
Bitriseでアプリを開きます。
-
に移動します ワークフロー タブ。
-
ワークフローエディタで、に移動します bitrise.yml タブ。
-
クリック bitrise.ioに保存。
-
どちらかを選択してください
bitrise.yml
ファイルはで使用する必要があります bitrise.io 今から。-
あなたはの内容をコピーすることができます
bitrise.yml
アプリのリポジトリに保存されているファイル。 -
あなたはの最後のバージョンをコピーすることができます
bitrise.yml
使用したファイル bitrise.io。
-
-
クリック 設定を更新。
すべてがうまくいけば、あなたはあなたのを正常に変更したという確認を受け取るはずです bitrise.yml
ストレージ設定。