> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Auth0 のバージョニングの仕組みを理解します。

# Auth0 のバージョニング戦略

Auth0 では、バージョニングは提供内容の重要な要素であると考えており、製品全体で一貫したバージョニング体系を提供できるよう取り組んでいます。これにより、ユーザーは変更が利用にどのような影響を与えるかを把握し、予測できます。

<div id="semantic-versioning">
  ## セマンティック バージョニング
</div>

[セマンティック バージョニング](http://semver.org) (semver とも呼ばれます) は、breaking changes を識別しやすくすることを主な特徴とするバージョニング戦略です。バージョンは、ドットで区切られた 3 つの数値 {major}.{minor}.{patch} で構成されます。たとえば、2.12.5、0.1.0、10.5.35 はいずれも有効な semver のバージョン番号です。

* 1 番目の数字は **major change** を表します。これは、ライブラリ API が後方互換性のない形で変更されたことを意味します。バージョンの major 部分が上がると、そのライブラリの公開 API が変更されたことになります。たとえば、以前から非推奨とされていた code や機能がコードベースから削除されます。
* 2 番目の数字は **minor change** を表します。これは、後方互換性を維持したまま、ライブラリ API に新機能が追加された、または非推奨としてマークされたことを意味します。新しい minor バージョンは安全に利用できることが想定されているため、お客様には更新を推奨しています。ただし、お客様によるコンポーネントの利用方法をすべて把握することは不可能であるため、変更が現在の利用状況に影響を及ぼす可能性は常にあります。そのため、更新前に確認とテストを実施することを推奨します。
* 3 番目の数字は **patch change** を表します。これは、不具合が修正され、ユーザー向け API に影響を及ぼさないはずの変更です。通常は安全に更新できますが、テストの実施は引き続き推奨されます。

<div id="production-usage">
  ## 本番環境での利用
</div>

Auth0 は、一部のライブラリを配信している [Content Delivery Network (CDN)](https://en.wikipedia.org/wiki/Content_delivery_network) へのリンクを提供しています。コード内でコンポーネントをどのように参照するかによって、変更が自動的に反映されるかどうか、また、いつ反映されるかが決まります。たとえば、スクリプト内でメジャーリリースを参照している場合、新しいマイナーリリースが公開されると、その更新は公開され次第自動的に適用されます。Auth0 の開発環境や試験的な利用では、この方法を推奨しています。以下に、ソースファイルを埋め込む例を示します。

```html lines theme={null}
<!-- メジャーリリース -->
<script src="https://cdn.auth0.com/example/1/library.js"></script>

<!-- マイナーリリース -->
<script src="https://cdn.auth0.com/example/1.0/library.js"></script>

<!-- パッチリリース（本番環境での使用を推奨） -->
<script src="https://cdn.auth0.com/example/1.0.1/library.js"></script>
```

Auth0 コンポーネントを本番環境にデプロイする際は、完全なバージョン番号に固定し、そのバージョンで十分にテストすることを推奨します。後方互換性を維持した形で新機能を追加しても、通常はコードが壊れることはありませんが、コンポーネントの動作との相互作用は予測しにくい場合があります。軽微なバグ修正であっても、コンポーネントに対して置いていた前提が変わり、それがもはや成り立たなくなる可能性があります。

semver に従う Auth0 の各オープンソースコンポーネントには、git リポジトリ内でリリース済みバージョンに対応するタグがあります。一部のプロジェクトではバージョンのリリースに [npm](https://npmjs.com) ツールを使用しているため、タグには接頭辞として `v` が付きます。たとえば、バージョン 5.2.3 のタグは v5.2.3 になります。

<div id="learn-more">
  ## 詳しく見る
</div>

* [製品サポートマトリックス](/ja/docs/troubleshoot/customer-support/product-support-matrix)