Menyimpan paket Python di Artifact Registry
Panduan memulai ini menunjukkan cara menyiapkan repositori Python Artifact Registry pribadi, mengupload paket, lalu menginstal paket.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Artifact Registry.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Artifact Registry.
Meluncurkan Cloud Shell
Dalam panduan memulai ini, Anda akan menggunakan Cloud Shell, yang merupakan lingkungan shell untuk mengelola resource yang dihosting di Google Cloud.
Cloud Shell telah diinstal dengan Google Cloud CLI dan Python. Gcloud CLI menyediakan antarmuka command line utama untuk Google Cloud.
Meluncurkan Cloud Shell:
Buka Konsol Google Cloud.
Di toolbar Konsol Google Cloud, klik Activate Cloud Shell:
Sesi Cloud Shell akan terbuka di dalam frame yang lebih rendah di konsol.
Anda menggunakan shell ini untuk menjalankan perintah gcloud
.
Instal paket yang diperlukan
Twine adalah alat untuk memublikasikan paket Python. Anda akan menggunakan Twine untuk mengunggah paket ke Artifact Registry.
Dalam panduan memulai ini, Anda dapat menggunakan penginstalan Python yang disertakan dengan Cloud Shell. Penginstalan default ini mencakup backend keyring Artifact Registry: untuk menangani autentikasi dengan Artifact Registry. Jika membuat lingkungan virtual atau menyiapkan Python di luar Cloud Shell, Anda harus menginstal backend keyring untuk autentikasi. Untuk mengetahui detailnya, lihat Mengautentikasi dengan keyring.
Untuk menginstal Twine, jalankan perintah:
pip install twine
Sekarang Anda siap untuk menyiapkan Artifact Registry.
Membuat repositori
Buat repositori untuk paket Anda.
Jalankan perintah berikut untuk membuat repositori paket Python baru di project saat ini bernama
quickstart-python-repo
di lokasius-central1
.gcloud artifacts repositories create quickstart-python-repo \ --repository-format=python \ --location=us-central1 \ --description="Python package repository"
Jalankan perintah berikut untuk memverifikasi bahwa repositori Anda telah dibuat:
gcloud artifacts repositories list
Untuk menyederhanakan perintah
gcloud
, tetapkan repositori default kequickstart-python-repo
dan lokasi default keus-central1
. Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintahgcloud
yang memerlukan repositori atau lokasi.Untuk menetapkan repositori, jalankan perintah:
gcloud config set artifacts/repository quickstart-python-repo
Untuk menetapkan lokasi, jalankan perintah:
gcloud config set artifacts/location us-central1
Untuk mengetahui informasi lebih lanjut tentang perintah ini, baca dokumentasi gcloud config set.
Mengonfigurasi autentikasi
Backend keyring Artifact Registry menemukan kredensial Anda menggunakan Kredensial Default Aplikasi (ADC), yaitu strategi yang mencari kredensial di lingkungan Anda.
Dalam panduan memulai ini, Anda akan:
- Buat kredensial pengguna untuk ADC. Dalam lingkungan produksi, Anda harus menggunakan akun layanan dan memberikan kredensial dengan variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALS
. - Sertakan URL repositori Artifact Registry dalam perintah
pip
dantwine
sehingga Anda tidak perlu mengonfigurasi pip dan Twine dengan URL repositori.
Untuk membuat kredensial untuk ADC, jalankan perintah berikut:
gcloud auth application-default login
Untuk mengetahui detail tentang metode autentikasi dan menambahkan repositori ke konfigurasi pip dan Twine, lihat Menyiapkan autentikasi ke repositori paket Python.
Mendapatkan paket contoh
Saat Anda mem-build project Python, file distribusi akan disimpan di subdirektori dist
di project Python Anda. Untuk menyederhanakan panduan memulai ini, Anda harus
mendownload file paket bawaan.
Buat folder project Python bernama
python-quickstart
.mkdir python-quickstart
Buat subdirektori bernama
dist
, lalu ubah ke direktorinya.mkdir python-quickstart/dist cd python-quickstart/dist
Download contoh paket Python yang digunakan dalam tutorial Panduan Pengguna untuk Pengemasan Python Mengemas Project Python.
pip download sampleproject
Perintah tersebut akan mendownload paket
sampleproject
dan dependensinya,peppercorn
.
Mengupload paket ke repositori
Gunakan Twine untuk mengupload paket ke repositori Anda.
Dari direktori
dist
, ubah ke direktoripython-quickstart
induk.cd ..
Upload paket ke repositori dari direktori
dist
Anda.python3 -m twine upload --repository-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/ dist/*
Saat Anda menjalankan perintah dengan
python3 -m
, Python akan menemukan benang dan menjalankan perintahnya. Jika perintahtwine
ada di jalur sistem, Anda dapat menjalankannya tanpapython3 -m
.
Twine mengupload sampleproject
dan peppercorn
ke repositori Anda.
Melihat paket di repositori
Untuk memverifikasi bahwa paket Anda telah ditambahkan, cantumkan paket di
repositori quickstart-python-repo
.
Jalankan perintah berikut:
gcloud artifacts packages list --repository=quickstart-python-repo
Untuk melihat versi paket, jalankan perintah berikut:
gcloud artifacts versions list --package=PACKAGE
Dengan PACKAGE adalah ID paket.
Menginstal paket
Jalankan perintah berikut untuk menginstal paket:
pip install --index-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/simple/ sampleproject
Pemecahan masalah
Secara default, alat seperti pip dan Twine tidak menampilkan pesan error mendetail.
Jika Anda mengalami error, jalankan kembali perintah dengan flag --verbose
untuk
mendapatkan output yang lebih mendetail. Lihat
Pemecahan masalah untuk paket Python untuk informasi selengkapnya.
Pembersihan
Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
Sebelum menghapus repositori, pastikan paket apa pun yang ingin Anda simpan tersedia di lokasi lain.
Untuk menghapus repositori:
Untuk menghapus repositori
quickstart-python-repo
, jalankan perintah berikut:gcloud artifacts repositories delete quickstart-python-repo
Jika Anda ingin menghapus repositori default dan setelan lokasi yang Anda konfigurasikan untuk konfigurasi
gcloud
aktif, jalankan perintah berikut:gcloud config unset artifacts/repository gcloud config unset artifacts/location
Langkah selanjutnya
- Pelajari lebih lanjut cara mengonfigurasi autentikasi
- Pelajari cara mengelola repositori
- Pelajari cara mengelola paket
- Baca sumber daya kami tentang DevOps dan jelajahi program penelitian kami.