Stash 3.11 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.11 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.11 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9 または 10、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
• アトラシアン サポートからの依頼などで stash-stream-guard-plugin をインストール済みの場合、この機能は Stash に組み込まれるようになったため、3.11.2 へのアップグレード時にアンインストールします。

既知の問題

Stash 3.10 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.10 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.10 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9 または 10、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

Git 2.2x - 2.4.0 を使用していますか?

Git 2.2.x - 2.4.0 では、NFS とのやり取りでパフォーマンスの問題が発生することが確認されています。このため、これらのバージョンは、ホーム ディレクトリに NFS マウントを使用する Stash Data Center または Stash Server のインストールでは現在サポートされていません。

既知の問題

Stash 3.9 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.9 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.9 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

Jira を Crowd サーバーとして使用していますか?

Jira 6.4 のバグのため、Stash 3.9 では Jira 6.4 を Crowd サーバーとして使用することはできません。Stash へのアップグレードを行う前に、Jira 6.4.1 にアップグレードしてください (Stash 3.7.2 と 3.8.0 にはこのバグに関連する回避策が含まれていましたが、これは Stash 3.9 で削除されています)。

既知の問題

Stash 3.8 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.8 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.8 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

Tomcat の server.xml ファイルにカスタマイズを行っていますか?

Stash 3.8 (および以降のバージョン) では、server.xml ファイルは <stash home directory>/shared ディレクトリに配置されるようになりました。これにより、今後のアップグレードで、server.xml へのカスタマイズの再適用が不要になります。

 Stash 3.8 へのアップグレードでは、shared/server.xml でのカスタム設定を引き続き更新する必要があります。

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

Stash 3.7 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.7 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.7 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

Jira 6.4 を使用していますか?

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

Stash 3.6 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.6 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.6 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

安全なメール通知

Stash 3.6 には次のような更新があります。

• SMTP を使用している場合、メール サーバー側での STARTTLS サポートを要求できます。サポートされない場合、メールは送信されません。 
• SMTPS のサポート (プロトコルのやり取り全体で SSL / TLS を使用)。

詳細については、「メール サーバーのセットアップ」をご参照ください。

STARTTLS と SMTP、または SMTPS をすでに使用していて、自己署名済みのメール サーバーに接続している場合、Stash にサーバーの証明書をインポートしてカスタムの cacert ファイルをセットアップする必要がある場合があります (自己署名済みサーバーへの SSL / TLS アウトバウンド接続に対して行う設定と同様)。この方法の詳細については Stash のナレッジベース記事をご参照ください。

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

Stash 3.5 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.5 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.5 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。Stash 4.0 では Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。

Stash のホーム ディレクトリの場所

Stash 3.5 以降のバージョンでは、ホーム ディレクトリを Stash のインストール ディレクトリと同じ場所にしたり、Stash のインストール ディレクトリのサブディレクトリにしたりすることはできません。Stash のホーム ディレクトリは STASH_HOME 環境変数で定義され、別の場所に存在する必要があります。これに違反する場合、Stash は開始に失敗します。

シンタックス ハイライトでの HighlightJS の廃止

Stash では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

Stash 3.4 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.4 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.4 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。

複数のユーザー ディレクトリでのグループ メンバーシップ アグリゲーションの変更

Stash 3.4 では、Stash が複数のユーザー ディレクトリに接続されていて、それらのディレクトリ間でユーザー名やグループ名が重複している場合に、新しいスキームを使用して有効なグループ メンバーシップを判定します。新しいスキームは次のとおりです。 

• 'aggregating membership'
• 'non-aggregating membership'.

これらのグループ メンバーシップ スキームは、認証の判定にのみ使用されます。認証は、各ディレクトリでのグループ マッピングに基づいて判断されます。

詳細については、Crowd ドキュメントの「複数のディレクトリがある場合に有効なメンバーシップ」をご参照ください。

Stash 3.4 に更新すると、更新タスクによっていずれかスキームを次のように適用されます。

Aggregating membership がインスタンスに適用される条件:

• • アクティブなディレクトリが 1 つだけ存在する場合。
  • アクティブなディレクトリが複数あるが、任意のユーザーに対しては 1 つのディレクトリのみが適用される場合。
  • 例として、directory-1 に group-x の user-a が含まれ、directory-2 に group-y の user-b が含まれる場合、Stash 3.4 は aggregating membership を適用し、権限への影響はありません。

