Langkah 7: Deploy ke lingkungan Apigee

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Setelah menyelesaikan pengembangan dan pengujian lokal dengan Apigee di VS Code, Anda siap men-deploy API sebagai arsip ke lingkungan Apigee. 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 bagian Membuat lingkungan untuk melakukan tindakan berikut:
    1. Buat lingkungan dev baru di organisasi Apigee Anda, dengan mengaktifkan Archive sebagai jenis deployment. Gunakan UI atau API.

      Contoh:

      Dialog lingkungan baru yang menampilkan setelan Jenis deployment arsip

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

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

    3. Buat grup lingkungan jika Anda belum memilikinya menggunakan Create environment groups API.

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

      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.

      Penambahan lingkungan ke grup membuat proxy di lingkungan tersebut dapat dirutekan melalui nama host di grup. Hal ini memicu operasi yang berjalan lama dan dapat diselesaikan dalam beberapa menit. 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 tersebut seharusnya berisi folder src.

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

      Berikut ini memberikan contoh respons: 

      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 proxy sampel.

    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 API helloworld, 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 Publish > API Products.
      2. Klik + Buat.
      3. Masukkan Detail Produk untuk produk API Anda.
      4. Masukkan informasi berikut pada kolom:
        Kolom Setelan
        Name: produksaya
        Display name: produksaya
        Environment: dev
        Access: Public
        Quota: Biarkan kosong
        Allowed OAuth scope: Biarkan kosong
      5. Di bagian Operasi, klik + Tambahkan Operasi.
      6. Di bagian Source, pilih helloworld dari menu dropdown API Proxy.
      7. Di bagian Operation, masukkan / di kolom Jalur.

        Biarkan kolom lain disetel ke defaultnya.

      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 pada 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 + Aplikasi.
      3. Masukkan informasi berikut pada 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 Apps (Publish > Apps), klik myapp.
      2. Di halaman myapp, klik Show di samping Key di bagian Credentials. Perhatikan bahwa kunci API 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 4}