クラウド コントローラーのトラブルシューティング
クラウド コントローラーを使用して AWS で Bitrise ビルドを実行しようとする際に発生する可能性のある問題をいくつかリストしました。問題が発生している場合は、このページで問題を確認してください。
Bitrise on AWS の画面が表示されない
上の正しい場所を見ているか確認してください。 ワークスペースの設定 ページ。
ページが存在しない場合は、Bitrise までお問い合わせください。追加のアクセス権が必要になる場合があります。
Bitrise on AWS 画面が表示されますが、新しいコントローラーを作成できません
新しいコントローラーを作成できるのはワークスペース所有者だけです。正しいアクセス権があることを確認してください。
AWS でインスタンスをセットアップするときに CloudFormation がスタックの作成に失敗する
サポートチケットを開いてください!
コントローラーインスタンスはBitriseに接続できません
-
構成が正しいことを確認します。
-
CloudWatch ログでエラーがないか確認してください。コントローラーが動作し始めても何も実行できない場合は、そこに関連ログが見つかります。
-
[AWS Secret Manager と Secrets] で、ワークスペース ID とコントローラー トークンの両方が正しく提供されていることを検証します。
上記のいずれかが正しく構成されていない場合は、CloudFormation スタックを破棄し、正しい設定で再作成します。
-
-
インスタンスが起動したが Bitrise に接続できない場合:
-
インスタンスのシステム ログを確認します。
を見た場合は、
Error response from daemon: Get "https://public.ecr.aws/v2/": context deadline exceeded
というメッセージが表示された場合、インスタンスにインターネット アクセスがない可能性があります。ルート テーブルの構成を再確認し、構成されたサブネットがインターネットにアクセスできることを確認してください。 -
Bitrise URL への出力通信が機能していることを確認します。次の方法で検証できます。
作成したインスタンスに SSH で接続します。ターミナルで使用します
telnet
、curl
、 またはwget
アクセスするためにcloud-controller-aws-internal.services.bitrise.io:443
。リクエストがタイムアウトになった場合は、証拠を収集してサポートに通知してください。
404 を取得した場合、出力通信は良好です。
-
-
上記のいずれも解決しない場合は、Bitrise にお問い合わせください。
コントローラーインスタンスがランダムに再作成されます
これは通常のワークフローの一部である可能性があります。組み込み機能により、登録されたコントローラーが最新バージョンに維持され、コントローラーが絶えず進化する Bitrise と互換性があることが保証されます。
コントローラにはヘルス チェック機能も組み込まれており、インスタンスが常に正常に動作していることを保証します。その一環として、断続的な問題を解決するために、インスタンスが時々再起動することがあります。これにより、コントローラが正常に動作しなくなることはありません。
コントローラーが依然として頻繁に再起動する場合、またはユーザーがコントローラーの動作に問題があると疑う場合は、Bitrise にご連絡ください。
AWSでコントローラーを作成する前にコントローラーのシークレットを忘れてしまった
AWS Secrets からトークンを読み取ることができます。
Bitriseからコントローラーを削除できません
をクリックするとコントローラーを削除できます。 ワークスペースの設定 ページ。ワークスペースの所有者のみがコントローラーを削除できます。
コントローラーの横にあるボタンAWS からコントローラーを削除する
Bitrise からコントローラーを削除しても、AWS からコントローラーは削除されません。それは別途行う必要があります。接続されているコントローラーを Bitrise から削除すると、AWS で実行されているコントローラーは動作できなくなります。
新しいマシン プールを作成できません
ワークスペース所有者のみがマシン プールを作成できます。正しいアクセス権があることを確認してください。
プールを作成しましたが、何も起こりません
コントローラーが次の場所にあることを確認してください 接続済み 州:
コントローラーが接続状態にある場合は、CloudWatch ログでエラーがないか確認してください。 CloudWatch ログには、誤った設定に関する情報が保持されている可能性があります。例えば:
-
画像の利用可能性とアクセス。
-
ディスクサイズの要件。
-
セキュリティグループとサブネット構成の問題。
プールを構成し、マシンが表示されましたが、そのステータスは 3 分以上「開始中」のままです
AWS で新しい MacOS インスタンスが起動すると、基盤となるインフラストラクチャが起動するまでに 5 ~ 10 分かかる場合があります。
インスタンスの詳細を開いて、 で作成されました 下のフィールド 機械の詳細:
数分後にホストの詳細が入力されているのに、インスタンスの詳細が空である場合は、おそらくプール構成が正しくなかったことを意味します。それは AWS CloudWatch ログで確認できます。考えられる問題には、存在しない SSH キー、正しくないサブネットまたはセキュリティ グループ、構成された使用できない AMI ID などがあります。調査結果に基づいて、マシン プールの構成を更新します。
マシンの詳細が入力されている場合、インスタンスは AWS インフラストラクチャ上で開始されています。マシンが 8 ~ 9 分以上前に作成されたのに、マシンのステータスがまだである場合は、 起動、調査を開始します。
-
すべての構成と AWS リソースが正しく提供されていることを確認してください。
-
作成されたインスタンスが Bitrise に接続できることを確認します。指定された SSH キーを使用してインスタンスにログインし、ping を実行します。
exec.bitrise.io
。
プールを作成し、マシンは実行状態ですが、ビルドを開始できません
ビルドが正しいプールをターゲットにしていることを確認してください。ワークフロー エディターでは、すべてのプールが選択可能です。正しいことを確認してください agent-pool-***
がビルドに選択されています。
Bitrise が管理するインスタンスの 1 つにセキュリティ グループを手動で追加しましたが、数秒後にインスタンスのステータスがシャットダウンになります。
コントローラーは、Bitrise ページで構成されたマシンの状態を実現する責任があります。必要な構成から逸脱しているインスタンスがある場合、コントローラーはそれを識別し、誤って構成されたリソースを再起動します。
このような構成を変更する場合は、プールを再構成してください。
インスタンスの数を減らしたり増やしたりするようにプールを再構成したいのですが、[編集] ボタンが表示されません。
ワークスペース所有者のみがプール構成を編集できます。正しいアクセス権があることを確認してください。
マシンの数を減らすようにリクエストしましたが、AWS では依然として Bitrise 管理の専用ホストが保留中/利用可能ステータスで表示されます。
専用ホストが予約されると、24 時間まで解放できません。コントローラーは最も古い専用ホストを解放しようとしますが、24 時間の時間が経過しないと専用ホストを解放できません。
コントローラーは、不要なリソースを確実に解放します。
5分前にマシンの数を減らすようリクエストしましたが、実行中のマシンの数は以前と同じままです
コントローラーがまだ入っていることを確認してください。 接続済み 州。
コントローラーが接続されている場合、マシン上でビルドがまだ実行中の場合、システムはマシンの終了を妨げる可能性があります。すべてのマシンがビルドを実行している場合、システムは終了する最も古い専用ホストのマシンをマークします。実行中のビルドが終了するとすぐにマシンの終了も開始されます。
上記のロジックは、最初に完了すると予想されるビルドをターゲットにしていません。代わりに、余分なコストを節約するために最も早くリリースされる可能性のある専用ホストをターゲットにします。
作成したマシンプールを削除できません
ワークスペース所有者のみがマシン プールを削除できます。ワークスペース所有者は、必要なレプリカ数などの設定が間違っている場合に、プールを再構成することもできます。
Bitrise Agent ログにアクセスする必要があります
Bitrise Agent ログを取得するには、Cloudwatch Bitrise Agent ログを設定します。これはオプションの機能ですが、トラブルシューティング機能を向上させるために使用することを強くお勧めします。