Menentukan dependensi

Dependensi untuk aplikasi python dideklarasikan dalam file requirements.txt standar. Contoh:

Flask==MAJOR.MINOR.PATCH
google-cloud-storage

Ganti MAJOR, MINOR, dan PATCH dengan nomor versi Flask yang diinginkan.

Saat Anda men-deploy ke App Engine, dependensi yang ditentukan dalam file requirements.txt akan otomatis diinstal dengan aplikasi yang di-deploy. Anda dapat menggunakan paket Python yang kompatibel dengan Linux, termasuk paket yang memerlukan ekstensi C native.

Secara default, App Engine meng-cache dependensi untuk mengurangi waktu build. Untuk menginstal versi dependensi yang tidak disimpan dalam cache, gunakan perintah:

gcloud app deploy --no-cache

Dependensi pribadi dengan Artifact Registry

Jika perlu menghosting dependensi pribadi untuk aplikasi Python, Anda dapat menggunakan repositori Python Artifact Registry. Saat Anda men-deploy aplikasi, proses build akan otomatis menghasilkan kredensial Artifact Registry untuk akun layanan Cloud Build sehingga Anda tidak perlu membuat kredensial tambahan. Untuk menyertakan dependensi pribadi, tambahkan URL Artifact Registry dan paket yang relevan di file requirements.txt Anda.

Untuk menentukan beberapa repositori, gunakan repositori virtual Artifact Registry untuk mengontrol urutan yang digunakan pip untuk menelusuri repositori Anda dengan aman. Contoh:

--index-url REPOSITORY_URL
sampleproject
Flask==MAJOR.MINOR.PATCH
google-cloud-storage

Ganti REPOSITORY_URL dengan alamat registry, seperti:

https://REGION_ID-python.pkg.dev/PROJECT_ID/REPOSITORY_NAME/simple

Dependensi pribadi dengan repositori lain

Dependensi diinstal di lingkungan Cloud Build yang tidak memberikan akses ke kunci SSH. Paket yang dihosting di repositori yang memerlukan autentikasi berbasis SSH harus disalin ke direktori project Anda dan diupload bersama kode project Anda menggunakan pengelola paket pip.

Untuk menggunakan dependensi pribadi:

  1. Jalankan pip install -t lib my_module untuk menyalin dependensi ke folder lokal bernama lib.

  2. Tambahkan file __init__.py kosong ke direktori lib untuk menjadikannya modul.

  3. Impor modul di aplikasi Anda. Contoh:

    import lib.my_module

Menginstal dependensi secara lokal

Saat mengembangkan dan menguji aplikasi secara lokal, sebaiknya gunakan venv untuk mengisolasi dependensi aplikasi dari paket sistem Anda. Cara ini juga memastikan bahwa dependensi Anda akan memiliki versi yang sama di komputer lokal Anda dan aplikasi yang di-deploy.

Agar dapat menggunakan venv untuk menginstal dependensi, selesaikan langkah-langkah berikut:

Mac OS / Linux

  1. Buat lingkungan Python yang terisolasi: 
    python3 -m venv env
source env/bin/activate
  2. Jika Anda tidak berada dalam direktori yang berisi kode contoh, buka direktori yang berisi kode contoh hello_world. Kemudian instal dependensi: 
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

Windows

Gunakan PowerShell untuk menjalankan paket Python Anda.

  1. Temukan penginstalan PowerShell Anda.
  2. Klik kanan pintasan PowerShell dan mulai sebagai administrator.
  3. Buat lingkungan Python yang terisolasi. 
    python -m venv env
.\env\Scripts\activate
  4. Buka direktori project Anda lalu instal dependensi. Jika Anda tidak berada dalam direktori yang berisi kode contoh, buka direktori yang berisi kode contoh hello_world. Kemudian, instal dependensi: 
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

Hal ini memastikan bahwa saat Anda menjalankan aplikasi secara lokal, hanya dependensi yang dideklarasikan dalam file requirements.txt yang akan tersedia. Dependensi yang diinstal oleh App Engine selama deployment didasarkan pada konten file requirements.txt, bukan konten direktori env/.

Anda.

Menginstal framework web

Anda harus menggunakan framework web agar aplikasi Anda dapat melayani permintaan web. Anda dapat menggunakan framework web Python apa pun termasuk yang berikut ini:

Untuk menggunakan framework web tertentu, cukup tambahkan ke requirements.txt:

Flask==MAJOR.MINOR.PATCH

Menginstal server WSGI

Beberapa kerangka kerja web memiliki server WSGI bawaan; namun, beberapa dari mereka cocok untuk melayani lalu lintas produksi. Sebagian besar aplikasi web menggunakan server WSGI mandiri seperti Gunicorn, uWSGI atau Waitress. Untuk informasi selengkapnya tentang cara menginstal, mengonfigurasi, dan menggunakan server WSGI, lihat startup aplikasi.

Menginstal Library Klien Cloud

Library Klien Cloud untuk Python adalah library klien untuk mengakses layanan Google Cloud yang secara signifikan mengurangi kode boilerplate yang harus Anda tulis. Library ini menyediakan abstraksi API tingkat tinggi agar lebih mudah dipahami. Library ini menggunakan idiom Python, berfungsi baik dengan library Python standar, dan terintegrasi lebih baik dengan codebase Anda.

Misalnya, Anda dapat menginstal library klien Python yang sesuai untuk Datastore atau Cloud Storage untuk mengintegrasikan layanan tersebut dengan aplikasi Anda.

Untuk menginstal library klien Python untuk Cloud Datastore:

  1. Instal library klien secara lokal menggunakan pip:

    pip install google-cloud-datastore

  2. Menyiapkan autentikasi. Anda dapat mengonfigurasi Library Klien Cloud untuk Python unuk menangani autentikasi secara otomatis. Library klien juga dapat secara otomatis menangani autentikasi untuk Anda secara lokal menggunakan Google Cloud CLI.

    gcloud auth login

  3. Gunakan referensi Library Klien Datastore untuk menerapkan dukungan untuk layanan Cloud Datastore di aplikasi Anda.

Untuk melihat daftar lengkap semua Library Klien Cloud untuk Python untuk layanan Google Cloud yang didukung, lihat Library API & Python.