翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS CodeArtifact でのセットアップ
Amazon Web Services (AWS) に既にサインアップしている場合は、 AWS CodeArtifact の使用をすぐに開始できます。CodeArtifact コンソールを開き、**ドメインとリポジトリの作成** を選択し、Launch Wizard (起動ウィザード) のステップに従って、最初のドメインとリポジトリを作成します。
AWS にまだサインアップしていない場合、または最初のドメインとリポジトリの作成にサポートが必要な場合は、以下のタスクを実行して CodeArtifact を使用するようにセットアップします。
**Topics**
+ [にサインアップする AWS](get-set-up-sign-up-for-aws.md)
+ [をインストールまたはアップグレードしてから設定する AWS CLI](get-set-up-install-cli.md)
+ [IAM ユーザーのプロビジョニング](get-set-up-provision-user.md)
+ [パッケージマネージャーまたはビルドツールをインストールする](getting-started-install-package-manager.md)
# にサインアップする AWS
Amazon Web Services (AWS) にサインアップすると、 AWS CodeArtifact を含む、使用するサービスとリソースに対してのみ課金されます。
が既にある場合は AWS アカウント、次のタスク に進みます[をインストールまたはアップグレードしてから設定する AWS CLI](get-set-up-install-cli.md)。がない場合は AWS アカウント、次の手順を使用して作成します。
**を作成するには AWS アカウント**
1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。
1. オンラインの手順に従います。
サインアップ手順の一環として、電話またはテキストメッセージを受け取り、電話キーパッドで検証コードを入力します。
にサインアップすると AWS アカウント、 *AWS アカウントのルートユーザー* が作成されます。ルートユーザーには、アカウントのすべての AWS のサービス とリソースへのアクセス権があります。セキュリティベストプラクティスとして、ユーザーに管理アクセス権を割り当て、[ルートユーザーアクセスが必要なタスク](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)の実行にはルートユーザーのみを使用するようにしてください。
# をインストールまたはアップグレードしてから設定する AWS CLI
ローカル開発マシンで AWS Command Line Interface (AWS CLI) から CodeArtifact コマンドを呼び出すには、 をインストールする必要があります AWS CLI。
古いバージョンの AWS CLI がインストールされている場合は、CodeArtifact コマンドが使用可能になるようにアップグレードする必要があります。CodeArtifact コマンドは、次の AWS CLI バージョンで使用できます。
1. **AWS CLI 1:** 1.18.77 以降
1. **AWS CLI 2:** 2.0.21 以降
バージョンを確認するには、`aws --version` コマンドを使用します。
**をインストールして設定するには AWS CLI**
1. 「 のインストール」の手順 AWS CLI で をインストールまたはアップグレードします。 [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)
1. 次のように AWS CLI、**configure** コマンドを使用して を設定します。
```
aws configure
```
プロンプトが表示されたら、CodeArtifact で使用する IAM ユーザーの AWS アクセスキーと AWS シークレットアクセスキーを指定します。デフォルトの AWS リージョン 名の入力を求められたら、パイプラインを作成するリージョン (`us-east-2` など) を指定します。デフォルトの出力形式の入力を求められたら、`json` を指定します。
**重要**
を設定すると AWS CLI、 を指定するように求められます AWS リージョン。「*AWS 全般のリファレンス*」の「[Region and Endpoints](https://docs.aws.amazon.com/general/latest/gr/codeartifact.html)」に記載されているサポートされているリージョンから一つを選びます。
詳細については、「[Configuring the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)」および「[Managing access keys for IAM users](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html)」を参照してください。
1. インストールまたはアップグレードを確認するには、 AWS CLIから次のコマンドを呼び出します。
```
aws codeartifact help
```
成功すると、このコマンドにより使用できる CodeArtifact コマンドのリストが表示されます。
IAM ユーザーを作成して、そのユーザーに CodeArtifact へのアクセス許可を付与できます。詳細については、「[IAM ユーザーのプロビジョニング](get-set-up-provision-user.md)」を参照してください。
# IAM ユーザーのプロビジョニング
以下の手順に従って、CodeArtifact を使用するための IAM ユーザーを準備します。
**IAM ユーザーをプロビジョニングするには**
1. IAM ユーザーを作成するか、 AWS アカウントに関連付けられた既存のユーザーを使用します。詳細については、IAM *ユーザーガイド*の[「IAM ユーザーの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console)」および[AWS 「IAM ポリシーの概要](https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html)」を参照してください。
1. IAM ユーザーに CodeArtifact へのアクセス許可を付与します。
+ **オプション 1:**カスタム IAM ポリシーを作成します。カスタム IAM ポリシーでは、最低限必要なアクセス許可を提供し、認証トークンの持続時間を変更できます。詳細とポリシー例については、「[AWS CodeArtifact のアイデンティティベースのポリシーの例](security_iam_id-based-policy-examples.md)」を参照してください。
+ **オプション 2:** `AWSCodeArtifactAdminAccess` AWS 管理ポリシーを使用します。次のスニペットは、このポリシーの内容を示しています。
**重要**
このポリシーにより、CodeArtifact API へのフルアクセスが付与されます。常に必要最小限のアクセス許可を使用してタスクを達成してください。詳細については、「*IAM ユーザーガイド*」の「[IAM ベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)」を参照してください。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"codeartifact:*"
],
"Effect": "Allow",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "sts:GetServiceBearerToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"sts:AWSServiceName": "codeartifact.amazonaws.com"
}
}
}
]
}
```
------
**注記**
IAM ユーザーまたはロールポリシーに `sts:GetServiceBearerToken` アクセス許可を追加する必要があります。アクセス許可は、CodeArtifact ドメインまたはリポジトリリソースポリシーに追加できますが、リソースポリシーには効果がありません。
CodeArtifact `GetAuthorizationToken` API を呼び出すには、`sts:GetServiceBearerToken` アクセス許可が必要です。この API は、CodeArtifact で `npm` または `pip` のようなパッケージマネージャーを使用するときに、使用する必要があるトークンを返します。CodeArtifact リポジトリでパッケージマネージャーを使用するには、IAM ユーザーまたはロールが、上記のポリシー例に示すように `sts:GetServiceBearerToken` を許可する必要があります。
CodeArtifact で使用する予定のパッケージマネージャーまたはビルドツールをインストールしていない場合は、[パッケージマネージャーまたはビルドツールをインストールする](getting-started-install-package-manager.md) を参照してください。
# パッケージマネージャーまたはビルドツールをインストールする
CodeArtifact のパッケージを公開または使用するには、パッケージマネージャーを使用する必要があります。パッケージタイプごとに異なるパッケージマネージャーがあります。CodeArtifact で使用できるパッケージマネージャーの一部を次のリストに示します。インストールしていない場合は、使用する予定のパッケージタイプのパッケージマネージャーをインストールします。
+ npm の場合は、[npm CLI](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) または [pnpm](https://pnpm.io/installation) を使用します。
+ Maven の場合は、[Apache Maven (`mvn`)](https://maven.apache.org/install.html) または [Gradle](https://gradle.org/install/) のいずれかを使用します。
+ Python の場合は、[pip](https://pip.pypa.io/en/stable/installation/) を使用してパッケージをインストールし、[twine](https://twine.readthedocs.io/en/stable/#installation) を使用してパッケージを公開します。
+ NuGet の場合は、Visual Studio で [Visual Studio 用のツールキット](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/setup.html) を使用するか、CLI で [nuget](https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference) または [dotnet](https://learn.microsoft.com/en-us/dotnet/core/install/) を使用します。
+ [ジェネリック](using-generic.md)パッケージの場合は、[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) または SDK を使用してパッケージコンテンツを公開およびダウンロードします。
## 次の手順
次のステップは、CodeArtifact で使用している 1 つまたは複数のパッケージタイプ、および CodeArtifact リソースの状態によって異なります。
あなた自身、チーム、または組織で初めて CodeArtifact を使い始める場合は、以下のドキュメントで一般的な入門情報や必要なリソースの作成について確認してください。
+ [コンソールを使用した開始方法](getting-started-console.md)
+ [AWS CLI を使用した開始方法](getting-started-cli.md)
リソースがすでに作成されていて、CodeArtifact リポジトリにパッケージをプッシュしたり、CodeArtifact リポジトリからパッケージをインストールしたりするようにパッケージマネージャーを設定する準備ができている場合は、パッケージタイプまたはパッケージマネージャーに対応するドキュメントを参照してください。
+ [CodeArtifactをnpmで使用する](using-npm.md)
+ [PythonでCodeArtifactを使う](using-python.md)
+ [MavenでCodeArtifactを使う](using-maven.md)
+ [NuGetでCodeArtifactを使う](using-nuget.md)
+ [CodeArtifact でのジェネリックパッケージの使用](using-generic.md)