Menerbitkan dan mengunduh paket Python dengan Azure Artifacts

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

Dengan menggunakan Azure Artifacts, Anda dapat menerbitkan dan mengunduh paket dari umpan dan registri publik seperti PyPi. Mulai cepat ini memandu Anda membuat umpan, mengonfigurasi proyek Anda, dan mengelola paket Python di umpan Azure Artifacts Anda.

Prasyarat

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

Dapatkan kode

1. Jika Anda tidak memiliki proyek Python Anda sendiri, Anda dapat menggunakan contoh proyek Python berikut. Jika tidak, Anda dapat melompat ke bagian berikutnya:

   https://github.com/Azure-Samples/azure-stack-hub-flask-hello-world
   

2. Untuk membangun distribusi roda dan sumber Anda, jalankan perintah berikut di direktori proyek Anda:

   pip install --upgrade build
   python -m build
   

3. Jika proyek Python Anda memiliki file setup.py , Anda juga dapat membuat paket menggunakan:

   python setup.py sdist bdist_wheel
   

Membuat umpan

1. Masuk ke organisasi Azure DevOps Anda dan buka proyek Anda.

2. Pilih Artifacts, lalu pilih Buat Feed.

3. Berikan Nama untuk umpan Anda, pilih opsi Visibilitas yang menentukan siapa yang dapat melihat paket Anda, centang Sertakan paket dari sumber publik umum jika Anda ingin menyertakan paket dari sumber seperti nuget.org atau npmjs.com, dan untuk Cakupan, putuskan apakah umpan harus dicakup ke proyek Anda atau seluruh organisasi.

4. Pilih Buat setelah selesai.

   

Nota

Secara default, Layanan Build untuk proyek (misalnya: projectName Build Service (orgName)) diberi peran Umpan dan Pembaca Upstream (Kolaborator) saat umpan baru dibuat.

Sambungkan ke umpan Anda

kembar

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

2. Pilih Artefak, pilih umpan Anda dari menu dropdown, lalu pilih Sambungkan ke umpan.

3. Di bawah bagian Python, pilih twine.

4. Jika ini adalah pertama kalinya Anda menggunakan Azure Artifacts dengan Twine, pilih Dapatkan alat dan ikuti instruksi untuk mengunduh Python serta memasang Twine dan keyring untuk artefak.

5. Buat file pypirc di direktori beranda Anda dan tempelkan cuplikan yang disediakan di bagian Penyiapan proyek . Sekarang, file akan terlihat seperti contoh ini:

   [distutils]
   Index-servers =
       FEED_NAME
   
   [FEED_NAME]
   Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
   

Nota

Jika file .pypirc Anda sudah menyertakan kredensial untuk indeks PyPI publik, sebaiknya hapus bagian tersebut [pypi] untuk menghindari penerbitan paket privat ke PyPI secara tidak sengaja.

Pip

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

2. Pilih Artefak, pilih umpan Anda dari menu dropdown, lalu pilih Sambungkan ke umpan.

3. Di bawah bagian Python , pilih pip.

4. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan pip, pilih Dapatkan alat dan ikuti instruksi untuk mengunduh Python, memperbarui pip, dan menginstal keyring.

5. Membuat lingkungan virtual.

6. Tambahkan file pip.ini (Windows) atau file pip.conf (Mac/Linux) ke lingkungan virtual Anda, dan tempelkan cuplikan yang disediakan ke dalamnya. File Anda harus menyerupai berikut ini:

   [global]
   index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
   

Rilis paket ke saluran Anda

1. Di direktori proyek Anda, jalankan perintah berikut untuk membuat distribusi sumber dan roda:

   python setup.py sdist bdist_wheel
   
   

2. Untuk menerbitkan paket Anda, gunakan perintah di bawah ini. Pastikan untuk menggunakan flag -r FEED_NAME untuk menghindari penerbitan ke PyPI tanpa sengaja.

   twine upload -r <FEED_NAME> dist/*
   

Menginstal paket dari umpan Anda

1. Untuk menginstal paket dari umpan Anda, jalankan perintah berikut di direktori proyek Anda:

   pip install
   

2. Untuk menginstal paket tertentu, ganti tempat penampung dengan nama paket dari umpan Anda:

   pip install <PACKAGE_NAME>
   

Konten terkait

• Menyiapkan sumber hulu

• Menggunakan paket dari indeks paket Python (PyPI)

• Menerbitkan paket Python dengan Azure Pipelines YAML/Classic