Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memulai menggunakan AWS CLI
<a name="getting-started-cli"></a>

 Jalankan langkah-langkah berikut untuk memulai CodeArtifact menggunakan AWS Command Line Interface (AWS CLI). Untuk informasi selengkapnya, lihat [Instal atau tingkatkan lalu konfigurasikan AWS CLI](get-set-up-install-cli.md). Panduan ini menggunakan manajer paket `npm`, jika Anda menggunakan manajer paket yang berbeda, Anda perlu memodifikasi beberapa langkah berikut.

1.  Gunakan AWS CLI untuk menjalankan **create-domain** perintah. 

   ```
   aws codeartifact create-domain --domain my-domain
   ```

    Data berformat JSON muncul dalam output dengan detail tentang domain baru Anda. 

   ```
   {
       "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
       }
   }
   ```

   Jika Anda menerima kesalahan`Could not connect to the endpoint URL`, pastikan bahwa Anda telah AWS CLI dikonfigurasi dan **nama wilayah Default Anda disetel ke Wilayah** yang sama tempat Anda membuat repositori, lihat [Mengonfigurasi Antarmuka Baris Perintah AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

1.  Gunakan perintah **create-repository** untuk membuat repositori di domain Anda.

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

    Data berformat JSON muncul dalam output dengan detail tentang repositori baru Anda. 

   ```
   {
       "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": []
       }
   }
   ```

1. Gunakan perintah **create-repository** untuk membuat repositori hulu untuk repositori `my-repo` Anda.

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

    Data berformat JSON muncul dalam output dengan detail tentang repositori baru Anda.

   ```
   {
       "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": []
       }
   }
   ```

1.  Gunakan perintah **associate-external-connection** untuk menambahkan koneksi eksternal ke repositori publik npm ke repositori `npm-store`. 

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

    Data berformat JSON muncul dalam output dengan detail tentang repositori dan koneksi eksternalnya yang baru.

   ```
   {
       "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"
               }
           ]
       }
   }
   ```

    Untuk informasi selengkapnya, lihat [Connect CodeArtifact repositori ke repositori publik](external-connection.md). 

1.  Gunakan perintah **update-repository** untuk mengaitkan repositori `npm-store` sebagai repositori hulu ke repositori `my-repo`. 

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

    Data berformat JSON muncul dalam output dengan detail tentang pembaruan repositori Anda, termasuk repositori hulu barunya.

   ```
   {
       "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": []
       }
   }
   ```

    Untuk informasi selengkapnya, lihat [Menambahkan atau menghapus repositori upstream ()AWS CLI](repo-upstream-add.md#repo-upstream-add-cli). 

1. Penggunaan perintah **login** untuk mengonfigurasi manajer paket npm Anda dengan repositori `my-repo`. 

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

   Anda akan menerima output yang mengonfirmasi Anda berhasil masuk.

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

    Untuk informasi selengkapnya, lihat [Konfigurasikan dan gunakan npm dengan CodeArtifact](npm-auth.md). 

1.  Gunakan CLI npm untuk menginstal paket npm. Misalnya, untuk menginstal paket npm populer `lodash`, gunakan perintah berikut. 

   ```
   npm install lodash
   ```

1.  Gunakan perintah **list-packages** untuk melihat paket yang baru saja Anda instal di repositori `my-repo`. 
**catatan**  
Mungkin ada penundaan antara ketika perintah `npm install` install selesai dan ketika paket terlihat di repositori Anda. Untuk detail tentang latensi tipikal saat mengambil paket dari repositori publik, lihat. [Latensi koneksi eksternal](external-connection-requesting-packages.md#external-connection-latency) 

   ```
   aws codeartifact list-packages --domain my-domain --repository my-repo
   ```

    Data berformat JSON muncul dalam output dengan format dan nama paket yang Anda instal. 

   ```
   {
       "packages": [
           {
               "format": "npm",
               "package": "lodash"
           }
       ]
   }
   ```

   Anda sekarang memiliki tiga CodeArtifact sumber daya: 
   +  Domain `my-domain`. 
   +  Repositori `my-repo` yang berada di `my-domain`. Repositori ini memiliki paket npm yang tersedia untuk itu. 
   +  Repositori `npm-store` yang berada di `my-domain`. Repositori ini memiliki koneksi eksternal ke repositori npm publik dan dikaitkan sebagai repositori hulu dengan repositori `my-repo`. 

1. Untuk menghindari AWS biaya lebih lanjut, hapus sumber daya yang Anda gunakan selama tutorial ini: 
**catatan**  
 Anda tidak dapat menghapus domain yang berisi repositori, sehingga Anda harus menghapus `my-repo` dan `npm-store` sebelum Anda menghapus `my-domain`. 

   1.  Gunakan perintah **delete-repository** untuk menghapus repositori `npm-store`. 

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

       Data berformat JSON muncul dalam output dengan detail mengenai repositori yang dihapus. 

      ```
      {
          "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": []
          }
      }
      ```

   1.  Gunakan perintah **delete-repository** untuk menghapus repositori `npm-store`. 

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

       Data berformat JSON muncul dalam output dengan detail mengenai repositori yang dihapus.

      ```
      {
          "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"
                  }
              ]
          }
      }
      ```

   1. Gunakan perintah **delete-domain** untuk menghapus repositori `my-domain`. 

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

       Data berformat JSON muncul dalam output dengan detail tentang domain yang dihapus.

      ```
      {
          "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
          }
      }
      ```