Mulai menggunakan paket Python di Azure Artifacts

  • Artikel
  • 2 menit untuk membaca

| Layanan Azure DevOps Azure DevOps Server 2020 | | Azure DevOps Server 2019 TFS 2018

Panduan ini akan memandu Anda menggunakan Azure Artifacts untuk menerbitkan dan menggunakan paket Python ke dan dari umpan Anda.

Membuat umpan

  1. Pilih Artefak, lalu pilih Buat Umpan.

    Create a feed button

  2. Beri nama umpan Anda dan pilih visibilitasnya (siapa yang dapat melihat paket dalam umpan ini), sumber upstream, dan pengaturan cakupan (cakupan proyek atau cakupan organisasi).

    New feed dialog box

  3. Pilih Buat, jika sudah selesai.

Azure Artifacts diinstal secara default untuk pelanggan TFS 2017. Anda harus meningkatkan ke TFS 2017 untuk menggunakan Artefak Azure. Jika ini pertama kalinya menggunakan umpan Anda, Anda mungkin diminta untuk menetapkan lisensi

  1. Buka Rilis Build & dan pilih Paket.

    Go to Azure Artifacts TFS

  2. Pilih + Umpan baru.

    New feed button TFS

  3. Beri umpan Anda Nama, Deskripsi, dan siapkan siapa yang dapat membaca, siapa yang dapat berkontribusi dan jika Anda ingin Menyertakan paket eksternal.

    New feed dialog box TFS

  4. Pilih Buat, jika sudah selesai.

Koneksi ke umpan

Ada dua cara utama untuk menyambungkan ke umpan untuk menerbitkan atau menggunakan paket Python Anda:

  1. Instal dan gunakan paket artefak-keyring , yang akan secara otomatis menyiapkan autentikasi untuk Anda.
  2. Siapkan kredensial secara manual untuk pip.ini/pip.conf untuk pendorongan, dan .pypirc untuk penarikan dengan token akses pribadi (PAT).

Catatan

artifacts-keyring tidak didukung pada versi Ubuntu yang lebih baru.

Gunakan artifacts-keyring untuk menyiapkan autentikasi

Paket artefak-keyring memungkinkan Anda menyiapkan autentikasi untuk menerbitkan dan menggunakan paket Python Anda ke dan dari umpan Anda. Baik pip maupun twine menggunakan pustaka keyring Python untuk menemukan kredensial.

Penting

Anda harus memiliki pip 19.2 dan twine 1.13.0 atau lebih tinggi untuk menggunakan artefak-keyring.

  1. Di jendela prompt perintah yang ditinggikan, jalankan perintah berikut untuk menginstal paket artefak-keyring:

    pip install artifacts-keyring

  2. Instal paket dari umpan Anda.

    pip install <package-name> --index-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple

  3. Terbitkan paket ke umpan Anda.

    twine upload --repository-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/upload

Catatan

Paket artefak-keyring berlapis di atas Penyedia Kredensial Artefak Azure kami. Untuk opsi konfigurasi yang lebih canggih, lihat repositori artifacts-credprovider .

Mengonfigurasi autentikasi secara manual

  1. Buat token akses Pribadi dengan cakupan PackagingRead> untuk mengautentikasi ke dalam Azure DevOps.

  2. Dari dalam umpan Anda, pilih Koneksi untuk umpan.

    Connect to feed button

  3. Pilih pip di bawah header Python .

    Select pip to connect to your feed

  4. Pastikan Anda telah menginstal versi terbaru keyring Azure Artifacts dari menu "Dapatkan alat".

    Catatan

    Paket artefak-keyring menyediakan autentikasi untuk menerbitkan dan menggunakan paket Python ke dan dari umpan Azure Artifacts.

  5. Buat virtualenv, jika Anda belum memilikinya.

  6. Tambahkan file pip.ini (Windows) atau pip.conf (Mac/Linux) ke virtualenv Anda. Pastikan Anda tidak memeriksa token akses pribadi Anda ke repositori publik.

    [global]
extra-index-url=https://<your-feed-name>:<your-PAT-key>@pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple/

  7. Jalankan perintah berikut untuk menginstal paket

    pip install <package-name>

Saat Anda tersambung ke Azure DevOps untuk pertama kalinya, Anda akan dimintai kredensial. Masukkan nama pengguna Anda (string apa pun) dan token akses pribadi Anda di bidang yang sesuai. Kredensial akan di-cache secara lokal dan digunakan untuk memasukkan Anda secara otomatis saat berikutnya Anda menggunakan layanan.

Catatan

Jika Anda ingin menyiapkan autentikasi di Azure Pipelines, gunakan tugas Python Pip Authenticate untuk menginstal paket, atau tugas Autentikasi Upload Python Twine untuk mendorong paket.