本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 開始使用主控台
<a name="getting-started-console"></a>

 執行下列步驟，以使用 開始使用 CodeArtifact AWS 管理主控台。本指南使用 `npm`套件管理工具，如果您使用的是不同的套件管理工具，則需要修改下列部分步驟。

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start) 開啟 AWS CodeArtifact 主控台。如需詳細資訊，請參閱[使用 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.  選擇 **Next (下一步)**。

1.  在 **AWS 帳戶中**，選擇**此 AWS 帳戶**。

1.  在**網域名稱**中，輸入 **my-domain**。

1.  展開 **Additional configuration (其他組態)**。

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.  選擇 **Next (下一步)**。

1.  在**檢閱和建立**中，檢閱為您建立的 CodeArtifact。
   +  **套件流程**顯示 `my-domain`、 `my-repo`和 `npm-store` 的關聯性。
   +  **步驟 1：建立儲存庫**會顯示 `my-repo`和 的詳細資訊`npm-store`。
   +  **步驟 2：選取網域**會顯示有關 的詳細資訊`my-domain`。

    當您準備好時，請選擇**建立儲存庫**。

1.  在 **my-repo** 頁面上，選擇**檢視連線指示**，然後選擇 **npm**。

1.  使用此CodeArtifact `login`命令 AWS CLI ，執行設定 npm 用戶端下顯示的命令。 ** AWS CLI CodeArtifact **

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

   如需詳細資訊，請參閱 [搭配 CodeArtifact 設定和使用 npm](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**，選擇**刪除**，然後依照步驟刪除網域。