machine poolsの監視

GitHub Actions のジョブがBuild Hub のmachine poolsのいずれかを対象にすると、Bitriseがそれを実行するマシンをプロビジョニングします。このページでは、マシンが稼働している間に確認・操作できる内容、つまりステータスの確認、ログの表示、リモート接続、そして目的のプールやマシンを見つける方法について説明します。

左側のナビゲーションバーでBuild Hubを選択し、マシンプールをクリックして開きます。各プールにはマシンの一覧が表示され、任意のマシン行を展開すると詳細を確認できます。

マシンとプールのステータス

プールカードには、プール全体のステータスが表示されます。

ステータス	説明
Up-to-date	プール内のすべてのマシンが、プールの現在の設定で実行されています。
Updating...	プールが最近再設定され、一部のマシンがまだ置き換え中です。
Unspecified	プールのステータスを現在判定できません。

プールのテーブル内の各マシンには、それぞれのステータスがあります。

ステータス	説明
Pending...	マシンがスケジュールまたは起動を待っています。
Running	マシンが実行中で、プールの設定と一致しています。
Out-of-date	マシンはまだ実行中ですが、起動後にプールの設定が変更されています。次回のプールのローリングアップデート時に置き換えられます。
Finished	マシンが正常に終了しました。
Failed	マシンが失敗して終了しました。
Unspecified	マシンのステータスを現在判定できません。通常は応答がないことが原因です。

WarmupステージとMainステージ

すべてのマシンは、2つのステージを経て進行します。

• Warmup: マシンが依存関係をインストールし、環境を準備します。
• Main: マシンのウォームアップが完了し、作業を実行します。このステージで、GitHub Actions ランナーがワークフローのジョブを実際に実行します。

マシンテーブルのStage列には、マシンが現在どのステージにあるかが表示されます。マシン行を展開すると、Warmup stageタブとMain stageタブが表示され、それぞれに個別のステータスがあります。

ステージのステータス	説明
Pending	ステージがスケジュールまたは開始を待っています。
Running	ステージが進行中です。
Complete	ステージが正常に完了しました。
Failed	ステージが失敗して終了しました。
Skipped	ステージがスキップされました。通常は、前のステージ中にマシンが終了したことが原因です。

各ステージタブには、開始日時、終了日時、所要時間も表示されます。

ログの表示

マシン行を展開し、Warmup stageまたはMain stageタブを開くと、そのステージのLogsセクションが表示されます。ログはステージが開始された後にのみ利用できるため、このセクションはステージがRunning、Complete、またはFailedの状態にある場合にのみ表示されます。ステージがまだPendingの場合やSkippedだった場合には、表示する内容がありません。

ログ出力の上にあるstdout/stderrの切り替えを使用して、2つのログストリームを切り替えます。

• stdout: ステージのプロセスが実行中に出力される、通常の進行状況やステータスメッセージです。
• stderr: 標準エラーストリームです。トラブルシューティングに使用します。エラーメッセージとデバッグログが含まれているため、ステージの問題をデバッグしやすくなります。

ステージの実行中は、ログがリアルタイムでストリーミングされます。

リソース使用状況の確認

workspaceでリソース使用状況のモニタリングが有効になっている場合、マシンの展開された行にはMonitoringタブも表示され、CPU、メモリ、ロードアベレージ、スワップ、ネットワークインターフェース、マウントパス、ディスク使用量のチャートが確認できます。チャートの上にあるtime rangeセレクターを使用して、拡大・縮小できます。

リモートアクセスでマシンに接続する

Build Hubでは、実行中のマシンに直接接続する2つの方法がサポートされています。SSHと、対応しているイメージ向けのVNC経由の画面共有です。どちらも、ワークフローを実行している間にマシンへ直接アクセスしてトラブルシューティングできます。

マシンがMain stageにあり、終了も失敗もしていない間は、直接接続できます。

1. マシンの行を展開し、Main stageタブを開きます。

2. Remote accessのトグルをオンにします。

   接続をリクエストしてから4時間後に、自動的に停止します。

3. 接続が開いたら、必要な認証情報をコピーします。

   • SSH: すぐに使用できるCommandとPasswordです。
   • Screenshare (VNC): Address、Username、Passwordです。VNCは対応しているイメージでのみ利用できます。

マシンテーブルのRemote access列にはOnまたはOffバッジが表示されるため、現在接続が開いているマシンを一目で確認できます。

machine poolsのフィルタリングと検索

Machine pools一覧ページで+ Add filterをクリックすると、Labelでプールをフィルタリングできます。プール名、イメージ、マシンタイプのラベル(または追加したカスタムラベル)から1つ以上を選択して、一覧を絞り込みます。フィルターの隣にある検索ボックスを使用すると、名前でプールを検索できます。

プールのマシンテーブル内で、Machine ID、Stage、またはStatusの列見出しをクリックすると、その列でマシンを並べ替えられます。