本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 通过控制台开始使用
<a name="getting-started-console"></a>

 使用 AWS 管理控制台，按照以下步骤来开始使用 CodeArtifact。本指南使用 `npm` 程序包管理器，如果您使用的是不同的程序包管理器，则需要修改以下某些步骤。

1. 通过以下网址登录 AWS 管理控制台 并打开 AWS CodeArtifact 控制台：[https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start)。有关更多信息，请参阅 [使用进行设置 AWS CodeArtifact](get-set-up-for-codeartifact.md)。

1.  选择**创建存储库**。

1.  在**存储库名称**中，输入 **my-repo**。

1.  （可选）在**存储库描述**中，输入存储库的可选描述。

1. 在**公有上游存储库**中，选择 **npm-store** 来创建一个连接到 **npmjs** 的存储库，该存储库是 `my-repo` 存储库的上游存储库。

   CodeArtifact 会为这个存储库分配名称 `npm-store`。上游存储库 `npm-store` 中提供的所有可用程序包也可用于其下游存储库 `my-repo`。

1.  选择**下一步**。

1.  在 **AWS 账户**中，选择**此 AWS 账户**。

1.  在**域名**中，输入 **my-domain**。

1.  展开**其他配置**。

1.  您必须使用 AWS KMS key（KMS 密钥）来加密域中的所有资产。您可以使用 AWS 托管式密钥 或自己管理的 KMS 密钥：
   +  如果您想使用默认 AWS 托管式密钥，请选择 **AWS 托管式密钥**。
   +  如果您想使用自己管理的 KMS 密钥，请选择**客户管理的密钥**。要使用自己管理的 KMS 密钥，请在**客户管理的密钥 ARN** 中搜索并选择 KMS 密钥。

    有关更多信息，请参阅**《AWS Key Management Service 开发人员指南》中的 [AWS 托管式密钥](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) 和[客户管理的密钥](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk)。

1.  选择**下一步**。

1.  在**查看并创建**中，查看 CodeArtifact 正在为您创建的内容。
   +  **程序包流**显示了 `my-domain`、`my-repo` 和 `npm-store` 之间如何相互关联。
   +  **步骤 1：创建存储库**显示了有关 `my-repo` 和 `npm-store` 的详细信息。
   +  **步骤 2: 选择域**显示有关 `my-domain` 的详细信息。

    当您准备好后，选择**创建存储库**。

1.  在 **my-repo** 页面上，选择**查看连接说明**，然后选择 **npm**。

1.  使用 AWS CLI 来运行**使用此 AWS CLI CodeArtifact 命令配置 npm 客户端**下所示的 `login` 命令。

   ```
   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
   ```

   如果您收到错误消息 `Could not connect to the endpoint URL`，请确保 AWS CLI 已配置完毕且您的**默认区域名称**设置为在创建存储库时使用的相同区域，请参阅[配置 AWS 命令行界面](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)。

   有关更多信息，请参阅 [配置并使用 npm CodeArtifact](npm-auth.md)。

1.  使用 npm CLI 来安装 npm 程序包。例如，要安装常见的 npm 程序包 `lodash`，请使用以下命令。

   ```
   npm install lodash
   ```

1.  返回 CodeArtifact 控制台。如果您的 **my-repo** 存储库已打开，请刷新页面。否则，在导航窗格中，选择**存储库**，然后选择 **my-repo**。

    在**程序包**下面，您应该会看到您安装的 npm 库或程序包。您可以选择程序包的名称来查看其版本和状态。您可以选择其最新版本来查看程序包的详细信息，例如依赖项、资产等。
**注意**  
 从安装程序包到将其提取到存储库之间可能会有一段延迟。

1.  为避免产生进一步的 AWS 费用，请删除您在本教程中使用的资源：
**注意**  
您无法删除包含存储库的域，因此必须先删除 `my-repo` 和 `npm-store`，然后才能删除 `my-domain`。

   1.  在导航窗格中，选择**存储库**。

   1.  选择 **npm-store**，选择**删除**，然后按照步骤来删除存储库。

   1.  选择 **my-repo**，选择**删除**，然后按照步骤来删除存储库。

   1.  在导航窗格中，选择**域**。

   1.  选择 **my-domain**，选择**删除**，然后按照步骤删除域。