Membuat aplikasi Python di lingkungan fleksibel App Engine

ID region

REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.

Pelajari ID region lebih lanjut.

Panduan memulai ini menunjukkan cara membuat dan men-deploy aplikasi yang menampilkan pesan singkat. Aplikasi contoh menggunakan Python 3 versi terbaru. Anda dapat menggunakan contoh kode yang sama untuk runtime Python versi 3.8 dan yang lebih baru, dengan menentukan versi dalam file app.yaml Anda.

Contoh kode untuk Python versi 3.7 dan yang lebih lama tersedia di GitHub.

Sebelum memulai

  1. 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.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan Cloud Build API.

    Mengaktifkan API

  5. Menginstal Google Cloud CLI.
  6. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init
  7. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  8. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  9. Aktifkan Cloud Build API.

    Mengaktifkan API

  10. Menginstal Google Cloud CLI.
  11. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init

Prasyarat tambahan

  1. Lakukan inisialisasi aplikasi App Engine dengan project Anda, lalu pilih region:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Saat diminta, pilih region tempat Anda ingin menemukan aplikasi App Engine.

  2. Instal prasyarat berikut:

    • Jalankan perintah berikut untuk menginstal komponen gcloud yang meliputi ekstensi App Engine untuk Python:

      gcloud components install app-engine-python
      

  3. Siapkan lingkungan Anda untuk pengembangan Python. Sebaiknya Anda menginstal Python versi terbaru, pip, dan alat terkait lainnya di sistem Anda. Untuk mendapatkan petunjuk, lihat Panduan Penyiapan Lingkungan Pengembangan Python.

Lokasi App Engine

App Engine bersifat regional. Artinya, infrastruktur yang menjalankan aplikasi Anda terletak di region tertentu, dan Google mengelolanya sehingga aplikasi Anda tersedia secara redundan di semua zona dalam region tersebut.

Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat aplikasi dijalankan. Umumnya, Anda dapat memilih region yang paling dekat dengan pengguna aplikasi Anda, tetapi Anda harus mempertimbangkan lokasi tempat App Engine tersedia serta lokasi dari produk dan layanan Google Cloud lainnya yang digunakan aplikasi Anda. Penggunaan layanan di beberapa lokasi dapat memengaruhi latensi dan pricing aplikasi.

Anda tidak dapat mengubah region aplikasi setelah menyetelnya.

Jika sudah membuat aplikasi App Engine, Anda dapat melihat region-nya dengan melakukan salah satu tindakan berikut:

Panduan memulai ini mendemonstrasikan aplikasi Python 3 terbaru yang ditulis dengan framework web Flask yang dapat di-deploy ke App Engine. Meskipun contoh ini menggunakan Flask, Anda dapat menggunakan framework web apa pun yang memenuhi persyaratan di atas. Framework alternatif mencakup Django, Pyramid, Bottle, dan web.py.

Men-download aplikasi Halo Dunia

Kami telah membuat aplikasi Halo Dunia sederhana untuk App Engine agar Anda dapat dengan cepat membiasakan diri dalam men-deploy aplikasi ke Google Cloud.

  1. Buat clone repositori aplikasi contoh Halo Dunia ke komputer lokal Anda.

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
    

    Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

  2. Ubah ke direktori yang berisi kode contoh.

       cd python-docs-samples/appengine/flexible/hello_world
    

Menjalankan Halo Dunia di komputer lokal

Untuk menjalankan aplikasi Halo Dunia di komputer lokal:

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
  3. Jalankan aplikasi:
    python main.py
  4. Di browser web, masukkan alamat berikut:
    http://localhost:8080

    Jika Anda menggunakan Cloud Shell, di toolbar, klik Web Preview dan pilih Preview on port 8080.

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
  5. Jalankan aplikasi:
    python main.py
  6. Di browser web, masukkan alamat berikut:
    http://localhost:8080

Pesan Halo Dunia dari aplikasi contoh akan ditampilkan di halaman. Di jendela terminal, tekan Ctrl+C untuk keluar dari server web.

Men-deploy dan menjalankan Halo Dunia di App Engine

