Konfigurasikan dan gunakan pip dengan CodeArtifact

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. Untuk informasi selengkapnya, lihat Konfigurasikan dan gunakan benang dengan CodeArtifact.

Konfigurasikan pip dengan perintah login

Pertama, konfigurasikan AWS kredensil Anda untuk digunakan dengan AWS CLI, seperti yang dijelaskan dalam. Memulai dengan CodeArtifact Kemudian, gunakan CodeArtifact login perintah untuk mengambil kredensil dan mengkonfigurasinyapip.

catatan

Jika Anda mengakses repositori di domain milik Anda, Anda tidak perlu menyertakan --domain-owner. Untuk informasi selengkapnya, lihat Domain lintas akun.

Untuk mengkonfigurasi pip, jalankan perintah berikut.

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

loginmengambil token otorisasi dari CodeArtifact menggunakan kredensil Anda AWS . loginPerintah 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.

Mengonfigurasi pip tanpa perintah login

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.

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

2. 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

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 bagian untuk mengonfigurasi AWS akun, alat, dan izin Anda.

2. Konfigurasi twine dengan mengikuti langkah-langkah di Konfigurasikan dan gunakan benang dengan CodeArtifact.

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 Anda CodeArtifact .

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