Bitbucket のスマート ミラーリングのトラブルシューティング

スマート ミラーリングは廃止予定

2021 年 4 月 21 日以降、Bitbucket Cloud のスマート ミラーリングは新規インストールで利用できなくなります。既存のインストールはこれまでどおり機能しますが、この機能はサポートされなくなります。

このページでは、Bitbucket Cloud のスマート ミラーリングで発生する可能性のある問題を特定して解決する方法について説明します。詳細については、「Bitbucket Data Center FAQ」を参照してください。

一般的な接続エラー

以下の表は、Bitbucket Cloud とスマート ミラーの通信に影響する可能性がある基本的な問題の一覧です。

考えられる原因

可能な処置

ミラー サーバーが稼動していない。

  • ミラーをホストするサーバーが稼動中であることを確認します。

ミラー サーバーがネットワークに接続されていない。

  • ファイアウォールの外側から ping を送信して、サーバーにアクセスできることを確認します。

ホスト アドレスとポートの特定の組み合わせを使用する接続が、ファイアウォールまたはその他のネットワーク デバイスによってブロックされている。

Bitbucket からの送信コールは、ミラーの受信コールとなります。同様に、ミラーからの送信コールは Bitbucket の受信コールとなります。両方が機能する必要があります。両方が機能する必要があります。

  • 受信: telnetを使用して、ミラーが特定のポートで受信接続を許可していることをテストします。

  • 受信: ネットワーク設定を確認し、Bitbucket がミラーと通信できることを確認します。Bitbucket が使用する IP アドレスについては、「Bitbucket Cloud IP アドレス」をご確認ください。

  • 送信: ミラーサーバーに SSH 接続し、Bitbucket.org に接続できることを確認します。

  • 送信: Bitbucket.org は IPv6 アドレスをアドバタイズしています。IPv6 を使用している場合は、正しく構成されていることを確認します。

接続に使用されているプロトコルが誤っている (例: HTTPS ではなく HTTP を使用している)。

  • ミラー アプリの bitbucket.properties 設定ファイルで、Server connector ディレクティブの構成を確認します。
    このファイルは $BITBUCKET_HOME/shared/ 内にあります。ここで、$BITBUCKET_HOME 環境変数には、Bitbucket Data Center ホーム ディレクトリへのパスが含まれます。

    次の行が追加されている必要があります。

1 2 3 4 5 server.port=7990 server.proxy-name=<mycompany.com> server.secure=true server.scheme=https server.proxy-port=443

詳細は、「Bitbucket Data Center の設定プロパティ」を参照してください。

ミラー アプリケーションが実行しているが、Bitbucket Cloud が接続しようとしているポートでリッスンしていない。

一般的な SSL エラー

SSL 証明書は、次の最小要件を満たす必要があります。

  • 証明書のコモン ネーム (CN) は、アプリケーションのホスト名 (URL アドレス) と一致している必要があります。

  • 証明書のタイムスタンプは引き続き有効である必要があります。

  • 適切な Java トラスト ストアに証明書をインストールする必要があります (Bitbucket Data Center は、Tomcat アプリ サーバーをバンドルする Java アプリです)。Java トラスト ストア内に証明書が存在することを確認するには、「SSL 証明書の場所をチェックする」を参照してください。

証明書の詳細を確認するには、ブラウザでアプリケーションにアクセスし、ブラウザのアドレスバーにある南京錠のアイコンをクリックします。また、SSL 証明書の詳細をオンラインで確認することもできます (例: https://www.digicert.com/help/ を使用)。

ブラウザの一般的な問題

状況によっては、次のように、ミラー管理 UI を使用すると問題が発生することがあります。

  • プロジェクトを追加または削除すると、ミラーが一部のプロジェクトを追加できず、ページを更新してプロジェクトを再度追加するように求めるエラー メッセージが表示されます。
     

  • ミラー サポート ツールを使用しようとすると、ログインしていないこと、このツールの使用を継続するためにはログインが必要なことを通知するエラー メッセージが表示されます。
     

これらの問題はいずれも、お使いのブラウザがサードパーティの cookie を許可していない場合に発生する可能性があります。回避策として、サードパーティ cookie を有効化します。詳細は BSERV-8558 をご覧ください。

有効な HTTPS 構成がない

ミラー ベース URL が誤って設定されている

  • プロパティ Mirror base URL は一度だけ設定できます。これは、Bitbucket Data Center を初めて起動したときに実行するウィザードによって設定されます。構成に誤りがある場合や、変更が必要な場合は、ミラーを削除して再度設定する必要があります。

不明な公開キー

Bitbucket ミラーからクローンやプルを行うと、ターミナルで次のようなエラー メッセージが表示されることがあります。

1 2 3 Cloning into 'local-repo'... Permission denied (publickey). fatal: Could not read from remote repository.

考えられる原因

実行可能な対応策

公開キーがない

サポートされていない SSH キー タイプ

  • ミラーの認証に使用する SSH キーのタイプをチェックします。Bitbucket Cloud ミラーリングは RSA、DSA および ECDSA SSH キー タイプをサポートします。ED25519 キーは Bitbucket Data Center (ミラー) ではサポートされません。公開キーを確認し、冒頭の文字が ssh-ed25519 ではないことを確認します。公開キーの見つけ方については、「SSH の問題のトラブルシューティング」を参照してください。

  • 回避策として、サポートされるタイプの別のキーを構成し、それをミラーに使用します。「SSH キーのセットアップ」を参照してください。

 

その他のヘルプ