Non-aggregating membership がインスタンスに適用される条件:

• • 複数のアクティブなディレクトリがあり、2 つ以上のディレクトリが少なくとも 1 ユーザーにグループ メンバーシップを適用している場合。
  • 例として、directory-1 に group-x の user-a が含まれ、directory-2 に group-y の user-a が含まれる場合、Stash 3.4 は non-aggregating membership を適用します。group-y に管理権限が割り当てられていて、Stash 3. 4へのアップグレード時に aggregating membership が適用されていた場合、user-a では権限の昇格が行われます。

更新タスクによって行われたすべての変更が記録されます。

Stash 管理者は次のコマンドを使用して、Stash が使用するメンバーシップ スキームを変更できます。

• aggregating membership に変更するには、次のコマンドで、<username>、<password>、および <base-url> を自身の値で置き換えます。

  curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":true}' -u <username>:<password> <base-url>/rest/crowd/latest/application 

• aggregating membership に変更するには、次のコマンドで <username>、<password>、および <base-url> を自身の値で置き換えます。

  curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":false}' -u <username>:<password> <base-url>/rest/crowd/latest/application

アグリゲーション スキームの変更は Stash ユーザーの認証権限や更新処理の実行方法に影響する場合があることにご注意ください。Stash を複数のユーザー ディレクトリで使用する方法についてご確認ください。

既知の問題

Stash 3.3 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.3 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。Stash 3.3 では Git 2.0.2 または 2.0.3 はサポートされない点にご注意ください。
• サポート終了のお知らせ。

既知の問題

Stash 3.2 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.2 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。
• サポート終了のお知らせ。

注意:

• Stash 3.2 では、Git 2.0.2 または 2.0.3 はサポートされません。

ホーム ディレクトリの以降

Stash 3.2 以降に更新すると、更新タスクによって Stash のホーム ディレクトリのディレクトリが新しい場所に移行されます。これは不可逆的な操作です。Stash のホーム ディレクトリの形式が変更されるため、Stash 3.2 以降に更新したあとは、Stash 3.1 以前に戻すことはできません。

ほとんどのインストールにおいて、Stash 3.2 はこれらの移行を自動かつ透過的に実行できます。稀に、Stash 3.2 が自動更新を実行できないインスタンスがあります。その場合、「Stash のホーム ディレクトリを手動で Stash 3.2 にアップグレードする」を参照してください。

ドキュメントに未記載のディレクトリのオーバーライドのサポートを廃止

Stash 3.2 まででは、Stash のホーム ディレクトリの次のサブフォルダの場所を、ドキュメントに未記載の変数やシステム プロパティでオーバーライドすることができました。

In Stash 3.2 only the  tmp  subfolder can be overridden in this way. Attempting to override the others will fail on startup. For more information, please see  Stash fails to start - UnsupportedDirectoryOverrideException . 

Stash の統計情報

Stash 3.2 以降は、ユーザーのイベント データを収集します (管理者によって無効化されている場合を除く)。これにより、amazonaws.com への出力ネットワークが発生します。「データ収集設定の変更」をご確認ください。

既知の問題

Stash 3.1 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.1 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。

注意:

• Stash では Git 2.0.2 または 2.0.3 はサポートされません。

既知の問題

Stash 3.0 アップデート ノート

次のページもご参照ください。

• 上述の全般的なアップグレード ステップ セクション。
• Stash 3.0 リリース ノート。
• Stash の「サポート対象プラットフォーム」ページ。

注意:

• Stash には、Linux、macOS、および Windows プラットフォーム用のインストーラーが提供されるようになりました。
• 過去のお知らせのとおり、Stash では Internet Explorer 8 のサポートを終了しています。
• Stash では Apache HTTP Server の mod_auth_basic モジュールはサポートされません。
• Stash では Git 2.0.2 または 2.0.3 はサポートされません。

Stash のアドオンの非互換性

Stash 3.0 で動作するように更新されている場合を除き、Stash 3.0 で削除された API インターフェイスを使用する既存の Stash アドオン (またはプラグイン) は動作しなくなります。

