Mengonfigurasi dan men-deploy lingkungan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Lingkungan adalah konteks eksekusi runtime untuk proxy API dan alur bersama yang ingin Anda deploy. Anda harus men-deploy proxy API dan alur bersama ke satu atau beberapa lingkungan sebelum dapat diakses untuk pengujian. Untuk mengetahui informasi selengkapnya tentang lingkungan, lihat Tentang lingkungan dan grup lingkungan.

Konfigurasi dan deploy lingkungan seperti yang dijelaskan di bagian berikut. Lihat juga Mengelola folder dan file di ruang kerja Apigee.

Mengonfigurasi lingkungan

Sebelum men-deploy lingkungan, konfigurasikan lingkungan tersebut untuk mengidentifikasi proxy API dan alur bersama yang ingin Anda deploy, serta konfigurasikan target server atau hook alur bersama, sesuai kebutuhan.

Untuk mengonfigurasi lingkungan, buat lingkungan dan edit konfigurasi yang ditentukan dalam tabel berikut.

Konfigurasi	Deskripsi
Masker debug (debugmasks.json)	Tentukan konfigurasi penyamaran untuk menyamarkan data tertentu dalam sesi rekaman aktivitas dan debug.
Deployment (deployments.json)	Tentukan proxy API dan alur bersama dalam deployment Anda.
Hook alur (flowhooks.json)	Lampirkan alur bersama ke flow hook sehingga alur tersebut dieksekusi di tempat yang sama untuk semua proxy API yang di-deploy ke lingkungan.
Server target (targetservers.json)	Pisahkan endpoint konkret Anda dari endpoint target untuk mendukung load balancing dan failover di beberapa instance server backend.
Toko utama (keystores.json)	Tambahkan dukungan TLS ke endpoint target dan server target Anda.

Selain itu, jika Anda menggunakan kebijakan apa pun yang memerlukan resource, Anda dapat mengelola resource di tingkat lingkungan, sesuai kebutuhan.

Membuat lingkungan

Untuk membuat lingkungan di Apigee di Cloud Code:

1. Lakukan salah satu tindakan berikut:

   • Arahkan kursor ke folder environments di ruang kerja Apigee, lalu klik .

     

   • Pilih View > Command Palette untuk membuka Palet perintah, lalu pilih Cloud Code: Create Apigee environment.

   Wizard Create environment akan terbuka.

2. Masukkan nama untuk lingkungan, lalu tekan Enter.

Catatan: Nama ini harus cocok dengan nama lingkungan di organisasi Apigee Anda.

Lingkungan ditambahkan ke folder environments di bagian Apigee:

Konfigurasi lingkungan, seperti yang dijelaskan di bagian berikut.

Mengonfigurasi mask debug (debugmask.json)

Apigee memungkinkan Anda menentukan konfigurasi penyamaran untuk menyamarkan data tertentu dalam sesi debug dan rekaman aktivitas. Saat data disamarkan, data tersebut akan diganti dengan tanda bintang dalam output rekaman aktivitas. Contoh:

<description>**********</description>

Untuk mengetahui informasi selengkapnya, lihat Menyamarkan data sensitif.

Untuk mengonfigurasi mask debug, perbarui file debugmask.json dengan mengedit file secara langsung.

Berikut adalah contoh struktur dasar konfigurasi mask dalam format JSON. Untuk mengetahui informasi selengkapnya tentang kolom konfigurasi mask yang ditampilkan dalam contoh, lihat DebugMask.

{
  "namespaces": {
    "myco": "https://example.com"
  },
  "requestXPaths": [
    "/myco:Greeting/myco:User"
  ],
  "responseXPaths": [
    "/myco:Greeting/myco:User"
  ],
  "faultXPaths": [
    "/myco:Greeting/myco:User"
  ],
  "requestJSONPaths": [
    "$.store.book[].author"
  ],
  "responseJSONPaths": [
    "$.store.book[].author"
  ],
  "faultJSONPaths": [
    "$.store.book[*].author"
  ],
  "variables": [
    "request.header.user-agent",
    "request.formparam.password"
  ]
}

Mengonfigurasi deployment (deployments.json)

Konfigurasi proxy API dan alur bersama yang ingin Anda sertakan dalam deployment.

Untuk mengonfigurasi deployment, perbarui file deployments.json menggunakan wizard konfigurasi atau dengan mengedit file secara langsung.

Catatan: Hanya proxy API dan alur bersama yang Anda sertakan dalam file deployments.json yang di-deploy.

Untuk mengonfigurasi deployment menggunakan wizard konfigurasi:

