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 を使用している)。

  • Check the configuration of the Server connector directive in the bitbucket.properties configuration file for the mirror application
    This file is in $BITBUCKET_HOME/shared/, where the $BITBUCKET_HOME environment variable contains the path to the Bitbucket Server home directory.

    The following lines should be added:

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

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

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

一般的な SSL エラー

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

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

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

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

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

ブラウザの一般的な問題

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

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

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

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

有効な HTTPS 構成がない

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

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

不明な公開キー

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

1 2 3 Cloning into 'local-repo'... Permission denied (publickey). fatal: Could not read from remote repository.
考えられる原因
実行可能な対応策

公開キーがない

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

  • Check the type of SSH key you use to authenticate with the mirror. Bitbucket Cloud mirroring supports the RSA, DSA and ECDSA SSH key types. ED25519 keys are not supported by Bitbucket Server (the mirror). Look inside your public key and check that it doesn't start with ssh-ed25519. For details on how to find your public key see Troubleshoot SSH issues.

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

 

その他のヘルプ