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

# Konfigurasikan dan gunakan pip dengan CodeArtifact
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/pip/) adalah penginstal paket untuk paket Python. Untuk menggunakan pip untuk menginstal paket Python dari repositori Anda, CodeArtifact Anda harus terlebih dahulu mengkonfigurasi klien pip dengan CodeArtifact informasi repositori dan kredenal Anda.

pip hanya dapat digunakan untuk menginstal paket Python. [Untuk mempublikasikan paket Python, Anda dapat menggunakan benang.](https://pypi.org/project/twine/) Untuk informasi selengkapnya, lihat [Konfigurasikan dan gunakan benang dengan CodeArtifact](python-configure-twine.md).

## Konfigurasikan pip dengan perintah `login`
<a name="python-configure-pip-login"></a>

Pertama, konfigurasikan AWS kredensil Anda untuk digunakan dengan AWS CLI, seperti yang dijelaskan dalam. [Memulai dengan CodeArtifact](getting-started.md) Kemudian, gunakan CodeArtifact `login` perintah untuk mengambil kredensil dan mengkonfigurasinya`pip`.

**catatan**  
Jika Anda mengakses repositori di domain milik Anda, Anda tidak perlu menyertakan `--domain-owner`. Untuk informasi selengkapnya, lihat [Domain lintas akun](domain-overview.md#domain-overview-cross-account).

Untuk mengkonfigurasi pip, jalankan perintah berikut.

```
aws codeartifact login --tool pip --domain my_domain --domain-owner 111122223333 --repository my_repo
```

 `login`mengambil token otorisasi dari CodeArtifact menggunakan kredensil Anda AWS . `login`Perintah akan mengkonfigurasi `pip` untuk digunakan CodeArtifact dengan mengedit `~/.config/pip/pip.conf` untuk mengatur `index-url` ke repositori yang ditentukan oleh opsi. `--repository`

Periode otorisasi default setelah memanggil `login` adalah 12 jam, dan `login` harus dipanggil untuk menyegarkan token secara berkala. Untuk informasi selengkapnya tentang token otorisasi yang dibuat dengan perintah `login`, lihat [Token dibuat dengan perintah `login`](tokens-authentication.md#auth-token-login).

## Mengonfigurasi pip tanpa perintah login
<a name="python-configure-without-pip"></a>

 Jika Anda tidak dapat menggunakan perintah `login` untuk mengonfigurasi `pip`, Anda dapat menggunakan `pip config`.

1. Gunakan AWS CLI untuk mengambil token otorisasi baru.
**catatan**  
Jika Anda mengakses repositori di domain yang Anda miliki, Anda tidak perlu menyertakan `--domain-owner`. Untuk informasi selengkapnya, lihat [Domain lintas akun](domain-overview.md#domain-overview-cross-account).

   ```
   CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`
   ```

1. Gunakan `pip config` untuk mengatur URL CodeArtifact registri dan kredensialnya. Perintah berikut akan memperbarui file konfigurasi lingkungan saat ini saja. Untuk memperbarui file konfigurasi seluruh sistem, ganti `site` dengan. `global`

   ```
   pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/
   ```
**catatan**  
Untuk menggunakan endpoint dualstack, gunakan endpoint. `codeartifact.region.on.aws`

**penting**  
URL registri harus diakhiri dengan garis miring (/). Jika tidak, Anda tidak dapat terhubung ke repositori.

**Contoh file konfigurasi pip**

Berikut ini adalah contoh `pip.conf` file setelah mengatur URL CodeArtifact registri dan kredensialnya.

```
[global]
index-url = https://aws:eyJ2ZX...@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/pypi/my_repo/simple/
```

## Menjalankan pip
<a name="python-run-pip"></a>

Untuk menjalankan `pip` perintah, Anda harus mengkonfigurasi `pip` dengan CodeArtifact. Untuk informasi selengkapnya, lihat dokumentasi berikut.

1. Ikuti langkah-langkah di [Menyiapkan dengan AWS CodeArtifact](get-set-up-for-codeartifact.md) bagian untuk mengonfigurasi AWS akun, alat, dan izin Anda.

1. Konfigurasi `twine` dengan mengikuti langkah-langkah di [Konfigurasikan dan gunakan benang dengan CodeArtifact](python-configure-twine.md).

Dengan asumsi bahwa sebuah paket ada dalam repositori Anda atau salah satu repositori hulu, Anda dapat menginstalnya dengan `pip install`. Misalnya, gunakan perintah berikut untuk menginstal paket `requests`.

```
pip install requests
```

Gunakan `-i` opsi untuk sementara kembali ke menginstal paket dari [https://pypi.org alih-alih repositori](https://pypi.org) Anda CodeArtifact .

```
pip install -i https://pypi.org/simple requests
```