- Bitriseドキュメントへようこそ!
- ビルドとパイプライン
- 構成YAML
- アプリのbitrise.ymlファイルの保存
アプリのbitrise.ymlファイルの保存
ビルドの中心はbitrise.ymlファイルです。使用するステップ、プロジェクトタイプ、トリガーマップを構成し、アプリレベルおよびワークフローレベルの環境変数を指定できます。
YAMLファイルのサイズ制限
の合計サイズに注意してください bitrise.yml
そしてその bitrise.secrets.yml
ファイルは400KBを超えることはできません。
保存方法は2つあります bitrise.yml
プロジェクトのファイル:
-
ファイルをGitリポジトリに保持します。このソリューションを使用すると、
bitrise.yml
ファイル。 -
続けて bitrise.io:Bitriseは構成を保存し、Webサイトからいつでもアクセスできます。このソリューションでは、構成ファイルはリポジトリから完全に独立しています。
2つのソリューションはいつでも切り替えることができます。
bitrise.ymlリファレンス
あなたはについての詳細な参照情報を見つけることができます bitrise.yml
関連ガイドのファイル: 構成YAMLの基本。
bitrise.ymlファイルをリポジトリに保存する
あなたが保存するとき bitrise.yml
リポジトリ内の構成ファイルの場合、Bitriseのビルドプロセスはそのファイルを使用してビルドを実行します。この意味は:
-
構成ファイルのバージョン管理を完全に制御できます。
-
ワークフローまたはトリガーマップに変更を加えるたびに、リポジトリ内のファイルに変更をコミットする必要があります。
自分で作成する必要はありません bitrise.yml
事前にファイル:に保存されているファイルを使用できます bitrise.io。を保存する方法を見てみましょう bitrise.yml
まだ含まれていないリポジトリ内のファイル。
この機能には サービス認証情報 統合。サービス資格情報ユーザーがサポートされていない場合、この機能は動作しません。
同じリポジトリを持つ複数のアプリ
保存できるのは1つだけです bitrise.yml
特定のリポジトリ内のファイル。Bitrise はルート ディレクトリでファイルを検索するため、現時点では 2 つのファイルを別々のフォルダーに含める方法はありません。同じリポジトリに複数の Bitrise アプリのコードがある場合は、アプリごとに異なるワークフローを使用することをお勧めします。
-
Bitriseでアプリを開き、 アプリ設定 ページ。
-
選択する コラボレーション。
-
確認してください サービスクレデンシャルユーザー セクション。サービスクレデンシャルユーザーは、少なくとも
read
リポジトリへのアクセス。 -
ワークフロー エディターを開きます。
-
ワークフローエディタで、 ビットライズ 左側のナビゲーション メニューから選択します。
-
YAMLファイルの上に、ファイルが現在保存されている場所が表示されます。 変化。
-
追加するように求められたら
bitrise.yml
アプリのリポジトリには、次の2つのオプションがあります。-
現在のコンテンツをコピーします
bitrise.yml
クリップボードにファイルします。次に、独自のファイルを作成して、その内容をコピーできます。 -
現在のダウンロード
bitrise.yml
ファイル。
-
-
リポジトリで、コミットします
bitrise.yml
デフォルトのブランチのルートにファイルします。アプリのデフォルトブランチには常に
bitrise.yml
その上にファイルします。あなたは別のものを保存することができますbitrise.yml
他のブランチのファイル: リポジトリ内の複数のブランチにbitrise.ymlファイルを保存する。Bitriseアプリのデフォルトブランチはで確認できます bitrise.io に行くことによって 設定 タブと検索 デフォルトのブランチ オプション。
-
Bitriseで、をクリックします 設定を更新。
ファイルが有効であることを確認してください
NS
bitrise.yml
リポジトリ内のファイルは常に有効である必要があります。誤った構文が含まれていると、ビルドが破損する可能性があります。
すべてがうまくいけば、あなたはあなたのを正常に変更したという確認を受け取るはずです bitrise.yml
ストレージ設定。
Bitrise Web サイトの IP アドレスを許可リストに登録する
コードを保存するために何らかの形式の自己ホスト型ソリューションを使用する場合、Bitrise Web サイトとそのバックグラウンド ワーカーの静的 IP アドレスを許可リストに登録する必要がある場合があります。これにより、保存などの機能を使用できます。 bitrise.yml
ファイルを自分のリポジトリに置くか、Bitrise からビルド ステータスの更新を受け取ります。 Bitrise バックエンドワーカーの IP アドレス範囲.
プライベートにホストされたリポジトリ
残念ながら、この機能は、サービス認証情報ユーザー統合または GitHub アプリの統合たとえば、リポジトリがプライベート IP サブネットの下でのみアクセス可能である場合などです。ただし、回避策があります。 bitrise.ymlをプライベートにホストされたリポジトリに保存するこの回避策は、たとえば Bitbucket Server ユーザーに対して有効です。
GitHub Enterpriseでは、 bitrise.yml
GitHub Enterprise リポジトリ内のファイル: セルフホスト型 GitHub Enterprise Server と Bitrise
の統合。
リポジトリに保存されているbitrise.ymlを更新しています
あなたが保存するとき bitrise.yml
リポジトリ内のファイルでも、オンラインワークフローエディタを使用してビルド構成を変更できます。ワークフローエディタに保存した後、変更をコミットする必要があります。
Read-only mode
You can't directly edit the bitrise.yml
file itself in the Workflow Editor. You need to use the GUI to make changes, or edit the file in your repository instead.
-
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
更新するワークフローに変更を加えます。
-
クリック 変更を保存 右上隅にあります。
-
を更新するように求められます
bitrise.yml
リポジトリ内のファイル。 2つのオプションがあります。-
現在のコンテンツをコピーします
bitrise.yml
クリップボードにファイルします。次に、独自のファイルを作成して、その内容をコピーできます。 -
現在のダウンロード
bitrise.yml
ファイル。
-
-
リポジトリで、コミットします
bitrise.yml
ファイル。 -
Bitriseで、をクリックします 私はこれで終わりです をフェッチするには
bitrise.yml
リポジトリから。まず変更をコミットしてください。
リポジトリへの変更をコミットしていない場合、これにより変更が上書きされます。
リポジトリ内の複数のブランチにbitrise.ymlファイルを保存する
最初に追加するとき bitrise.yml
リポジトリに、デフォルトのブランチにコミットする必要があります。あなたはでアプリのデフォルトのブランチをチェックアウトすることができます bitrise.io 下 設定 タブ。
ただし、初期構成を行って、 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.ioに保存。
-
どちらかを選択してください
bitrise.yml
ファイルはで使用する必要があります bitrise.io 今から。-
あなたはの内容をコピーすることができます
bitrise.yml
アプリのリポジトリに保存されているファイル。 -
あなたはの最後のバージョンをコピーすることができます
bitrise.yml
使用したファイル bitrise.io。
-
-
クリック 設定を更新。
すべてがうまくいけば、あなたはあなたのを正常に変更したという確認を受け取るはずです bitrise.yml
ストレージ設定。