Bekerja dengan grup lingkungan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Bagian ini menjelaskan cara membuat dan mengedit grup lingkungan, yang mencakup penambahan lingkungan atau nama host ke grup, atau menghapusnya, dengan Apigee. Untuk mengetahui informasi selengkapnya tentang apa yang dimaksud dengan grup lingkungan dan cara kerjanya, lihat Ringkasan grup lingkungan dan lingkungan.

Membuat grup lingkungan

Anda dapat membuat grup lingkungan baru menggunakan UI Apigee atau Apigee API. Bagian ini menjelaskan cara melakukan keduanya.

Saat pertama kali Anda membuat grup lingkungan, grup tersebut tidak berisi lingkungan apa pun. Namun, langkah ini akan menentukan nama host default: example.group-name. Untuk menambahkan lingkungan ke grup lingkungan, lihat Menambahkan lingkungan ke grup lingkungan.

Pengguna hybrid Apigee: Setiap grup lingkungan yang Anda buat dengan lingkungan terlampir harus disertakan dalam semua file penggantian tempat lingkungan tersebut digunakan.

Catatan: Saat ini ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee di Cloud Console. Petunjuk dalam dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Cloud Console atau Apigee klasik.

Apigee di Cloud Console

Untuk membuat grup lingkungan baru di Apigee di Cloud Console:

1. Buka UI Apigee di Cloud Console pada browser.
2. Pilih Management > Environments di panel navigasi sebelah kiri.
3. Di panel Environments, pilih Environment Groups.
4. Klik + Create Environment Group.
5. Masukkan info berikut:
   • Nama grup lingkungan: Nama untuk grup lingkungan. Nama harus diawali dan diakhiri dengan karakter alfanumerik. ID ini dapat memiliki hingga 63 karakter yang terdiri dari karakter alfanumerik dan tanda hubung. Nama harus berbeda dari nama grup lingkungan yang ada di organisasi Anda.

   • Hostames: Daftar nama host yang dapat digunakan untuk memanggil proxy. Setiap nama host harus ditulis di baris terpisah.

     Catatan: Nama yang ditetapkan ke grup lingkungan harus unik untuk grup tersebut: nama ini tidak dapat digunakan oleh grup lingkungan lainnya.

     Anda juga memiliki opsi untuk mengklik Configure Google Load Balancer with these domains. Tindakan ini akan membuka halaman Load balancing di Cloud Console, tempat Anda dapat mengonfigurasi load balancing untuk nama host.

   • Lingkungan: Daftar opsional lingkungan yang akan disertakan dalam grup lingkungan.
6. Klik Create.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

Apigee Klasik

Untuk membuat grup lingkungan baru di UI Apigee klasik:

1. Di UI Apigee, pilih Admin > Lingkungan > Grup.
2. Klik +Environment Group:

   

   Dialog Add an Environment Group akan ditampilkan.

3. Masukkan nama untuk grup lingkungan baru Anda:

   

   Nama hanya boleh berisi huruf kecil, angka, dan tanda hubung. Selain itu, nama harus diawali dengan huruf, dengan panjang minimal dua karakter, dan tidak boleh diakhiri dengan tanda hubung. Nama yang valid mencakup my-env-group dan prod2.

4. Klik Tambahkan.

   Apigee membuat grup lingkungan baru. Ini biasanya merupakan operasi yang sangat cepat.

   Setelah operasi berhasil, Apigee mengonfirmasi bahwa grup telah dibuat dengan banner yang terlihat seperti berikut:

   

   Apigee juga menetapkan nama host default ke grup baru.

5. (Opsional) Tetapkan nama host tambahan ke grup baru dengan mengklik untuk grup tersebut.

   Apigee menampilkan panel Environment group details:

   

6. Tambahkan nama host ke kolom Hostnames. Setiap nama host harus ditulis di baris terpisah.

7. Klik Simpan setelah selesai.

   Anda dapat menambahkan dan menghapus nama host ke daftar ini kapan saja menggunakan prosedur yang sama.