Untuk men-deploy aplikasi Anda ke lingkungan fleksibel App Engine:

  1. Deploy aplikasi Halo Dunia dengan menjalankan perintah berikut dari direktori hello_world:

    gcloud app deploy

    Pelajari flag opsional.

    Flag perintah gcloud umum

    • Sertakan flag --version untuk menentukan ID yang secara unik mengidentifikasi versi aplikasi Anda. Jika tidak, ID akan dibuatkan untuk Anda. Contoh: --version [YOUR_VERSION_ID]
    • Sertakan flag --project untuk menentukan project ID Google Cloud alternatif dengan yang Anda inisialisasi sebagai default di alat gcloud. Contoh: --project [YOUR_PROJECT_ID]

    Contoh:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    Untuk mempelajari lebih lanjut cara men-deploy aplikasi dari command line, lihat bagian Menguji dan Men-deploy Aplikasi. Untuk daftar semua flag perintah, lihat referensi gcloud app deploy.

  2. Luncurkan browser Anda untuk melihat aplikasi di https://PROJECT_ID.REGION_ID.r.appspot.com

    gcloud app browse
    dengan PROJECT_ID mewakili ID project Google Cloud Anda.

Kali ini, halaman yang menampilkan pesan Halo Dunia dikirim oleh server web yang berjalan di instance App Engine.

Selamat! Anda telah men-deploy aplikasi App Engine pertama Anda ke lingkungan fleksibel App Engine.

Jika Anda mengalami error saat men-deploy aplikasi, lihat tips pemecahan masalah.

Lihat bagian berikut untuk mengetahui informasi tentang pembersihan serta link ke kemungkinan langkah berikutnya yang dapat Anda lakukan.

Pembersihan

Agar tidak menimbulkan biaya, Anda dapat menghapus project Google Cloud untuk menghentikan penagihan semua resource yang digunakan dalam project tersebut.

  1. Di konsol Google Cloud, buka halaman Manage resource.

    Buka Manage resource

  2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya

Mempelajari seluruh platform

Setelah mengetahui cara mengembangkan dan men-deploy aplikasi App Engine, Anda dapat menjelajahi bagian Google Cloud lainnya. Anda telah menginstal Google Cloud CLI yang menyediakan alat untuk berinteraksi dengan produk seperti Cloud SQL, Cloud Storage, Firestore, dan lainnya.

Mempelajari lingkungan fleksibel App Engine

Berikut beberapa topik yang dapat membantu Anda melanjutkan pembelajaran tentang App Engine:

Ulasan kode Halo Dunia

Halo Dunia adalah aplikasi App Engine paling sederhana, karena hanya berisi satu layanan, hanya memiliki satu versi, dan semua kode berada dalam direktori utama aplikasi. Bagian ini menjelaskan setiap file aplikasi secara mendetail.

main.py

Aplikasi Halo Dunia adalah aplikasi Flask dasar dengan satu file.

from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello() -> str:
    """Return a friendly HTTP greeting.

    Returns:
        A string with the words 'Hello World!'.
    """
    return "Hello World!"

if __name__ == "__main__":
    # This is used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app.
    app.run(host="127.0.0.1", port=8080, debug=True)

app.yaml

File app.yaml mendeskripsikan konfigurasi berikut untuk aplikasi Anda:

  • Menetapkan env: flex, yang menunjukkan bahwa aplikasi Anda menggunakan lingkungan fleksibel App Engine.
  • Menentukan runtime yang digunakan oleh aplikasi. Jika Anda mengecualikan setelan runtime_version, App Engine akan menggunakan versi Python terbaru sebagai versi default untuk aplikasi Anda.

  • entrypoint memberi tahu App Engine cara memulai aplikasi. Aplikasi ini menggunakan gunicorn untuk menyalurkan aplikasi Python sebagai alternatif untuk server pengembangan Flask (digunakan saat berjalan secara lokal). Variabel $PORT ditetapkan oleh App Engine saat memulai aplikasi. Untuk mengetahui informasi selengkapnya tentang entrypoint, lihat Memulai aplikasi.

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
  operating_system: ubuntu22

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

requirements.txt

requirements.txt dan pengelola paket Python pip mendeklarasikan dan menginstal dependensi aplikasi. Halo Dunia memerlukan Flask, framework web, dan Gunicorn, server WSGI.

Flask==3.0.0; python_version > '3.6'
Flask==2.3.3; python_version < '3.7'
Werkzeug==3.0.1; python_version > '3.6'
Werkzeug==2.3.7; python_version < '3.7'
gunicorn==22.0.0

requirements.txt menentukan library yang akan diinstal secara lokal maupun saat men-deploy ke App Engine.