Bagikan melalui

Menggunakan paket dari indeks paket Python (PyPI)

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dengan menggunakan Azure Artifacts, pengembang dapat menerbitkan dan menggunakan paket dari umpan Azure Artifacts dan registri eksternal seperti pypi.org. Artikel ini akan memandu Anda menyiapkan proyek Anda dan menggunakan baris perintah untuk mengonsumsi paket Python secara efisien dari PyPI.

Dalam artikel ini, Anda akan mempelajari cara:

  • Aktifkan sumber upstram untuk umpan Anda
  • Menambahkan PyPI sebagai sumber upstream
  • Menyiapkan proyek Anda
  • Menginstal paket dari indeks paket Python

Prasyarat

  • Organisasi Azure DevOps dan proyek. Buat organisasi atau proyek jika Anda belum melakukannya.

  • Umpan Artefak Azure.

  • Unduh Python.

Mengaktifkan sumber upstram

Jika Anda belum membuat umpan, ikuti langkah-langkah di bawah ini untuk membuat umpan baru. Pastikan untuk mencentang kotak untuk sumber upstram guna mengaktifkan sumber upstram. Jika Anda sudah memiliki umpan, lewati ke langkah berikutnya untuk menambahkan PyPI sebagai sumber hulu.

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

  2. Pilih Artefak, lalu pilih Buat Umpan untuk membuat umpan baru.

  3. Masukkan Nama deskriptif untuk umpan Anda dan tentukan Visibilitasnya(menunjukkan siapa yang dapat melihat paket dalam umpan). Tentukan Cakupan umpan Anda, lalu centang kotak centang Sumber upstream untuk menyertakan paket dari registri publik.

  4. Pilih Buat setelah selesai.

    A screenshot showing how to create a need feed.

Menambahkan upstream PyPI

Jika Anda memilih kotak centang sumber upstream selama pembuatan umpan Anda, PyPI seharusnya disertakan secara otomatis sebagai sumber upstram. Jika tidak, Anda dapat menambahkannya secara manual dengan mengikuti langkah-langkah berikut:

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

  2. Pilih Artefak, lalu pilih ikongear icongigi untuk menavigasi ke Umpan Pengaturan.

  3. Pilih Sumber upstram, lalu pilih Tambahkan Upstream untuk menambahkan sumber hulu baru.

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

  5. Pilih Simpan setelah selesai, lalu pilih Simpan sekali lagi dari sudut kanan atas untuk menyimpan perubahan Anda.

Mengautentikasi dengan umpan Anda

  1. Pastikan Anda telah mengunduh Python, lalu 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 Cakupan Baca Kemasan>untuk mengautentikasi dengan Azure DevOps. Saat pertama kali tersambung ke Azure DevOps, Anda harus memasukkan kredensial saat diminta. Berikan nama pengguna Anda (string apa pun) dan token akses pribadi Anda di bidang yang ditunjuk. Kredensial ini akan di-cache secara lokal dan otomatis digunakan untuk memasukkan Anda di lain waktu saat Anda menggunakan layanan.

  4. Navigasi ke folder proyek Anda, lalu jalankan perintah berikut untuk membuat lingkungan virtual baru:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>

  5. Buat file pip.ini baru (Windows) atau file pip.conf (Mac/Linux) di lingkungan virtual Anda, lalu tempelkan cuplikan berikut ke dalam file Anda. Pastikan Anda mengganti tempat penampung dengan informasi yang sesuai, dan berhati-hatilah untuk tidak menerapkan file ini ke repositori publik karena berisi token akses pribadi Anda.

    • Umpan cakupan 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

Sekarang setelah kami mengonfigurasi proyek kami untuk mengautentikasi dengan umpan kami, kami dapat mulai menginstal paket dari hulu PyPI. Dalam contoh ini, kita akan menginstal Flask:

  1. Di jendela prompt perintah, navigasikan ke folder proyek Anda dan jalankan perintah berikut untuk mengaktifkan lingkungan virtual Anda. Ganti tempat penampung dengan nama lingkungan virtual yang Anda buat sebelumnya:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate.ps1

  2. Jalankan perintah berikut untuk memeriksa paket yang diinstal di lingkungan virtual Anda:

    pip list

  3. Jalankan perintah berikut untuk menginstal Flask.

    pip install -U Flask

  4. Setelah paket Anda diinstal, Azure Artifacts akan menyimpan salinan paket ini ke umpan Anda. Paket Anda harus tersedia di umpan Anda seperti yang ditunjukkan pada cuplikan layar di bawah ini.

    A screenshot showing packages installed from PyPI upstream.