1. Arahkan kursor ke file deployments.json untuk lingkungan dan klik .

   

2. Ikuti wizard konfigurasi untuk memilih deployment dan mengisi otomatis kolom dalam file deployments.json. File deployments.json akan dibuka di editor.
3. Edit konfigurasi sesuai kebutuhan.
4. Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit Anda.

Contoh berikut mengonfigurasi deployment untuk menyertakan proxy API helloworld dan alur bersama mysharedflow dan hw-sharedflow:

{
  "proxies" : [
     "helloworld"
  ],
  "sharedflows" : [
     "mysharedflow",
     "hw-sharedflow"
  ]
}

Mengonfigurasi akun layanan dengan deployment proxy dan alur bersama

Catatan: Fitur ini memerlukan emulator versi 1.9.2 atau yang lebih baru.

Proxy API yang bergantung pada layanan Google sebagai backend mungkin memerlukan Google Cloud akun layanan yang dikaitkan dengan deployment. Lihat Menggunakan autentikasi Google.

Saat mengedit file deployments.json, Anda dapat mengaitkan proxy API atau alur bersama dengan akun layanan Google Cloud . Contoh:

{
  "name": "proxy-name",
  "serviceAccount": "associated-service-account"
}

Contoh berikut menunjukkan konfigurasi deployment tempat akun layanan dikaitkan dengan proxy API helloworld dan shared flow mysharedflow, tetapi proxy healthcheck dan shared flow hw-sharedflow tidak dikaitkan dengan akun layanan:

{
  "proxies": [
    {
      "name": "helloworld",
      "serviceAccount": "myserviceaccount@myorg."
    },
    "healthcheck"
  ],
  "sharedflows": [
    {
      "name": "mysharedflow",
      "serviceAccount": "myserviceaccount@myorg."
    },
    "hw-sharedflow"
  ]
}

Pelajari lebih lanjut cara mengonfigurasi Emulator Apigee untuk menguji fitur autentikasi akun layanan di proxy API Anda.

Melampirkan alur bersama menggunakan hook alur (flowhooks.json)

Dengan flow hook, Anda melampirkan alur bersama sehingga alur tersebut dieksekusi di tempat yang sama untuk semua proxy API yang di-deploy ke lingkungan tertentu. Hal ini memberi Anda urutan logika yang diterapkan dan di-deploy secara terpisah yang bukan bagian dari kode implementasi proxy API. Secara khusus, Anda dapat melampirkan alur bersama di lokasi berikut dalam alur proxy API:

• Sebelum endpoint proxy API dieksekusi (PreProxyFlowHook)
• Setelah endpoint proxy API dieksekusi dan tepat sebelum respons dikirim ke klien (PostProxyFlowHook)
• Sebelum endpoint target dieksekusi (PreTargetFlowHook)
• Setelah respons target dieksekusi (PostTargetFlowHook)

Untuk mengetahui informasi selengkapnya tentang hook alur, lihat Melampirkan alur bersama menggunakan hook alur.

Catatan: Melampirkan alur bersama ke flow hook adalah tindakan yang memiliki efek sangat luas. Alur bersama terlampir dieksekusi di titik hook alur untuk setiap proxy yang di-deploy ke lingkungan tersebut.

Untuk melampirkan alur bersama menggunakan hook alur, perbarui file flowhooks.json menggunakan wizard konfigurasi atau dengan mengedit file secara langsung.

Untuk mengonfigurasi hook alur menggunakan wizard konfigurasi:

1. Arahkan kursor ke file flowhooks.json untuk lingkungan, lalu klik .
2. Pilih alur bersama yang akan dilampirkan di lokasi tertentu dalam alur proxy API dan isi otomatis kolom dalam file flowhooks.json. File flowhooks.json akan dibuka di editor.
3. Edit konfigurasi sesuai kebutuhan.
4. Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit Anda.

Contoh berikut melampirkan mysharedflow ke PreProxyFlowHook sehingga dijalankan sebelum endpoint proxy API dijalankan:

{
  "PreProxyFlowHook": {
    "continueOnError": true,
    "sharedFlow": "mysharedflow",
    "description": "Shared enforced before a proxy endpoint executes."
  }
}

Mengonfigurasi server target (targetservers.json)

Server target (TargetServers) memisahkan URL endpoint konkret dari konfigurasi endpoint target (TargetEndpoint). Daripada menentukan URL konkret dalam konfigurasi, Anda dapat mengonfigurasi satu atau beberapa TargetServer bernama. Kemudian, rujuk setiap TargetServer berdasarkan nama di HTTPConnection TargetEndpoint.

