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

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

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

This page describes how to identify and solve problems you may have with Bitbucket Cloud Smart Mirroring: For further reference, read the Bitbucket Data Center FAQ.

一般的な接続エラー

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

考えられる原因

可能な処置

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

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

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

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

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

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

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

  • Incoming: Check your network setup to ensure that Bitbucket can communicate with the mirror. The IP addresses that Bitbucket will use are listed on Bitbucket Cloud IP addresses.

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

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

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

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

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

server.port=7990 server.proxy-name=<mycompany.com> server.secure=true server.scheme=https server.proxy-port=443

See Bitbucket Data Center config properties for more information.

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

一般的な SSL エラー

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

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

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

  • The certificate must be installed into the correct Java trust store (Bitbucket Data Center is a Java application that bundles the Tomcat application server). To check that certificates are present in the Java trust store see Check the SSL certificate location.

  • 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.

To see details of a certificate, visit the application in your browser and click the padlock in the browser address bar. You can also check SSL certificate details online (for example using 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 for details.

有効な HTTPS 構成がない

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

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

不明な公開キー

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

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 Data Center (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.

  • A workaround is to configure another key, of a supported type, and use that for the mirror. See Set up an SSH key.

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容一般的な接続エラー一般的な SSL エラーブラウザの一般的な問題有効な HTTPS 構成がないミラー ベース URL が誤って設定されている不明な公開キー
コミュニティ質問、ディスカッション、記事