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 5server.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 証明書の場所をチェックする」を参照してください。

キーと証明書が、ミラーまたは HTTPS プロキシのいずれかで正しく構成されていることを確認します。SSL 構成の詳細は、「HTTPS を使用してリバースプロキシを保護する」のオプションを参照してください。

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

ブラウザの一般的な問題

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

プロジェクトを追加または削除すると、ミラーが一部のプロジェクトを追加できず、ページを更新してプロジェクトを再度追加するように求めるエラーメッセージが表示されます。
ミラーサポートツールを使用しようとすると、ログインしていないこと、このツールの使用を継続するためにはログインが必要なことを通知するエラーメッセージが表示されます。

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

有効な HTTPS 構成がない

ミラーインスタンスを使用するには、ミラーを HTTPS アクセス用に構成する必要があります。詳細については、「Bitbucket Data Center のプロキシと保護」を参照してください。
必要に応じて「SSH ポート転送のセットアップ」を参照してください。

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

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

不明な公開キー

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

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

考えられる原因	実行可能な対応策
公開キーがない	Bitbucket で SSH キーが構成済みであることを確認します。「SSH の問題のトラブルシューティング」を参照してください。必要に応じて SSH キーを作成します。詳細は、「SSH キーをセットアップする」を参照してください。
サポートされていない SSH キータイプ	ミラーの認証に使用する SSH キーのタイプをチェックします。Bitbucket Cloud ミラーリングは RSA、DSA および ECDSA SSH キータイプをサポートします。ED25519 キーは Bitbucket Data Center (ミラー) ではサポートされません。公開キーを確認し、冒頭の文字が ssh-ed25519 ではないことを確認します。公開キーの見つけ方については、「SSH の問題のトラブルシューティング」を参照してください。回避策として、サポートされるタイプの別のキーを構成し、それをミラーに使用します。「SSH キーのセットアップ」を参照してください。

考えられる原因

実行可能な対応策

公開キーがない

Bitbucket で SSH キーが構成済みであることを確認します。「SSH の問題のトラブルシューティング」を参照してください。
必要に応じて SSH キーを作成します。詳細は、「SSH キーをセットアップする」を参照してください。

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

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

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

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

アトラシアンコミュニティをご利用ください。

コミュニティに質問

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