Untuk mengetahui informasi selengkapnya tentang server target, lihat topik berikut:

• Load balancing di seluruh server backend
• Antipola: Load balancing dengan satu server target dengan MaxFailures disetel ke nilai bukan nol

Untuk mengonfigurasi server target, perbarui file targetservers.json menggunakan wizard konfigurasi atau dengan mengedit file secara langsung. Untuk mengetahui deskripsi kolom dalam file targetservers.json, lihat Resource: TargetServer.

Untuk mengonfigurasi server target menggunakan wizard konfigurasi:

1. Arahkan kursor ke file targetservers.json untuk lingkungan dan klik .
2. Ikuti wizard konfigurasi untuk mengonfigurasi server target dan mengisi otomatis kolom dalam file targetservers.json. File targetservers.json akan dibuka di editor.
3. Edit konfigurasi sesuai kebutuhan.
4. Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit Anda.

Contoh berikut menambahkan server target baru di lingkungan:

[
  {
    "enabled": true,
    "name": "mytargetserver",
    "description": "My first target server",
    "host": "localhost",
    "port": 80
  }
]

Contoh berikut mengonfigurasi server target dengan TLS bersama menggunakan keystore:

Catatan: Fitur ini memerlukan emulator versi 1.9.2 atau yang lebih baru.

[
    {
        "name": "mtlsserver",
        "host": "mytargetserver.mydomain",
        "port": 443,
        "enabled": true,
        "protocol": "HTTP",
        "tlsInfo": {
            "enabled": true,
            "clientAuthEnabled": true,
            "keyStore": "mykeystore",
            "keyAlias": "mykeyandcert",
            "trustStore": "mytruststore"
        }
    }
]

Mengonfigurasi keystore (keystores.json)

Catatan: Fitur ini memerlukan emulator versi 1.9.2 atau yang lebih baru.

Keystore menentukan repositori sertifikat keamanan yang digunakan untuk enkripsi TLS di endpoint target dan server target.

Untuk mengetahui informasi selengkapnya tentang konfigurasi TLS, lihat Opsi untuk mengonfigurasi TLS.

Keystore dalam pengembangan lokal Apigee hanya digunakan untuk menguji TLS bagi backend target yang di-deploy ke Emulator Apigee. Kunci dan sertifikat TLS yang ditentukan di keystore harus ada di sistem file lokal.

Untuk mengonfigurasi keystore:

1. Buka file keystores.json untuk lingkungan di editor. File memiliki dua elemen utama
   • stores - Peta nama keystore yang ditambahkan dan aliasnya.
   • references - Peta semua nama referensi keystore dan nama keystore terkait.
2. Edit konfigurasi sesuai kebutuhan.
3. Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit Anda.

Contoh berikut menunjukkan mykeystore keystore dengan dua alias, mycert-alias dan mykeycert-alias:

{
    "stores": {
      "mykeystore": {
        "my-cert-alias": {
          "cert": "/Users/jdoe/testkeys/cert1.pem"
        },
        "my-keycert-alias": {
          "key": "/Users/jdoe/testkeys/key1.pem",
          "cert": "/Users/jdoe/testkeys/cert1.pem"
        }
      }
    }
  }

Men-deploy lingkungan

Deploy proxy API dan alur bersama yang dikonfigurasi untuk lingkungan sehingga dapat diakses untuk pengujian.

Catatan: Sebelum men-deploy lingkungan, pastikan Anda telah menginstal Apigee Emulator.

Untuk men-deploy lingkungan:

1. Di bagian Apigee, posisikan kursor Anda di atas folder lingkungan yang ingin Anda deploy.
2. Klik .

   

3. Jika ada beberapa penampung untuk Emulator Apigee yang berjalan, pilih penampung yang ingin Anda deploy lingkungannya.
4. Pilih paket pengujian yang ingin Anda ekspor dengan deployment atau pilih Deploy tanpa paket pengujian.

   

   Catatan: Dialog ini hanya ditampilkan jika Anda telah membuat paket pengujian di ruang kerja Apigee.

   Anda dapat mengekspor resource pengujian nanti, seperti yang dijelaskan dalam Mengekspor resource pengujian ke Emulator Apigee.

Lingkungan di-deploy dan menampilkan pesan berhasil di tab Output.

Catatan: Revisi yang di-deploy akan bertambah setiap kali Anda men-deploy lingkungan yang sama.

Aplikasi yang di-deploy ditampilkan di Emulator Apigee: