Menyiapkan lingkungan pengembangan Python

Tutorial ini menunjukkan cara menyiapkan komputer lokal untuk pengembangan Python, 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 Anda 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 sebelumnya.

Tujuan

  • Instal versi Python yang didukung yang kompatibel dengan Google Cloud.
  • Gunakan venv untuk mengisolasi dependensi.
  • Instal editor (opsional).
  • Instal Google Cloud CLI (opsional).
  • Instal Library Klien Cloud untuk Python (opsional).
  • Instal alat berguna lainnya.
  • Siapkan 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 bisa Anda dapatkan 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, dan pip juga diinstal.

    Untuk memverifikasi bahwa Python tersedia, jalankan perintah berikut:

    python3 --version
    

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

    Untuk memverifikasi bahwa pip3 tersedia, jalankan perintah berikut:

    pip3 --version
    

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

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

    python -m pip install --upgrade pip
    

    Homebrew menginstal Python versi 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 menampilkan versi dari C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Anda dapat mempelajari versi terbaru pip di Catatan Rilis pip.

Linux

Sebagian besar distribusi Linux menyertakan Python versi terbaru.

  1. Untuk menginstal Python di lingkungan Linux, instal paket yang sesuai untuk distribusi Anda. Untuk Debian dan Ubuntu, paket-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 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 Anda selalu menggunakan 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 di 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. Setel 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 venv lebih lanjut 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 mengintegrasikan 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 serangkaian alat command line untuk Google Cloud. Cloud SDK 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.

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

Langkah berikutnya