Langkah 7: Deploy ke lingkungan Apigee

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Setelah menyelesaikan pengembangan dan pengujian lokal dengan Apigee di VS Code, Anda siap men-deploy API sebagai arsip ke Apigee lingkungan fleksibel App Engine. Pada langkah ini, Anda akan membuat lingkungan Apigee yang mendukung deployment arsip dan men-deploy arsip konfigurasi proxy API ke lingkungan Apigee.

  1. Ikuti langkah-langkah di Membuat lingkungan untuk melakukan hal berikut:
    1. Buat lingkungan dev baru di organisasi Apigee Anda, dengan mengaktifkan Arsip sebagai jenis deployment. Gunakan UI atau API.

      Contoh:

      Dialog lingkungan baru yang menampilkan setelan jenis deployment Arsipkan

    2. Lampirkan lingkungan ke instance runtime menggunakan Instances attachment API.

      Perintah ini memicu operasi yang berjalan lama. Pastikan lingkungan telah dilampirkan ke runtime sebelum melanjutkan.

    3. Buat grup lingkungan jika Anda belum memilikinya menggunakan Buat API grup lingkungan.

      Pastikan grup lingkungan telah dibuat sebelum melanjutkan. Anda dapat memeriksa status grup baru menggunakan seperti berikut ini: 

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

      Melampirkan lingkungan ke grup membuat proxy di lingkungan tersebut dapat dirutekan melalui nama {i>host<i} dalam grup. Hal ini memicu operasi yang berjalan lama dan dapat memerlukan waktu beberapa menit untuk diselesaikan. Sebaiknya tunggu satu atau dua menit sebelum melanjutkan ke langkah berikutnya. Sementara itu, Anda dapat memeriksa status operasi seperti sebelumnya.

  2. Deploy arsip konfigurasi proxy API Anda ke lingkungan Apigee.
    1. Pada tab Terminal di Apigee VS Code, buka direktori myapigeeworkspace. 
      cd myapigeeworkspace

      Saat Anda menjalankan ls, direktori seharusnya berisi folder src.

    2. Jalankan perintah berikut: 
      gcloud beta apigee archives deploy --environment=dev --labels=release=052021

      Berikut ini contoh responsnya: 

      Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
  3. Jalankan perintah berikut di tab Terminal untuk menguji API Anda: 
    curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME"

    Untuk informasi selengkapnya tentang variabel dalam contoh ini dan cara menyiapkan akses API, lihat Men-deploy contoh proxy.

    Pesan error berikut akan ditampilkan: 

    {"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

    Anda perlu membuat produk API yang menyertakan helloworld API, lalu membuat dan mendaftarkan developer dengan produk API untuk mendapatkan kunci API.

  4. Mendapatkan kunci API.
    1. Buat produk API menggunakan UI Apigee:
      1. Pilih Publikasikan > Produk API.
      2. Klik + Buat.
      3. Masukkan Detail Produk untuk produk API Anda.
      4. Masukkan informasi berikut di kolom:
        Kolom Setelan
        Name: produksaya
        Display name: produksaya
        Environment: pengembangan
        Access: Public
        Quota: Biarkan kosong
        Allowed OAuth scope: Biarkan kosong
      5. Di bagian Operations, klik + Add an Operation.
      6. Di bagian Source, pilih helloworld dari menu dropdown Proxy API.
      7. Di bagian Operation, di kolom Path, masukkan /.

        Biarkan kolom lain disetel ke default.

      8. Klik Save untuk menyimpan Operasi.
      9. Klik Save untuk menyimpan produk API.
    2. Buat developer di organisasi Anda:
      1. Pilih Publikasikan > Developer di menu navigasi.
      2. Klik + Developer.
      3. Masukkan informasi berikut di kolom:
        Kolom Setelan
        First Name: Alex
        Last Name: Hamilton
        Username: Ahamilton
        Email: ahamilton@example.com
      4. Klik Create.
    3. Daftarkan aplikasi:
      1. Pilih Publikasikan > Aplikasi.
      2. Klik + App.
      3. Masukkan informasi berikut di kolom:
        Kolom Setelan
        Name: aplikasisaya
        Display name: aplikasisaya
        Developer: ahamilton@example.com
        Callback URL: Biarkan kosong
        Notes: Biarkan kosong
        Expiry: Tidak pernah
        Product:
        1. Klik Tambahkan produk.
        2. Pilih myproduct.
        3. Klik Tambahkan.
        Custom attributes: Biarkan kosong
    4. Salin kunci API.
      1. Di halaman Aplikasi (Publikasikan > Aplikasi), klik myapp.
      2. Di halaman myapp, klik Tampilkan di samping Key di Bagian Credentials. Perhatikan bahwa kunci API telah dikaitkan dengan produk API yang Anda buat.
      3. Pilih dan salin kunci API.
  5. Jalankan lagi panggilan curl dengan meneruskan kunci API menggunakan parameter kueri apikey, sebagai berikut: 
    curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Respons berikut ditampilkan:

    {
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

Selamat! Anda telah berhasil men-deploy arsip API ke lingkungan Apigee.

Pada langkah berikutnya, Anda akan mempromosikan arsip API ke lingkungan produksi Apigee.

1 2 3 4 5 6 7 (BERIKUTNYA) Langkah 8: Promosikan arsip ke produksi