Stash 3.0 の新しいインストールの場合、問題は発生しないことが想定されます。Stash の管理領域の [アドオンの管理] ページには、Marketplace にある、Stash 3.0 との互換性がマークされたアドオンのみが表示されます。互換性を持たないアドオンは一覧に表示されません。 

しかしながら、Stash 2.x から Bitbucket Server 3.x にアップグレードする場合、既存のインストール済みのアドオンの一部は Stash 3.0 との互換性を持たない可能性がある点に注意してください。アップグレード後に [管理] > [アドオンの管理] に進み、この形式のメッセージを見つけ、指示に従って更新する必要があります。

利用可能な新しいバージョンがない場合、そのアドオンを無効化する必要があります。 

カスタム アドオン

ローカルで開発したカスタム プラグインは、Stash 3.0 での API の削除の影響を受ける可能性があります。これらを Stash 3.0 で使用したい場合、カスタム プラグインを更新する必要があります。廃止予定の API の詳細については Stash API の変更履歴をご確認ください。

他社製アドオン

ご利用のサードパーティ アドオンの互換性の状態については Atlassian Marketplace を確認する必要があります。

サードパーティ アドオンの開発者には、リリースに先立って Stash 3.0 のアーリー アクセス プログラム (EAP) ビルドが提供されており、ほとんどの開発者が互換性を保つようにアドオンをすでに更新しています。Stash の [アドオンの管理] ページにアドオンが表示されるようにするには、公開元が Stash 3.0 との互換性を明示的にマークしている必要があります。これは 2.10 や 2.11 などの過去のマイナー リリースのように自動的に行われるわけではありません。アトラシアンでは、Stash 3.0 との互換性を持たないサードパーティ アドオンに関連する問題をサポートすることはできません。このようなサポート ケースはアドオンのサードパーティの公開元で扱う必要があります。「アプリの管理」をご確認ください。

アトラシアン アドオン

Atlassian Marketplace で利用可能な、Stash 向けのすべてのアトラシアン アドオンは、Stash 3.0 との互換性を持つように更新されました。これらのいずれかをご利用の Stash インストールで使用する場合、Stash 3.0 との互換性を持つバージョンに更新する必要があります。

既知の問題

Stash 2.12 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。特に、Java 6 のサポートは廃止予定である点にご注意ください。Stash 3.0+ では Java 7 が必要になります。
• Stash 2.12 リリース ノート。

注意:

• 現時点では、Stash は Java 8 に対応していません。
• Stash 2.12 では Git 1.8.4.3 はサポートされません
• Stash では Apache HTTP Server の mod_auth_basic モジュールはサポートされません。 

「サポート対象プラットフォーム」を参照してください。

既知の問題

Stash 2.11 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。
• Stash 2.11 リリース ノート。

Stash では Git 1.8.4.3 はサポートされておらず、Stash は Java 8 もまだサポートしていない点にご注意ください。「サポート対象プラットフォーム」を参照してください。

既知の問題

Stash 2.10 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。
• Stash 2.10 リリース ノート。

Stash では Git 1.8.4.3 はサポートされない点にご注意ください。「サポート対象プラットフォーム」を参照してください。

既知の問題

Stash 2.9 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。
• Stash 2.9 リリース ノート。

Stash では Git 1.8.4.3 はサポートされない点にご注意ください。「サポート対象プラットフォーム」を参照してください。

プル リクエストの ref の最適化

Stash 2.9 へのアップグレード後に最初に Stash を起動すると、Stash が管理するすべてのリポジトリ用にプル リクエストの ref を最適化する、リポジトリのアップグレード タスクが実行されます。このアップグレード プロセスを中断しないでください。これらの進捗は Stash のログで追跡できます。 STASH-3469 - Getting issue details... STATUS をご確認ください。

Backup Client の更新が必要

Stash 2.9 のバックアップには、Stash Backup Client のバージョン 1.0.3 が必要です。

既知の問題

Stash 2.8 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。
• Stash 2.8 リリース ノート。

既知の問題

Stash 2.7 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。

Repository System Information Plugin の廃止予定

リポジトリ システム情報プラグイン の機能は Stash の中核機能に移行されました。このプラグインは Stash 2.x バージョンでは引き続き動作しますが、Stash 2.7 以降では不要です。

MySQL の既定の分離レベル

