Configuring Apache mod_proxy_balancer for Bitbucket Data Center
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
免責事項
As Bitbucket Data Center applications are using the load balancer both on the application (HTTPS) and transport (SSH) levels it is strongly recommended to use the load balancer software capable of performing a load balancing on both levels. Until usage of mod_proxy_balancer is not the requirement we recommend you to use the HAProxy as mentioned in the documentation.
mod_proxy_balancer examples
Bitbucket DC requires sticky HTTP sessions. Using a cookie strategy approach for this will give you more control over user IP changes that occur due to network or VPN configuration.
mod_proxy_balancer と特有の cookie
この方法は、同じセッションのすべてのリクエストを同じバックエンド サーバーにルーティングする特有の cookie をロードバランサが作成する場合、負担が少ないアプローチです。
この例では、Apache に対して、ROUTEID と呼ばれる cookie を作成し、stickysession で使用するよう指示します。
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
<Proxy balancer://bitbucketcluster>
BalancerMember http://backend1:7990 route=perftest1
BalancerMember http://backend2:7990 route=perftest2
</Proxy>
ProxySet stickysession=ROUTEID
ProxyPass / balancer://bitbucketcluster/ lbmethod=byrequests stickysession=ROUTEID
ProxyPreserveHost On
In that case when the user is connected to Bitbucket DC the following cookies are getting set:
Cookie 名 | Cookie 値 | ドメイン | パス | 有効期限 | 作成元 |
|---|---|---|---|---|---|
| DDFACF910F0F807930AE2A382956018F | backend1 | /bitbucket/ | セッション | バックエンドの Tomcat |
| ROUTEID | .perftest1 | backend1 | / | セッション | Apache |
Tomcat BITBUCKETSESSIONID cookie
Tomcat supports routing information in the BITBUCKETSESSIONID cookie when you start with -DjvmRoute=<nodeName> parameter. This information is also used by Apache.
<Proxy balancer://bitbucketcluster>
BalancerMember http://backend1:7990 route=perftest1
BalancerMember http://backend2:7990 route=perftest2
</Proxy>
ProxyPass / balancer://bitbucketcluster/ stickysession=BITBUCKETSESSIONIDIn that case when the user is connected to Bitbucket DC the following cookies are getting set:
Cookie 名 | Cookie 値 | ドメイン | パス | 有効期限 | 作成元 |
|---|---|---|---|---|---|
| 9CA086750138E6FC6965D1A82E652E96.perftest1 | backend1 | /bitbucket/ | セッション | バックエンドの Tomcat |
Note that the route information is added as a suffix on BITBUCKETSESSIONID value