API Apigee

Untuk membuat grup lingkungan baru menggunakan Apigee API, kirim permintaan POST ke Create environment groups API. Sebelum memanggil API, pastikan Anda memiliki token yang valid, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0.

Contoh perintah curl berikut menunjukkan sintaksis untuk membuat grup baru:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

Saat menentukan nama grup baru, Anda hanya boleh menggunakan huruf kecil, angka, dan tanda hubung (a-z, A-Z, dan -). Anda tidak dapat menggunakan huruf besar atau karakter khusus selain tanda hubung. Anda juga harus memulai nama dengan huruf kecil.

Jika Anda tidak menentukan parameter tambahan, perintah ini akan membuat grup baru tanpa nama host yang ditetapkan padanya.

Anda juga dapat menetapkan nama host saat membuat grup dengan menentukannya sebagai array dalam isi permintaan.

Contoh berikut membuat grup baru my-group dan menetapkan tiga nama host baru ke grup baru:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \
  -d '{ \
    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \
  }'

Nantinya, Anda dapat mengubah nama host dalam daftar dengan mengirimkan permintaan PATCH ke Patch environment groups API.

Menambahkan lingkungan ke grup lingkungan

Lingkungan yang tidak berada dalam grup tidak dapat diakses karena tidak ada nama host yang terkait dengannya. Nama host ditentukan pada grup lingkungan, bukan pada lingkungan. Saat membuat lingkungan menggunakan UI Apigee di Konsol Google Cloud, Anda memiliki opsi untuk menetapkan lingkungan ke grup lingkungan yang ada. Untuk mengetahui informasi selengkapnya, lihat Membuat lingkungan baru di UI.

Jika Anda tidak menetapkan lingkungan ke grup selama pembuatan lingkungan, bagian ini menjelaskan cara menambahkan lingkungan yang belum ditetapkan ke grup lingkungan menggunakan UI Apigee atau Apigee API.

Catatan: Saat ini ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee di Cloud Console. Petunjuk dalam dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Cloud Console atau Apigee klasik.

Apigee di Cloud Console

Untuk menambahkan lingkungan ke grup lingkungan di Apigee di Cloud Console:

1. Buat lingkungan, seperti yang dijelaskan dalam Membuat lingkungan.
2. Di UI Apigee di Cloud Console, pilih Management > Environments di panel navigasi sebelah kiri.
3. Di panel Environments, pilih Environment Groups.
4. Di baris untuk grup lingkungan, klik menu tiga titik di bagian Tindakan, lalu pilih Edit.
5. Di panel Edit Environment Group, di bagian Environments (Optional), pilih lingkungan yang ingin Anda tambahkan ke grup lingkungan.
6. Klik Perbarui.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

Apigee Klasik

Untuk menambahkan lingkungan ke grup lingkungan di UI Apigee klasik:

1. Buat lingkungan, seperti yang dijelaskan dalam Membuat lingkungan.
2. Di UI Apigee, pilih Admin > Lingkungan > Grup.
3. Lihat pada bagian Belum ditetapkan untuk melihat daftar lingkungan yang bukan bagian dari grup lingkungan:

   

   Perhatikan lingkungan yang belum ditetapkan saat Anda ingin menetapkannya.

4. Klik di samping grup lingkungan yang ingin ditambahkan lingkungan.

   Panel Environment Group Details menampilkan:

   

5. Untuk menambahkan lingkungan baru ke grup ini, klik + dalam daftar Environments.

   Panel Add environment akan menampilkan:

   

6. Pilih lingkungan yang ingin ditambahkan ke grup, lalu klik Tambahkan.

   Apigee menambahkan lingkungan ke grup.

API Apigee

Untuk menambahkan lingkungan baru ke grup lingkungan menggunakan Apigee API, kirim permintaan POST ke Environment group attachment API, seperti yang ditampilkan contoh berikut:

curl -H "Authorization: Bearer $TOKEN" -X POST
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"
  -d '{
    "name": "my-attachment",
    "environment": "test"
  }'

Dengan keterangan:

• $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0.
• Isi permintaan berisi nama lampiran serta nama lingkungan baru.

Isi permintaan berisi instance resourceEnvironmentGroupLampiran yang merupakan wrapper sederhana di sekitar satu lingkungan.

Jika berhasil, respons akan berisi detail tentang lampiran baru, termasuk stempel waktu saat lampiran dibuat; misalnya:

{
  "name": "my-attachment",
  "environment": "test"
  "createdAt": "42"
}

Menghapus lingkungan dari grup lingkungan

Anda dapat menghapus lingkungan dari grup lingkungan dengan UI Apigee atau Apigee API.

Catatan: Saat ini ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee di Cloud Console. Petunjuk dalam dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Cloud Console atau Apigee klasik.

Apigee di Cloud Console

Untuk menghapus lingkungan dari grup lingkungan di Apigee di Cloud Console:

1. Di UI Apigee di Cloud Console, pilih Management > Environments di panel navigasi sebelah kiri.
2. Di panel Environments, pilih Environment Groups.
3. Di baris untuk grup lingkungan, klik menu tiga titik di bagian Tindakan, lalu pilih Edit.
4. Di panel Edit Environment Group, di bagian Environments (Optional), batalkan pilihan lingkungan yang ingin Anda hapus dari grup lingkungan.
5. Klik Perbarui.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

Apigee Klasik

Untuk menghapus lingkungan dari grup lingkungan di UI Apigee klasik:

1. Di UI Apigee, pilih Admin > Lingkungan > Ringkasan.
2. Pilih lingkungan yang ingin Anda hapus.
3. Di panel Groups, gerakkan kursor ke akhir baris untuk grup tempat Anda ingin menghapus lingkungan, lalu klik .

Catatan: Atau, jika Anda melihat halaman Environment groups, Anda dapat memilih lingkungan yang ingin dihapus di panel mana pun tempat lingkungan tersebut muncul untuk membukanya di panel Groups pada halaman Environments.

API Apigee

Untuk menghapus lingkungan dari grup lingkungan menggunakan Apigee API, gunakan metode delete dalam resource EnvironmentGroupAttach untuk menghapus lampiran yang sesuai dengan lingkungan tersebut.

Menghapus grup lingkungan

Anda dapat menghapus grup lingkungan menggunakan UI Apigee atau API.

Catatan: Saat ini ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee di Cloud Console. Petunjuk dalam dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Cloud Console atau Apigee klasik.

Apigee di Cloud Console

Untuk menghapus grup lingkungan di Apigee di Cloud Console:

1. Di UI Apigee di Cloud Console, pilih Management > Environments di panel navigasi sebelah kiri.
2. Di panel Environments, pilih Environment Groups.
3. Di baris untuk grup lingkungan, klik menu tiga titik di bagian Tindakan, lalu pilih Hapus.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

Apigee Klasik

Untuk menghapus grup lingkungan di UI Apigee klasik:

1. Di UI Apigee, pilih Admin > Lingkungan > Grup.
2. Pindahkan kursor ke panel untuk grup yang ingin Anda hapus.
3. Klik ikon .

API Apigee

Untuk menghapus grup lingkungan menggunakan Apigee API, gunakan metode delete pada resource EnvironmentGroup.

Menambahkan nama host ke grup

Saat Anda membuat grup, Apigee menambahkan nama host default example.GROUP_NAME. Anda dapat menambahkan nama host ke grup menggunakan petunjuk di bagian ini.

Nama host yang Anda tentukan pada grup lingkungan:

• Harus unik di semua grup lingkungan dalam suatu organisasi; lingkungan tidak dapat digunakan oleh lebih dari satu grup
• Tidak mendukung karakter pengganti
• Jalur dasar harus unik dalam host (tidak ada dua proxy yang dapat memiliki jalur dasar yang sama dalam sebuah host)

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee di Cloud Console. Petunjuk dalam dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Cloud Console atau Apigee klasik.

