Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan CodeArtifact
Dalam tutorial memulai ini, Anda gunakan CodeArtifact untuk membuat yang berikut:
+ Domain yang disebut `my-domain`.
+ Repositori yang disebut `my-repo` yang berada dalam `my-domain`.
+ Repositori yang disebut `npm-store` yang berada dalam `my-domain`. `npm-store` memiliki koneksi eksternal ke repositori publik npm. Koneksi ini digunakan untuk menyerap paket npm ke dalam repositori `my-repo`.
Sebelum memulai tutorial ini, kami sarankan Anda meninjau CodeArtifact [AWS CodeArtifact konsep](codeartifact-concepts.md).
**catatan**
Tutorial ini mengharuskan Anda untuk membuat sumber daya yang mungkin menimbulkan biaya untuk akun AWS Anda. Untuk informasi selengkapnya, lihat [harga CodeArtifact ](https://aws.amazon.com/codeartifact/pricing/).
**Topics**
+ [Prasyarat](#getting-started-prerequisites)
+ [Memulai menggunakan konsol](getting-started-console.md)
+ [Memulai menggunakan AWS CLI](getting-started-cli.md)
## Prasyarat
Anda dapat menyelesaikan tutorial ini menggunakan Konsol Manajemen AWS atau AWS Command Line Interface (AWS CLI). Untuk mengikuti tutorial, Anda harus terlebih dahulu menyelesaikan prasyarat berikut:
+ Selesaikan langkah-langkah dalam [Menyiapkan dengan AWS CodeArtifact](get-set-up-for-codeartifact.md).
+ Instal CLI npm. Untuk informasi selengkapnya, lihat [Downloading and installing Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) dalam dokumentasi npm.
# Memulai menggunakan konsol
Jalankan langkah-langkah berikut untuk memulai CodeArtifact menggunakan Konsol Manajemen AWS. Panduan ini menggunakan manajer paket `npm`, jika Anda menggunakan manajer paket yang berbeda, Anda perlu memodifikasi beberapa langkah berikut.
1. Masuk ke Konsol Manajemen AWS dan buka AWS CodeArtifact konsol di [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start). Untuk informasi selengkapnya, lihat [Menyiapkan dengan AWS CodeArtifact](get-set-up-for-codeartifact.md).
1. Pilih **Buat repositori**.
1. Di **Repository name** (Nama repositori), masukkan **my-repo**.
1. (Opsional) Dalam **Repository Description** (Deskripsi Repositori), masukkan deskripsi opsional untuk repositori Anda.
1. Di **Public upstream repositories** (Repositori hulu publik), pilih **npm-store** untuk membuat repositori yang terhubung ke **npmjs** yang merupakan hulu dari repositori `my-repo` Anda.
CodeArtifact memberikan nama `npm-store` ke repositori ini untuk Anda. Semua paket yang tersedia di repositori hulu `npm-store` juga tersedia untuk repositori hilirnya, `my-repo`.
1. Pilih **Berikutnya**.
1. Di **AWS account** (Akun AWS), pilih **This AWS account** (Akun AWS ini).
1. Di **Domain name** (Nama domain), masukkan **my-domain**.
1. Perluas **Additional configuration** (Konfigurasi tambahan).
1. Anda harus menggunakan AWS KMS key (kunci KMS) untuk mengenkripsi semua aset di domain Anda. Anda dapat menggunakan Kunci yang dikelola AWS atau kunci KMS yang Anda kelola:
+ Pilih **kunci terkelola AWS** jika Anda ingin menggunakan default Kunci yang dikelola AWS.
+ Pilih **Customer managed key** jika Anda ingin menggunakan kunci KMS yang Anda kelola. Untuk menggunakan kunci KMS yang Anda kelola, di **ARN kunci terkelola Pelanggan**, cari dan pilih kunci KMS.
Untuk informasi selengkapnya, lihat [Kunci yang dikelola AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)dan [Kunci terkelola pelanggan](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) di *Panduan AWS Key Management Service Pengembang*.
1. Pilih **Berikutnya**.
1. Di **Tinjau dan buat**, tinjau CodeArtifact apa yang dibuat untuk Anda.
+ **Package flow** (Alur paket) menunjukkan bagaimana `my-domain`, `my-repo`, dan `npm-store` terkait.
+ **Langkah 1: Buat repositori** menampilkan detail tentang `my-repo` dan `npm-store`.
+ **Langkah 2: Pilih domain** menunjukkan detail tentang `my-domain`.
Saat Anda siap, pilih **Create repository** (Buat repositori).
1. Di halaman **my-repo**, pilih **View connection instructions** (Lihat petunjuk koneksi), lalu pilih **npm**.
1. Gunakan AWS CLI untuk menjalankan `login` perintah yang ditunjukkan di bawah **Konfigurasi klien npm Anda menggunakan AWS CLI CodeArtifact perintah ini**.
```
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
```
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).
Untuk informasi selengkapnya, silakan 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. Kembali ke CodeArtifact konsol. Jika repositori **my-repo** dibuka, segarkan halaman. Atau, di panel navigasi, pilih **Repository** (Repositori), lalu pilih **my-repo**.
Di bagian **Packages** (Paket), Anda akan melihat perpustakaan npm atau paket yang Anda instal. Anda dapat memilih nama paket untuk melihat versi dan statusnya. Anda dapat memilih versi terbarunya untuk melihat detail paket seperti dependensi, aset, dan lainnya.
**catatan**
Mungkin ada penundaan antara ketika Anda menginstal paket dan ketika diserap ke dalam repositori Anda.
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. Di panel navigasi, pilih **Repository** (Repositori).
1. Pilih **npm-store**, pilih **Delete** (Hapus), dan kemudian ikuti langkah-langkah untuk menghapus repositori.
1. Pilih **my-repo**, pilih **Delete** (Hapus), dan kemudian ikuti langkah-langkah untuk menghapus repositori.
1. Dari panel navigasi, pilih **Domains** (Domain).
1. Pilih **my-domain**, pilih **Delete** (Hapus), dan kemudian ikuti langkah-langkah untuk menghapus domain.
# Memulai menggunakan AWS CLI
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
}
}
```