Bitbucket Cloud のスマート ミラーリングのトラブルシューティング
このページでは、Bitbucket Cloud のスマートミラーリングで発生する可能性のある問題を特定して解決する方法について説明します。
詳細については、「Bitbucket Data Center FAQ」をお読みください。
一般的な接続エラー
以下の表は、Bitbucket Cloud とスマート ミラーの通信に影響する可能性がある基本的な問題の一覧です。
| 考えられる原因 | 可能な処置 |
|---|---|
ミラー サーバーが稼動していない。 |
|
ミラー サーバーがネットワークに接続されていない。 |
|
ホスト アドレスとポートの特定の組み合わせを使用する接続が、ファイアウォールまたはその他のネットワーク デバイスによってブロックされている。 | Bitbucket からの送信コールは、ミラーの受信コールとなります。同様に、ミラーからの送信コールははBitbucketの受信コールとなります。両方が機能する必要があります。
|
接続に使用されているプロトコルが誤っている (例: HTTPS ではなく HTTP を使用している)。 |
See Configuration properties for more information. |
ミラー アプリケーションが実行しているが、Bitbucket Cloud が接続しようとしているポートでリッスンしていない。 |
一般的な SSL エラー
SSL 証明書は、次の最小要件を満たす必要があります。
- 証明書のコモン ネーム (CN) は、アプリケーションのホスト名 (URL アドレス) と一致している必要があります。
- 証明書のタイムスタンプは引き続き有効である必要があります。
- 適切な Java トラスト ストアに証明書をインストールする必要があります (Bitbucket Server は、Tomcat アプリケーション サーバーをバンドルする Java アプリケーションです)。Java トラスト ストア内に証明書が存在することを確認するには、「SSL 証明書の場所をチェックする」を参照してください。
- Make sure that your key and certificate are correctly configured in either the mirror or your HTTPS proxy. See See of the options in Securing a reverse proxy using HTTPS for SSL configuration details.
証明書の詳細を確認するには、ブラウザでアプリケーションにアクセスし、ブラウザのアドレスバーにある南京錠のアイコンをクリックします。また、SSL 証明書の詳細をオンラインで確認することもできます (例: https://www.digicert.com/help/ を使用)。
ブラウザの一般的な問題
状況によっては、次のように、ミラー管理 UI を使用すると問題が発生することがあります。
- プロジェクトを追加または削除しようとしたときにミラーが失敗し、次のエラー メッセージが表示される場合があります。
- ミラー サポート ツールを使用しようとすると、次のエラー メッセージが表示されます。
Both of these problems can occur if your browser does not allow third-party cookies. The workaround is to enable third-party cookies – see BSERV-8558 - Getting issue details... STATUS for details.
有効な HTTPS 構成がない
- Your mirror must be configured for HTTPS access in order to use a mirror instance. See Proxy and secure Bitbucket for more information.
- 必要に応じて「SSH ポート転送のセットアップ」を参照してください。
ミラー ベース URL が誤って設定されている
プロパティ
Mirror base URLは一度だけ設定できます。これは、Bitbucket Server を初めて起動したときに実行するウィザードによって設定されます。構成に誤りがある場合や、変更が必要な場合は、ミラーを削除して再度設定する必要があります。
不明な公開キー
Bitbucket ミラーからクローンやプルを行うと、ターミナルで次のようなエラー メッセージが表示されることがあります。
Cloning into 'local-repo'...
Permission denied (publickey).
fatal: Could not read from remote repository.考えられる原因 | 実行可能な対応策 |
|---|---|
| 公開キーがない |
|
| サポートされていない SSH キー タイプ |
|