メインコンテンツまでスキップ

リモートアクセス

リモートアクセスを使用すると、実行中の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の一部をインストールしたりすることもできます。

  1. Bitriseでプロジェクトを開きます。

  2. プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。

  3. Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。

  4. Rebuild with remote accessを選択します。これにより、リモートでアクセスできる新しいビルドが開始されます。

    RebuildドロップダウンメニューのRebuild with remote accessオプション

  5. ビルドのページで、VSCodeタブを選択します。

  6. 画面の指示に従って、Bitrise CLIとそのリモートアクセス拡張機能、および接続コマンドをインストールします。

    Bitrise CLI、リモートアクセスプラグイン、接続コマンドが表示されたVSCodeタブ

SSHでのリモートアクセスClick to copy link​

SSHを使用してBitrise build machineにアクセスするには、コマンドラインインターフェースと正しいコマンドおよびパスワードが必要です。

  1. Bitriseでプロジェクトを開きます。

  2. プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。

  3. Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。

  4. Rebuild with remote accessを選択します。これにより、リモートでアクセスできる新しいビルドが開始されます。

    RebuildドロップダウンメニューのRebuild with remote accessオプション

  5. ビルドのページで、SSHタブを選択します。

  6. Commandを見つけて、コマンドラインインターフェースで実行します。

    Commandおよび PasswordフィールドがあるSSHタブ

これで完了です。ビルドが実行されている仮想マシンにアクセスできるようになります。

screen shareでのリモートアクセスClick to copy link​

screen shareアプリでBitrise build machineにアクセスするには、正しいユーザー名、パスワード、URLに加えて、VNC screen shareアプリが必要です。

macOSのみ

screen shareを使用したリモートアクセスは、macOSベースのスタックで実行されるWorkflowsでのみ利用できます。Workflowのスタック(Workflow固有のスタックがない場合はアプリのデフォルトスタック)がLinuxベースのものである場合、screen shareの手順はまったく表示されません。

  1. Bitriseでプロジェクトを開きます。

  2. プロジェクトのメインページで、リモートアクセスを使用して再実行したいビルドを見つけてクリックします。

  3. Rebuildボタンの下向き矢印をクリックして、ドロップダウンメニューを開きます。

  4. Rebuild with remote accessを選択します。これにより、リモートでアクセスできる新しいビルドが開始されます。

    RebuildドロップダウンメニューのRebuild with remote accessオプション

  5. ビルドのページで、Screen shareタブを選択します。

  6. 必要な情報を確認します。

    • URL
    • ユーザー名
    • パスワード

    URL、ユーザー名、パスワードのフィールドがあるScreen shareタブ

  7. VNC screen shareアプリケーションを開きます。

    最も簡単な方法は、macOSのデフォルトのScreen Sharingアプリケーションを使用することです。

  8. Screen shareオプションの情報を使用して、必要なフィールドに入力します。

これで完了です。これで、ビルドが実行されている仮想マシンにアクセスできるようになります。

VMでファイルを確認するClick to copy link​

ビルドを実行したBitrise仮想マシンへのログインに成功したら、ファイル自体を確認してリアルタイムで何が起こっているかを把握できます。BitriseがアプリをVMにクローンし終えると、常に次の場所からアクセスできます。

/Users/vagrant/git

リモートアクセスの利用可能時間を延長するClick to copy link​

リモートアクセスは、ビルドの実行中およびビルド終了後10分間利用できます。これでは不十分な場合、リモートアクセスをより長く利用できるようにするための簡単な回避策があります。

  1. ビルドを失敗させるStepの後に、ScriptStepを追加します。

  2. Run even if previous Step(s) failedオプションをオンにして、ScriptStepが必ず実行されるようにします。

  3. 指定した秒数だけビルドを「スリープ」させるコマンドを追加します。

    sleep 5400

    この例では、ビルドを90分間実行させます。もちろん、ビルドの時間制限を超えないようにしてください。

これで完了です。ビルドがまだ実行されている間に、失敗の原因となった可能性のある問題について仮想マシン上で調査できます。