AWS CLI を使用した開始方法

AWS Command Line Interface (AWS CLI) を使用して CodeArtifactを開始するには、以下のステップを実行します。詳細については、「AWS CLIをインストールまたはアップグレードしてから設定するには」を参照してください。このガイドでは、npm パッケージマネージャーを使用します。別のパッケージマネージャーを使用している場合は、次のステップの一部を変更する必要があります。

AWS CLI を使用して create-domain コマンドを実行します。
```
aws codeartifact create-domain --domain my-domain
```
JSON 形式のデータが、新しいドメインの詳細とともに出力に表示されます。
```
{
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Active",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}
```
エラー Could not connect to the endpoint URL が発生した場合は、AWS CLI が設定されており、[デフォルトリージョン名] がリポジトリを作成したのと同じリージョンに設定されていることを確認してください。「Configuring the AWS Command Line Interface」を参照してください。

create-repositoryコマンドを使用して、ドメインにリポジトリを作成します。


aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo

JSON 形式のデータが、新しいリポジトリの詳細とともに出力に表示されます。


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [],
        "externalConnections": []
    }
}

create-repository コマンドを使用して、my-repo リポジトリのアップストリームリポジトリを作成します。


aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

JSON 形式のデータが、新しいリポジトリの詳細とともに出力に表示されます。


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": []
    }
}

associate-external-connection コマンドを使用して、npm 公開リポジトリへの外部接続をnpm-store リポジトリに追加します。


aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"

JSON 形式のデータが、リポジトリとその新しい外部接続についての詳細とともに出力に表示されます。


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

詳細については、「 CodeArtifact リポジトリをパブリックリポジトリに接続する」を参照してください。

update-repository コマンドを使用して、npm-store リポジトリを my-repo リポジトリへのアップストリームリポジトリとして関連付けます。


aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store

JSON 形式のデータが、新しいアップストリームリポジトリを含む、更新されたリポジトリの詳細とともに出力に表示されます。


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

詳細については、「アップストリームリポジトリを追加または削除する (AWS CLI)」を参照してください。

login コマンドを使用して、my-repo リポジトリに npm パッケージマネージャーを設定します。


aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333

ログインが成功したことを確認する出力が表示されます。


Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
Login expires in 12 hours at 2020-10-08 02:45:33-04:00

詳細については、「で npm を設定して使用する CodeArtifact」を参照してください。

npm CLI を使用して npm パッケージをインストールします。例えば、一般的な npm パッケージ lodash をインストールするには、以下のコマンドを使用します。
```
npm install lodash
```
list-packages コマンドを使用して、my-repo リポジトリでインストールしたばかりのパッケージを表示します。

注記
npm install インストールコマンドが完了してからリポジトリに表示するまでの間に遅延が生じる場合があります。パブリックリポジトリからパッケージを取得するときの一般的なレイテンシーの詳細については、「外部接続のレイテンシー」を参照してください。
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
JSON 形式のデータが、インストールしたパッケージの形式と名前とともに出力に表示されます。
```
{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
    ]
}
```
これで、次の三つの CodeArtifact リソースが作成されました。
- ドメインmy-domain。
- my-domain に含まれるリポジトリ my-repo。このリポジトリには、利用可能な npm パッケージがあります。
- my-domain に含まれるリポジトリ npm-store。このリポジトリは、パブリック npm リポジトリへの外部接続を持ち、アップストリームリポジトリとして my-repo リポジトリに関連付けられています。

更なる AWS の課金を回避するには、このチュートリアルで使用したリソースを削除します。

注記

リポジトリを含むドメインは削除できないため、my-domain を削除する前に my-repo および npm-store を削除する必要があります。

npm-store リポジトリを削除するには、delete-repository コマンドを使用します。


aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo

JSON 形式のデータが、削除されたリポジトリの詳細とともに出力に表示されます。


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

npm-store リポジトリを削除するには、 delete-repository コマンドを使用します。


aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

JSON 形式のデータが、削除されたリポジトリの詳細とともに出力に表示されます。


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

my-domain リポジトリを削除するには、 delete-domain コマンドを使用します。


aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333

JSON 形式のデータが、削除されたドメインの詳細とともに出力に表示されます。


{
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Deleted",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

コンソールを使用した開始方法

リポジトリを操作する