Menyiapkan lingkungan pengembangan Python

Tutorial ini menunjukkan cara menyiapkan komputer lokal untuk Python pengembangan, termasuk mengembangkan aplikasi Python yang berjalan di Google Cloud.

Jika Anda sudah menyiapkan lingkungan pengembangan, lihat Python dan Google Cloud untuk mendapatkan ringkasan cara menjalankan aplikasi Python di Google Cloud.

Tips: Jika ingin memulai dengan cepat, Cloud Shell Editor menyediakan dukungan IDE untuk siklus pengembangan penuh aplikasi Google Kubernetes Engine dan Cloud Run Cloud Shell Editor didasarkan pada Code OSS dan dilengkapi dengan alat Google Cloud CLI dan Cloud Code yang telah diinstal.

Tujuan

  • Menginstal versi Python yang didukung dan kompatibel dengan Google Cloud.
  • Menggunakan venv untuk mengisolasi dependensi.
  • Menginstal editor (opsional).
  • Menginstal Google Cloud CLI (opsional).
  • Menginstal Library Klien Cloud untuk Python (opsional).
  • Menginstal alat berguna lainnya.
  • Menyiapkan autentikasi (opsional).

Menginstal Python

Petunjuk penginstalan Python bervariasi menurut sistem operasi. Ikuti panduan untuk sistem operasi yang Anda jalankan di lingkungan pengembangan, macOS, Windows, atau Linux.

macOS

macOS menyertakan versi Python secara default dan menggunakannya untuk tujuannya sendiri. Untuk menghindari gangguan pada macOS, sebaiknya buat lingkungan pengembangan terpisah dan instal versi Python yang didukung untuk Google Cloud. Untuk menginstal Python, gunakan homebrew.

  1. Untuk menggunakan homebrew guna menginstal paket Python, Anda memerlukan compiler, yang dapat diperoleh dengan menginstal alat command line Xcode.

    xcode-select --install

  2. Instal homebrew dengan mengikuti petunjuk di halaman beranda homebrew, lalu gunakan homebrew untuk menginstal Python sebagai berikut:

    brew install pyenv
pyenv install PYTHON_VERSION

    Nomor versi Python harus dalam format x.y. Contoh:

    pyenv install 3.12

  3. Setelah penginstalan selesai, pastikan Python 3 tersedia sebagai python dan python3, serta pip juga diinstal.

    Untuk memverifikasi bahwa Python tersedia, jalankan perintah berikut:

    python3 --version

    Output akan menampilkan versi. Anda dapat mempelajari Python homebrew di halaman Homebrew Python Formulae, lalu memeriksa versi Anda.

    Untuk memverifikasi bahwa pip3 tersedia, jalankan perintah berikut:

    pip3 --version

    Jika diinstal, output akan menampilkan versi pip3. Untuk mengetahui informasi selengkapnya tentang versi pip3 terbaru, lihat Catatan Rilis pip.

    Jika perintah sebelumnya tidak menampilkan versi pip3, pastikan pip3 diinstal dengan benar. Jika pip3 diinstal tetapi tidak berfungsi, upgrade ke versi terbaru menggunakan perintah berikut:

    python -m pip install --upgrade pip

    Homebrew menginstal versi Python terbaru yang tersedia di platform Anda. Nomor versi dalam output mungkin berbeda dengan rilis resmi Python terbaru.

Windows

  1. Untuk menginstal Python di lingkungan Windows, download penginstal untuk versi Python yang Anda butuhkan dari situs Python. Untuk mengetahui informasi selengkapnya, lihat versi Python yang didukung untuk Google Cloud.

  2. Untuk mengakses versi Python Anda, gunakan peluncur Python untuk Windows.

    Untuk memulai versi Python yang Anda instal, jalankan perintah berikut:

    py

    Untuk memulai versi Python 3 yang Anda instal, jalankan perintah berikut:

    py -3

    Untuk memverifikasi versi pip yang tersedia, jalankan perintah berikut:

    py -m pip --version

    Output akan menampilkan versi dari C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Anda dapat mempelajari versi terbaru dari pip di Catatan Rilis pip.

Linux

Sebagian besar distribusi Linux menyertakan versi Python terbaru.

  1. Untuk menginstal Python di lingkungan Linux, instal paket yang sesuai untuk distribusi Anda. Untuk Debian dan Ubuntu, paket ini adalah python3, python3-dev, python3-venv, dan python3-pip,

    Instal paket ini menggunakan perintah berikut:

    sudo apt update
sudo apt install python3 python3-dev python3-venv python3-pip

  2. Setelah penginstalan selesai, pastikan Anda telah menginstal pip:

    pip3 --version

    Anda dapat mempelajari versi terbaru dari pip di Catatan Rilis pip.

Menggunakan venv untuk mengisolasi dependensi

venv adalah alat yang membuat lingkungan Python terisolasi. Lingkungan terisolasi ini dapat memiliki versi paket Python yang terpisah, sehingga Anda dapat mengisolasi dependensi satu project dari dependensi project lainnya. Sebaiknya selalu gunakan lingkungan virtual per project saat mengembangkan secara lokal dengan Python.

  1. Gunakan perintah venv untuk membuat salinan virtual dari seluruh penginstalan Python. Tutorial ini membuat salinan virtual dalam folder bernama env, tetapi Anda dapat menentukan nama apa pun untuk folder tersebut.

    macOS

    cd your-project
python -m venv env

    Windows

    cd your-project
py -m venv env

    Linux

    cd your-project
python3 -m venv env

  2. Tetapkan shell Anda untuk menggunakan jalur venv untuk Python dengan mengaktifkan lingkungan virtual:

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. Sekarang Anda dapat menginstal paket tanpa memengaruhi project lain atau penginstalan Python global Anda:

    pip install google-cloud-storage

    Jika ingin berhenti menggunakan lingkungan virtual dan kembali ke Python global, Anda dapat menonaktifkannya:

    deactivate

Anda dapat membaca lebih lanjut tentang venv di dokumen venv.

Menginstal editor

Untuk mengembangkan aplikasi Python, Anda memerlukan editor. Berikut beberapa editor yang lebih populer (tanpa urutan tertentu):

Menginstal Library Klien Cloud untuk Python

Library Klien Cloud untuk Python adalah cara developer Python berintegrasi dengan Google Cloud layanan seperti Datastore dan Cloud Storage. Untuk menginstal paket untuk setiap API seperti Cloud Storage, gunakan perintah yang mirip dengan berikut:

pip install --upgrade google-cloud-storage

Menginstal gcloud CLI

gcloud CLI adalah kumpulan alat command line untuk Google CloudAlat ini berisi gcloud dan bq, yang dapat Anda gunakan untuk mengakses Compute Engine, Cloud Storage, BigQuery, serta produk dan layanan lainnya dari command line. Anda dapat menjalankan alat ini secara interaktif atau dalam skrip otomatis.

Menyiapkan autentikasi

Untuk menggunakan library klien, Anda harus menyiapkan autentikasi terlebih dahulu.

Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

gcloud auth application-default login

Anda tidak perlu melakukannya jika menggunakan Cloud Shell.

Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan library klien.

Langkah berikutnya