Mengonsumsi paket dari indeks paket Python (PyPI)

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts memungkinkan pengembang menggunakan satu umpan untuk menghosting paket mereka sendiri serta paket yang diinstal dari registri publik seperti PyPI.org. Saat sumber upstream diaktifkan, Azure Artifacts secara otomatis menyimpan salinan paket apa pun yang diinstal dari sumber hulu oleh kolaborator atau yang lebih tinggi. Artikel ini memandu Anda menyiapkan proyek Anda dan menggunakan baris perintah untuk menggunakan paket Python dari Indeks Paket Python (PyPI).

Prasyarat

Produk Persyaratan
Azure DevOps - Sebuah organisasi Azure DevOps .
- Proyek Azure DevOps.
- Unduh dan instal Python.

Membuat umpan baru dan menambahkan upstream publik

Jika Anda belum memiliki umpan, ikuti langkah-langkah di bawah ini untuk membuat umpan dan mengaktifkan sumber Upstream. Jika tidak, lewati ke langkah berikutnya untuk menambahkan PyPI sebagai sumber hulu.

  1. Masuk ke Azure DevOps, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, kemudian pilih Buat Umpan.

  3. Masukkan Nama deskriptif untuk umpan Anda dan atur Visibilitasnya. Tentukan Cakupan, lalu centang kotak Sumber upstream untuk menyertakan paket dari registri publik.

  4. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru dan mengaktifkan sumber hulu di Azure Artifacts.

Tambahkan PyPI upstream

Jika Anda mengaktifkan Sumber Upstream saat membuat umpan, PyPI seharusnya secara otomatis ditambahkan sebagai sumber hulu. Jika tidak, Anda dapat menambahkannya secara manual dengan mengikuti langkah-langkah berikut:

  1. Masuk ke Azure DevOps, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih ikon roda gigi untuk membuka Pengaturan Umpan.

  3. Pilih Sumber Upstream, lalu pilih Tambahkan Upstream.

  4. Pilih Sumber publik, lalu pilih PyPI (https://pypi.org/) dari daftar dropdown.

  5. Pilih Tambahkan, lalu pilih Simpan di sudut kanan atas untuk menerapkan perubahan Anda.

Mengautentikasi dengan umpan Anda

Pastikan Anda telah menginstal Python dari prasyarat, lalu ikuti langkah-langkah ini untuk menyambungkan ke umpan Anda:

  1. Jalankan perintah berikut untuk meningkatkan manajer paket Python Anda:

    python -m pip install --upgrade pip
    
  2. Jalankan perintah berikut untuk menginstal keyring Azure Artifacts:

    pip install keyring artifacts-keyring
    
  3. Buat token akses pribadi dengan kemasan>cakupan baca untuk mengautentikasi dengan Azure DevOps. Saat pertama kali menyambungkan ke Azure DevOps, Anda akan dimintai kredensial. Masukkan nilai apa pun untuk nama pengguna, dan gunakan PAT Anda sebagai kata sandi. Kredensial ini di-cache secara lokal dan digunakan kembali saat Berikutnya Anda mengautentikasi.

  4. Navigasi ke direktori proyek Anda, lalu buat lingkungan virtual:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>
    
  5. Di lingkungan virtual Anda, buat file pip.ini (Windows) atau file pip.conf (macOS/Linux), lalu tambahkan cuplikan berikut. Gantikan placeholder dengan nilai yang sesuai. Jangan menerapkan file ini ke repositori publik, karena berisi token akses pribadi Anda.

    • Umpan khusus proyek:

      [global]
      extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/pypi/simple/
      
    • Umpan cakupan organisasi:

      [global]
      extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/pypi/simple/
      

Menginstal paket dari PyPI

Setelah terautentikasi menggunakan umpan Anda, Anda dapat menginstal paket dari sumber hulu PyPI sebagaimana biasanya menggunakan pip. Paket apa pun yang Anda instal secara otomatis disimpan ke umpan Azure Artifacts Anda.

Dalam contoh ini, Anda akan menginstal permintaan, pustaka HTTP populer untuk Python.

Nota

Untuk menyimpan paket dari sumber upstream, Anda harus memiliki peran Feed dan Upstream Reader (Collaborator) atau yang lebih tinggi. Lihat mengelola izin untuk detail selengkapnya.

  1. Buka perintah dan navigasi ke direktori proyek Anda, lalu aktifkan lingkungan virtual Anda. Ganti tempat penampung dengan nama lingkungan virtual yang Anda buat sebelumnya:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate
    
  2. Jalankan perintah berikut untuk menginstal paket permintaan dari PyPI.

    pip install requests
    
  3. Setelah penginstalan selesai, Azure Artifacts menyimpan salinan paket ke umpan Anda. Navigasikan ke umpan Anda untuk memverifikasi bahwa paket tersedia, seperti yang ditunjukkan pada cuplikan layar berikut.

    Cuplikan layar memperlihatkan paket permintaan yang diinstal dari hulu PyPI.