Men-deploy dan menguji API

Halaman ini menjelaskan cara men-deploy API.

Sebelum memulai

Men-deploy API Anda ke produksi

Untuk men-deploy API:

  1. Tetapkan variabel lingkungan ENDPOINTS_GAE_SDK ke jalur folder App Engine SDK Anda: Path_to_Cloud_SDK/platform/google_appengine.

    Ganti Path_to_Cloud_SDK dengan output perintah berikut:

     gcloud info --format="value(installation.sdk_root)"
    
  2. Jalankan perintah berikut di direktori utama API:

     gcloud app deploy
    

    Tunggu beberapa saat sampai deployment berhasil, abaikan pesan peringatan. Setelah deployment selesai, pesan yang mirip dengan berikut akan ditampilkan:

    File upload done.
    Updating service [default]...done.
    
  3. Konfirmasi deployment yang berhasil dengan mengirimkan permintaan pengujian ke API, misalnya:

    curl --request POST \
       --header "Content-Type: application/json" \
       --data '{"content":"echo"}' \
       https://PROJECT_ID.appspot.com/_ah/api/echo/v1/echo?n=2
    

    Ganti PROJECT_ID dengan project ID Anda dan echo dengan nama API Anda.

    Hasilnya adalah:

    {
     "content": "echo echo"
    }
    

Jika Anda tidak mendapatkan respons yang berhasil, lihat Memecahkan masalah error respons.

Men-deploy ke beberapa versi aplikasi

Untuk informasi cara melakukan pembuatan versi API dan cara men-deploy ke versi, lihat Menangani pembuatan versi API

Menguji API secara lokal

Anda dapat menggunakan server pengembangan lokal App Engine untuk menguji API secara lokal. Untuk informasi lebih lanjut tentang server pengembangan lokal, lihat Menggunakan server pengembangan lokal.

Untuk menjalankan API secara lokal:

  1. Dari direktori utama project, mulai server pengembangan App Engine:

    dev_appserver.py YOUR_PROJECT_DIR
    
  2. Jalankan curl untuk membuat permintaan API, misalnya:

     curl --request POST \
        --header "Content-Type: application/json" \
        --data '{"message":"echo"}' \
        "${HOST}/_ah/api/echo/v1/echo?n=2"
    

Menambahkan pengelolaan API

Endpoints Frameworks menyediakan fitur pengelolaan API seperti:

Agar API dapat dikelola oleh Framework Endpoint, Anda harus membuat dan men-deploy dokumen OpenAPI yang mendeskripsikan API Anda, seperti yang dijelaskan dalam Menambahkan pengelolaan API.