Stash 2.7.x は MySQL の既定の分離レベル (REPEATABLE_READ) ではなく READ_COMMITED を使用します。このため、ご利用の MySQL サーバーでバイナリ ロギングが有効化されている場合、2.7.x のインストールまたはこのバージョンへのアップグレードで例外が発生する可能性があります。詳細情報と修正方法についてはこのナレッジベース記事をご確認ください。

既知の問題

Stash 2.6 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。

既知の問題

Stash 2.5 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。

既知の問題

Jira 4.4.x 以前の限定的なサポート

Jira 4.3+ では、Jira の課題に関連付けられたコミットを表示できます。ただし、Stash 内での課題の表示は、Jira 4.4.x 以前ではサポートされません。

Stash 2.4 アップデート ノート

次のページもご参照ください。

• 上述のアップグレード ステップ セクション。
• サポート終了のお知らせ。

既知の問題

Stash 2.3 アップデート ノート

上述のアップグレード ステップ セクションもご確認ください。

Stash 2.3 にアップグレードする場合、最新の Stash API の変更に対応するため、SCM Cache プラグインも更新する必要があります。

既知の問題

Stash 2.2 アップデート ノート

上述のアップグレード ステップ セクションをご確認ください。

既知の問題

Stash 2.1 アップデート ノート

上述のアップグレード ステップ セクションもご確認ください。

既知の問題

サードパーティ ライブラリのインストール場所

Stash 2.1 以降では、MySQL JDBC ドライバなどのサードパーティ製のライブラリや jar ファイルを、<Stash home directory>/lib にインストールできます。ここにあるファイルは、Stash の更新時に上書きされたり、失われたりすることはありません。

Microsoft SQL Server JDBC ドライバ

Stash 2.1 は Microsoft SQL Server へのアクセスに jTDS ドライバではなく Microsoft SQL Server JDBC ドライバを使用するようになりました。ほとんどの場合、Stash は更新時に Microsoft ドライバを使用するように自動的に切り替わるため、特別な構成は不要です。

JDBC URL を手動で入力することで、Microsoft SQL Server を使用するように Stash  を設定済みの場合、このガイドを参照してください。

Stash 2.0 アップデート ノート

このセクションでは、Stash 2.0 へのアップグレードに固有の事項について説明します。上述のアップグレード ステップ セクションもご確認ください。

Tomcat

Stash 2.0 では、Tomcat がバージョン 6 から 7 に更新されました。この更新の一環として、 server.xml ファイルが変更されました。server.xml ファイルをカスタマイズしている場合 (例: port、path、または hostname )、現在のバージョンを更新された Stash に単純にコピーすることはできません。カスタマイズ内容を新しいバージョンの Stash の server.xml に再適用する必要があります。

Stash を Windows サービスとして使用していて、1.x から 2.x にアップグレードする場合、Tomcat 7 を使用するように Stash サービスを再インストールする必要があります。

Stash サービスをアンインストールするには、<STASH DISTRIBUTION DIR>\bin から次のコマンドを実行する必要があります。

> net stop <service name>
> service.bat uninstall <service name>

Stash サービスを既定の名前でインストールした場合、このコマンドはサービス名なしで呼び出すことができます。

After the service is uninstalled you can proceed with the update steps and refer to the  Running Bitbucket Server as a Windows service page for instructions to configure Stash 2.x running as a service.

Perl

Stash 2.0 のブランチ権限の機能には Perl が必要です。Perl が利用できない場合、Stash 2.0 は開始されません。

Windows マシンの場合、適切なインストール オプションが選択されていた場合にのみ、Git インストーラーで Perl がインストールされます。「Git のインストールとアップグレード」をご確認ください。

既存の Git フック

ブランチ権限をサポートするため、Stash 2.0 は  <Stash home directory>/data/repositories/NNNN/hooks (ここで NNN は内部のリポジトリ ID) の pre-receive および post-receive フォルダにある既存のフックを .../hooks/pre-receive.d/10_custom または .../hooks/post-receive.d/10_custom に移動します。これにより、相対パス名 (例: "./foo.sh" または "../dir/foo.sh") を使用するカスタム フックは Stash 2.0 への更新で壊れます。

Internet Explorer 8 の廃止

Internet Explorer 8 のサポートは、Stash 2.0 のリリースで廃止予定になりました。公式なサポート終了日は未定です。詳細は｢サポート対象プラットフォーム｣ を確認してください。

既知の問題