リモートアクセス
リモートアクセスを使用すると、実行中のbuild machineに接続してデバッグを容易に行えます。失敗したビルドはリモートアクセスを有効にして再ビルドすることで、トラブルシューティングが格段に簡単になります。たとえば、ビルドログにエラーに関する十分な情報が含まれていない場合などに役立ちます。
スタンドアロンビルドとパイプラ インビルドの両方をリモートアクセスで再ビルドできます。
アプリでTesters/QAロールを持つユーザーは、リモートアクセスを使用できません。
リモートアクセスを使用する方法は3つあります。
- Visual Studio Code: BitriseビルドをリモートリポジトリとしてローカルのVSCodeアプリに接続します。
- SSH: ターミナルからの従来のリモートシェル接続です。
- Screen share: 任意のVNCクライアントを使用したリモート画面共有です。macOSビルドでのみ動作します。
どちらの方法でも、ビルド中およびビルド終了後10分間はbuild machineにリモートでアクセスできます。リモートアクセスの利用可能時間を延長したい場合は、失敗したStepの後に簡単なカスタムスクリプトStepを追加することで対応できます。詳細については、リモートアクセスの利用可能時間を延長するを参 照してください。
リモートアクセスを使用すると、合計ビルド時間に10分が追加されます。
Visual Studio CodeでのリモートアクセスClick to copy link
このリモートアクセスの仕組みでは、ローカルのVisual Studio CodeアプリをBitrise build machineにリモートリポジトリとして接続できます。
ファイルをリアルタイムで閲覧・編集したり、組み込みのターミナルでコマンドを実行したり、VSCode extensionsの一部をインストールしたりすることもできます。
-
Bitriseでプロジェクトを開きます。
-
プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。
-
Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。
-
Rebuild with remote accessを選択します。これにより、リモートでアクセスでき る新しいビルドが開始されます。

-
ビルドのページで、VSCodeタブを選択します。
-
画面の指示に従って、Bitrise CLIとそのリモートアクセス拡張機能、および接続コマンドをインストールします。

SSHでのリモートアクセスClick to copy link
SSHを使用してBitrise build machineにアクセスするには、コマンドラインインターフェースと正しいコマンドおよびパスワードが必要です。
-
Bitriseでプロジェクトを開きます。
-
プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。
-
Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。
-
Rebuild with remote accessを選択します。これにより、リモートでアクセスできる新しいビルドが開始されます。

-
ビルドのページで、SSHタブを選択します。
-
Commandを見つけて、コマンドラインインターフェースで実行します。

これで完了です。ビルドが実行されている仮想マシンにアクセスできるようになります。
screen shareでのリモートアクセスClick to copy link
screen shareアプリでBitrise build machineにアクセスするには、正しいユーザー名、パスワード、URLに加えて、VNC screen shareアプリが必要です。
-
Bitriseでプロジェクトを開きます。
-
プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。
-
Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。
-
Rebuild with remote accessを選択します。これにより、リモートでアクセスできる新しいビルドが開始されます。

-
ビルドのページで、Screen shareタブを選択します。
-
必要な情報を確認します。
- URL
- ユーザー名
- パスワード

-
VNC screen shareアプリケーションを開きます。
最も簡単な方法は、macOSのデフォルトのScreen Sharingアプリケーションを使用することです。
-
Screen shareオプションの情報を使用して、必要なフィールドに入力します。
これで完了です。これで、ビルドが実行されている仮想マシンにアクセスできるようになります。
VMでファイルを確認するClick to copy link
ビルドを実行したBitrise仮想マシンへのログインに成功したら、ファイル自体を確認してリアルタイムで何が起こっているかを把握できます。BitriseがアプリをVMにクローンし終えると、常に次の場所からアクセスできます。
/Users/vagrant/git
リモートアクセスの利用可能時間を延長するClick to copy link
リモートアクセスは、ビルドの実行中およびビルド終了後10分間利用できます。これでは不十分な場合、リモートアクセスをより長く利用できるようにするための簡単な回避策があります。
- Workflow Editor
- Configuration YAML
-
ビルドを失敗させるStepの後に、ScriptStepを追加します。
-
Run even if previous Step(s) failedオプションをオンにして、ScriptStepが必ず実行されるようにします。
-
指定した秒数だけビルドを「スリープ」させるコマンドを追加します。
sleep 5400この例では、ビルドを90分間実行させます。もちろん、ビルドの時間制限を超えないようにしてください。
ビルドを失敗させるStepの後にscriptStepを追加します。Stepが必ず実行されるようにis_always_runをtrueに設定し、指定した秒数だけビルドを「スリープ」させるコマンドを追加します。
workflows:
primary:
steps:
- script:
is_always_run: true
inputs:
- content: sleep 5400
この例では、ビルドを90分間実行させます。もちろん、ビルドの時間制限を超えないようにしてください。
これで完了です。ビルドがまだ実行されている間に、失敗の原因となった可能性のある問題について仮想マシン上で調査できます。