翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# パッケージの概要
<a name="packages-overview"></a>

*[パッケージ]* とは、依存関係の解決とソフトウェアのインストールに必要なソフトウェアとメタデータのバンドルです。CodeArtifact には、パッケージはパッケージ名、`@types/node`に`@types`などの [[ネームスペース]](codeartifact-concepts.md#welcome-concepts-package-namespace) (オプション) など、パッケージバージョンのセット、およびパッケージレベルのメタデータ (npm タグなど) が含まれます。

**Contents**
+ [サポートされるパッケージ形式](#supported-package-formats)
+ [メッセージの公開](#package-publishing)
  + [公開許可](#package-publishing-permissions)
  + [パッケージアセットの上書き](#package-publishing-overwrite-assets)
  + [プライベートパッケージと公開リポジトリ](#package-publishing-upstreams-direct)
  + [パッチが適用されたパッケージバージョンの公開](#package-publishing-patched-versions)
  + [公開時のアセットサイズ制限](#package-publishing-asset-size-limits)
  + [公開時のレイテンシー](#package-publishing-latency)
+ [パッケージバージョンのステータス](#package-version-status)
+ [パッケージ名、パッケージバージョン、アセット名の正規化](#package-name-normalization)

## サポートされるパッケージ形式
<a name="supported-package-formats"></a>

AWS CodeArtifact は、[Cargo](using-cargo.md)、[ジェネリック](using-generic.md)、[Maven](using-maven.md)、[npm](using-npm.md)、[NuGet](using-nuget.md)、[PyPI](using-python.md)、[Ruby](using-ruby.md)、[Swift](using-swift.md) パッケージ形式をサポートしています。

## メッセージの公開
<a name="package-publishing"></a>

 [サポートされるパッケージ形式](#supported-package-formats)はどれも新しいバージョンが、`npm`、`twine`、`Maven`、`Gradle`、`nuget`、および`dotnet`などのツールを使い、CodeArtifact リポジトリで公開することができます。

### 公開許可
<a name="package-publishing-permissions"></a>

 AWS Identity and Access Management (IAM) ユーザーまたはロールには、送信先リポジトリに発行するアクセス許可が必要です。パッケージを公開するには、以下の権限が必要です。
+ **Cargo:** `codeartifact:PublishPackageVersion`
+ **ジェネリック:** `codeartifact:PublishPackageVersion`
+ **Maven:** `codeartifact:PublishPackageVersion`そして`codeartifact:PutPackageMetadata`
+ **npm**`codeartifact:PublishPackageVersion`
+ **NuGet:** `codeartifact:PublishPackageVersion`そして`codeartifact:ReadFromRepository`
+ **Python:** `codeartifact:PublishPackageVersion`
+ **Ruby:** `codeartifact:PublishPackageVersion`
+ **Swift:** `codeartifact:PublishPackageVersion`

上記の権限リストでは、IAM ポリシーで `codeartifact:PublishPackageVersion` 権限と `codeartifact:PutPackageMetadata` 権限の `package` リソースを指定する必要があります。また、`codeartifact:ReadFromRepository` 権限の `repository` リソースも指定する必要があります。

CodeArtifact の権限の詳細については、「[AWS CodeArtifact アクセス許可リファレンス](auth-and-access-control-permissions-reference.md)」を参照してください。

### パッケージアセットの上書き
<a name="package-publishing-overwrite-assets"></a>

 別のコンテンツで既に存在するパッケージアセットを再公開することはできません。例えば、JAR アセット `mypackage-1.0.jar`を持つ Maven パッケージをすでに公開したとします。古いアセットのチェックサムと新しいアセットのチェックサムが同じである場合のみ、そのアセットを再度公開できます。新しいコンテンツで同じアセットを再公開するには、最初に**delete-package-versions**コマンドを使ってパッケージバージョンを削除してください。異なるコンテンツで同じアセット名を再公開しようとすると、HTTP 409 の競合エラーが発生します。

 複数のアセット (PyPI と Maven) をサポートするパッケージ形式の場合、必要な権限を持っていれば、いつでも既存のパッケージバージョンに異なる名前の新しいアセットを追加できます。ジェネリックパッケージの場合、パッケージバージョンが `Unfinished` 状態にある限り、新しいアセットを追加できます。npm はパッケージバージョンごとにひとつのアセットしかサポートしないため、公開されたパッケージバージョンを何らかの方法で変更するには、まず、**delete-package-versions**を使用してそれを削除する必要があります。

 すでに存在するアセットを再公開しようとした場合 (例えば、`mypackage-1.0.jar`)、公開されたアセットと新規アセットの内容が同じである場合、操作が冪等であるため、この操作は成功します。

### プライベートパッケージと公開リポジトリ
<a name="package-publishing-upstreams-direct"></a>

 CodeArtifact は、CodeArtifact リポジトリに保存されているパッケージを npmjs.com や Maven Central などの公開リポジトリに公開しません。CodeArtifact は、公開リポジトリから CodeArtifact リポジトリにパッケージをインポートしますが、パッケージを別の方向に移動することはありません。CodeArtifact リポジトリに発行するパッケージはプライベートのままで、アクセスを許可した AWS アカウント、ロール、およびユーザーのみが使用できます。

### パッチが適用されたパッケージバージョンの公開
<a name="package-publishing-patched-versions"></a>

 場合によっては、公開リポジトリで利用可能な変更パッケージバージョンを公開したい場合があります。例えば、`mydep 1.1`という重要なアプリケーション依存関係にバグが見つかった場合、パッケージベンダーがその変更をレビューして承認できるよりも早く修正する必要があるとしましょう。前述のように、CodeArtifact リポジトリで、公開リポジトリがアップストリームのリポジトリと外部接続を介して CodeArtifact リポジトリから到達可能な場合、CodeArtifact は`mydep 1.1`の公開を防ぎます。

この問題を回避するには、公開リポジトリに到達できない別の CodeArtifact リポジトリにパッケージバージョンを公開します。次に、`copy-package-versions` API を使用し、パッチが適用された `mydep 1.1` のバージョンを、使用先の CodeArtifact リポジトリにコピーします。

### 公開時のアセットサイズ制限
<a name="package-publishing-asset-size-limits"></a>

公開できるパッケージアセットの最大サイズは、「[AWS CodeArtifact のクォータ](service-limits.md)」に示されている**アセットファイルサイズの最大**クォータによって制限されます。例えば、現在のアセットファイルサイズの最大クォータを超える Maven JAR または Python ホイールを公開することはできません。より大きなアセットを CodeArtifact に保存する場合は、クォータの引き上げをリクエストしてください。

アセットファイルサイズの最大クォータに加えて、npm パッケージの公開リクエストの最大サイズは 2 GB の制限があります。この制限はアセットファイルサイズの最大クォータとは関係なく、クォータを引き上げることで増やすことはできません。npm 公開リクエスト (HTTP PUT) では、パッケージメタデータと npm パッケージ tar アーカイブのコンテンツが一緒にバンドルされます。このため、公開できる npm パッケージの実際の最大サイズは、含まれるメタデータのサイズによって異なります。

**注記**  
公開される npm パッケージの最大サイズは 2 GB 未満に制限されています。

### 公開時のレイテンシー
<a name="package-publishing-latency"></a>

CodeArtifact リポジトリに公開されたパッケージバージョンは、多くの場合 1 秒未満でダウンロードできます。例えば、`npm publish` で npm パッケージバージョンを CodeArtifact に公開した場合、そのバージョンは 1 秒以内に `npm install` コマンドで使用できるようになります。ただし、公開には一貫性がなく、時間がかかることがあります。公開後すぐにパッケージバージョンを使用する必要がある場合は、再試行を行ってダウンロードの信頼性を確保してください。例えば、パッケージバージョンを公開した後、公開したばかりのパッケージバージョンが最初にダウンロードできなかった場合は、ダウンロードを最大 3 回繰り返します。

**注記**  
通常、パブリックリポジトリからパッケージバージョンをインポートすると、公開よりも時間がかかります。詳細については、「[外部接続のレイテンシー](external-connection-requesting-packages.md#external-connection-latency)」を参照してください。

## パッケージバージョンのステータス
<a name="package-version-status"></a>

CodeArtifact のすべてのパッケージバージョンには、パッケージバージョンの現在の状態と使用可用性を示すステータスがあります。 AWS CLI と SDK で、パッケージバージョンのステータスを変更することができます。詳細については、「[パッケージバージョンのステータスの更新](update-package-version-status.md)」を参照してください。

パッケージバージョンのステータスに設定できる値は以下の通りです。
+  **[公開]** - パッケージバージョンは正常に公開され、パッケージマネージャーを使用してリクエストできます。パッケージバージョンは、`npm view <package-name> versions` の出力など、パッケージマネージャーによって返されるパッケージバージョンリストに含まれます。パッケージバージョンのすべてのアセットは、リポジトリから入手できます。
+  **[未完了]** - クライアントはパッケージバージョンの 1 つ以上のアセットをアップロードしましたが、それを `Published` 状態に移行してアップロードを完了することができませんでした。現在 `Unfinished` のステータスになり得るのは、ジェネリックパッケージバージョンと Maven パッケージバージョンのみです。これは、クライアントがパッケージバージョンの 1 つ以上のアセットをアップロードしたものの、そのバージョンを含むパッケージの `maven-metadata.xml` ファイルを公開しなかった場合に発生します。Maven パッケージバージョンが **[未完了]** の場合、`mvn` や `gradle` などのクライアントに返されるバージョンリストには含まれないため、ビルドの一部として使用することはできません。[PublishPackageVersion](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PublishPackageVersion.html) API を呼び出すときに `unfinished` フラグを指定することで、ジェネリックパッケージを意図的に `Unfinished` 状態に保つことができます。ジェネリックパッケージを `Published` 状態に変更するには、`unfinished` フラグを省略するか、[UpdatePackageVersionsStatus](https://docs.aws.amazon.com//codeartifact/latest/APIReference/API_UpdatePackageVersionsStatus.html) API を呼び出します。
+  **[一覧表示されていない]** - パッケージバージョンのアセットはリポジトリからダウンロードできますが、パッケージマネージャーによって返されるパッケージバージョンのリストには含まれません。例えば、npm パッケージの場合、`npm view <package-name> versions` の出力にパッケージバージョンは含まれません。つまり、npm の依存関係解決論理は、使用可能なバージョンのリストに表示されないため、パッケージのバージョンを選択しません。ただし、**[一覧表示されていない]** パッケージバージョンがすでにすべての`npm package-lock.json`ファイルで参照されていれば、`npm ci`の実行時などに、ダウンロードしてインストールできます。
+  **[アーカイブ済み]** - パッケージバージョンのアセットはこれ以降ダウンロードできません。パッケージバージョンは、パッケージマネージャーによって返されるバージョンのリストには含まれません。アセットが使用できないため、クライアントによるパッケージバージョンの使用はブロックされます。アプリケーションのビルドが、**[アーカイブ済み]** に更新されたバージョンに依存している場合、パッケージのバージョンがローカルにキャッシュされていないと仮定されるため、構築は中断されます。**[アーカイブ済み]** パッケージバージョンがまだリポジトリに存在するため、パッケージマネージャーまたはビルドツールを使用して再度公開することはできません。しかし、パッケージバージョンのステータスを **[パッケージのバージョンステータスのアップロード API]** で **[一覧表示されていない]** または [[公開]](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_UpdatePackageVersionsStatus.html) にすることは可能です。
+  **[開放済み]** - パッケージバージョンはリストに表示されず、アセットをリポジトリからダウンロードできません。**[開放済み]** と **[アーカイブ済み]** ステータスの主な違いは、**[開放済み]** のステータス場合、パッケージバージョンのアセットは CodeArtifact によって完全に削除されることです。このため、パッケージバージョンを**[開放済み]** から**[アーカイブ済み]**、**[一覧表示されていない]**、または **[公開]** に移動することはできません。アセットが削除されているため、パッケージバージョンはこれ以降使用できません。パッケージバージョンが **[開放済み]** としてマークされた後は、パッケージアセットの保存に関する費用は、これ以降請求されなくなります。

`--status` パラメータなしで list-package-versions を呼び出すと、すべてのステータスのパッケージバージョンがデフォルトで返されます。

 上記の状態とは別に、パッケージバージョンを [DeletePackageVersions API](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_DeletePackageVersions.html) で削除することもできます。削除後、パッケージバージョンはリポジトリ内に存在しなくなり、パッケージマネージャーまたはビルドツールを使用して、そのパッケージバージョンを自由に再公開できます。パッケージバージョンが [開放済み] としてマークされた後は、パッケージアセットの保存に関する費用は、これ以降請求されなくなります。

## パッケージ名、パッケージバージョン、アセット名の正規化
<a name="package-name-normalization"></a>

CodeArtifact は、パッケージ名、パッケージバージョン、およびアセット名を保存する前に正規化します。つまり、CodeArtifact の名前またはバージョンは、パッケージが公開されたときに提供された名前やバージョンとは異なる場合があります。CodeArtifact でパッケージタイプごとに名前とバージョンを正規化する方法については、次のドキュメントを参照してください。
+ [Python パッケージ名の正規化](python-name-normalization.md)
+ [NuGet パッケージ名、バージョン、アセット名の正規化](nuget-name-normalization.md)

CodeArtifact は、他のパッケージ形式では正規化を行いません。