Apigee di Cloud Console

Untuk menambahkan nama host ke grup lingkungan di Apigee di Cloud Console:

1. Di UI Apigee di Cloud Console, pilih Management > Environments di panel navigasi sebelah kiri.
2. Di panel Environments, pilih Environment Groups.
3. Di baris untuk grup lingkungan, klik menu tiga titik di bagian Tindakan, lalu pilih Edit.
4. Di panel Edit Environment Group, di bagian Hostnames, masukkan nama host yang ingin Anda tambahkan ke grup lingkungan.
5. Klik Perbarui.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

Apigee Klasik

Untuk menambahkan nama host ke grup lingkungan di UI Apigee klasik:

1. Di UI Apigee, pilih Admin > Lingkungan > Grup.

2. Arahkan kursor ke kartu grup dan pilih .

   Panel Environment group details menampilkan:

   

3. Di kolom Nama host, masukkan host baru.
4. Klik Simpan untuk menambahkan host baru ke grup.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit hingga selesai.

API Apigee

Untuk menambahkan nama host ke grup lingkungan menggunakan Apigee API, kirim permintaan PATCH ke Patch environment groups API. Pastikan untuk menetapkan parameter updateMask ke hostnames dan menentukan seluruh daftar nama host yang Anda inginkan: nilai kolom tersebut dalam permintaan Anda akan menggantikan daftar yang ada.

Contoh berikut menetapkan nama host untuk lingkungan pengujian:

curl -H "Authorization: Bearer $TOKEN" -X PATCH
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?hostnames=updateMask"
  -d '{
    "name": "my-hostnames",
    "hostnames": [
      "test-1.example.com",
      "test-2.example.com",
      "test-3.example.com"
    ]
  }'

Dengan keterangan:

• $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0.
• Payload permintaan menentukan nama untuk array lampiran nama host, ditambah array nama itu sendiri.

Jika permintaan berhasil, respons akan berisi Resource operasi.

Menentukan apakah Cloud Load Balancer dikonfigurasi untuk nama host

Anda dapat memanggil proxy dengan perintah berikut:

curl -v https://YOUR_ENV_GROUP_HOSTNAME/myproxy

dengan YOUR_ENV_GROUP_HOSTNAME adalah nama host grup lingkungan yang berisi lingkungan tempat proxy di-deploy. Untuk melakukannya, Cloud Load Balancer harus dikonfigurasi untuk nama host grup lingkungan. Biasanya, Load Balancer sudah dikonfigurasi saat Apigee pertama kali disediakan. Untuk menentukan apakah Load Balancer dikonfigurasi untuk nama host:

1. Pada tampilan Admin > Lingkungan > Grup, klik ikon edit di sebelah kanan grup lingkungan untuk nama host.
2. Klik Configure Google Load Balancer with these domains. Tindakan ini akan mengarahkan Anda ke halaman Load balancing Google Cloud Platform.

   

3. Klik nama load balancer di kolom Name. Jika Apigee disediakan dengan Wizard Penyediaan, nama load balancer adalah apigee-proxy-url-map. Jika Anda tidak melihat nama tersebut, hubungi administrator sistem di organisasi Anda yang menyediakan Apigee.

   Saat Anda mengklik nama tersebut, halaman Detail load balancer akan ditampilkan:

   

4. Pada tabel Frontend, klik sertifikat SSL di kolom Certificate, lalu cari sertifikat SSL yang cocok dengan nama host:
   • Jika Jenis sertifikat DIKELOLA, periksa apakah kolom Nama Host DNS sertifikat cocok dengan nama host.
   • Jika sertifikat tidak dikelola, Anda mungkin perlu mendownload sertifikat dan memeriksa apakah Nama Umumnya cocok dengan nama host.

Jika Anda tidak menemukan nama host di sertifikat apa pun, hubungi administrator sistem untuk mendapatkan bantuan lebih lanjut.