Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Langkah 5: Buat grup lingkungan

Pada langkah ini, Anda akan membuat lingkungan dan grup lingkungan.

Di Apigee, proxy API di-deploy ke lingkungan, yang menyediakan konteks terisolasi untuk proxy Anda. Lingkungan disusun menjadi grup lingkungan, yang menyediakan nama host untuk semua proxy yang di-deploy ke lingkungan dalam grup. Anda harus memiliki setidaknya satu lingkungan dan setidaknya satu grup lingkungan. Untuk mempelajari lebih lanjut, lihat Tentang lingkungan dan grup lingkungan.

Membuat lingkungan

Buat lingkungan terlebih dahulu sebelum membuat grup lingkungan. Anda dapat membuat lingkungan menggunakan UI Apigee hybrid atau menggunakan CLI. Anda dapat menggunakan UI untuk langkah-langkah ini agar lebih memahaminya.

UI Apigee Hybrid

Untuk mengakses UI hybrid dan menambahkan lingkungan, lakukan langkah-langkah berikut:

Buka UI Apigee. Jika ini adalah pertama kalinya Anda login, hybrid akan menampilkan dialog izin. Jika Anda diminta untuk memilih dari lebih dari satu akun, pilih akun yang memiliki proyek yang Anda buat di Langkah 2: Membuat proyek Google Cloud. Kemudian, klik Izinkan.

Browser Anda akan membuka halaman landing utama UI hibrida:

Halaman arahan (landing page) pada UI hibrida Apigee, yang terdiri dari navigasi di sisi kiri dan gambar-gambar besar yang berfungsi sebagai tautan.

Pastikan organisasi yang mendukung hybrid Anda dipilih dari daftar drop-down organisasi. Jika tidak dipilih, pilih dari daftar drop-down, seperti yang ditunjukkan contoh berikut:

Catatan: Saat Anda memilih organisasi yang mendukung hybrid dari menu drop-down, UI hybrid akan menampilkan nama organisasi Apigee dan nama project Google Cloud di header. Nama organisasi Apigee dan nama project Google Cloud sama.
Klik Admin > Environments > Overview.

Tampilan Environments ditampilkan, tanpa ada lingkungan (saat ini):
Klik +Lingkungan.
Dialog New environment akan ditampilkan:
Masukkan informasi berikut di dialog New Environment:
1. Nama tampilan (Wajib): Nama yang mudah diingat untuk lingkungan yang digunakan di UI. Misalnya, "My First Environment" atau "test". Tidak seperti Nama lingkungan, Nama tampilan dapat menyertakan huruf besar dan karakter khusus lainnya.
2. Nama lingkungan (Wajib): Nama terprogram untuk lingkungan; juga dikenal sebagai ID lingkungan.
  Misalnya, "my-environment" atau "test".
  
  Perhatian: Nama lingkungan hanya boleh berisi huruf kecil, angka, dan tanda hubung. Anda tidak dapat menggunakan huruf kapital atau karakter khusus lainnya. Selain itu, Nama lingkungan dapat memiliki panjang maksimal 32 karakter. Misalnya: my-test-env atau my-test-env-42.
  
  Nama tampilan dan Nama lingkungan dapat berbeda.
3. Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan. Misalnya, "Dibuat selama penginstalan awal".
Klik Create.
Apigee akan membuat lingkungan baru dan menunjukkan bahwa lingkungan tersebut Pending Provisioning:

Dalam beberapa saat, statusnya akan berubah menjadi disediakan:

Namun, Anda belum selesai. Anda juga perlu menambahkan lingkungan baru ke file overrides.yaml runtime—tetapi pertama-tama Anda harus menginstal runtime, jadi jangan terburu-buru.

gcloud CLI

Untuk membuat lingkungan dengan Create environments API, lakukan langkah-langkah berikut:

Buka terminal di perangkat yang Anda gunakan untuk mengelola Apigee.
Di command line, dapatkan kredensial autentikasi gcloud Anda, seperti yang ditunjukkan contoh berikut:
```
TOKEN=$(gcloud auth print-access-token)
```
Untuk memeriksa apakah token Anda telah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo $TOKEN
```
Tindakan ini akan menampilkan token Anda sebagai string yang dienkode.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan alat command line gcloud.
Buat variabel lingkungan untuk elemen-elemen lingkungan tersebut. Anda akan menggunakan variabel berikut dalam perintah untuk membuatnya:
- ENV_NAME (Diperlukan) adalah ID program untuk lingkungan Anda. Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai pengenal dan tidak dapat diubah setelah pembuatan.
```
export ENV_NAME=environment_name
```
- ENV_DISPLAY_NAME (Diperlukan) adalah nama yang mudah dipahami pengguna untuk lingkungan Anda. Nilai ini tidak perlu unik, dan dapat mencakup spasi dan karakter khusus. Sebagai contoh, "Lingkungan Contoh Saya".
```
ENV_DISPLAY_NAME=friendly_name
```
- ORG_NAME (Diperlukan) adalah ID organisasi Anda. Pastikan Anda telah mendefinisikan variabel lingkungan ORG_NAME dari Langkah 4: Membuat organisasi:
```
echo $ORG_NAME
```
- ENV_DESCRIPTION (Opsional) adalah informasi tentang lingkungan yang ingin Anda gunakan sebagai pengingat tujuannya. Misalnya, "Contoh lingkungan untuk petunjuk Apigee Hybrid".
```
ENV_DESCRIPTION=description_text
```
Kirim permintaan POST terautentikasi ke API Buat lingkungan.
Catatan: Setelah membuat organisasi yang kompatibel dengan hybrid, Anda tidak dapat menghapus organisasi, mengubah ID organisasi, atau mengubah project Google Cloud yang terikat ke organisasi Anda. Untuk mengubah salah satu hal tersebut, hubungiLayanan Pelanggan Google Cloud.

Contoh berikut menunjukkan struktur permintaan yang membuat lingkungan, menggunakan perintah berikut:
```
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'",
    "displayName": "'"$ENV_DISPLAY_NAME"'",
    "description": "'"$ENV_DESCRIPTION"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"
```
Jika permintaan pembuatan berhasil, Environments API akan merespons dengan pesan yang mirip dengan berikut ini:
```
{
  "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "organizations/hybrid-example/environments/example-env",
    "state": "IN_PROGRESS"
  }
}
```
Seperti yang ditunjukkan oleh properti state dalam respons, Apigee telah mulai membuat lingkungan baru, sehingga statusnya adalah IN_PROGRESS. Proses ini dapat memakan waktu beberapa menit.

Membuat grup lingkungan

Sekarang, buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat ke grup tersebut. Grup lingkungan memungkinkan Anda untuk mengelompokkan lingkungan bersama-sama, dan menyediakan nama host untuk mengarahkan proxy yang dikerahkan ke lingkungan di dalam grup tersebut. Anda harus membuat setidaknya satu grup lingkungan, dan Anda harus menetapkan setidaknya satu nama host ke grup tersebut. Untuk gambaran umum tentang grup lingkungan, lihat Tentang lingkungan dan grup lingkungan.

UI Apigee Hybrid

Untuk membuat grup lingkungan menggunakan UI Apigee, lakukan langkah-langkah berikut:

Buka UI Apigee.

Browser Anda akan mengarahkan Anda ke halaman utama antarmuka pengguna hibrida.

Pastikan organisasi yang mendukung hybrid Anda dipilih dari daftar drop-down organisasi. Jika belum dipilih, pilih dari daftar drop-down.
Klik Admin > Environments > Groups.
Tampilan Ikhtisar Grup Lingkungan ditampilkan, dengan semua grup lingkungan yang telah dibuat:
Klik +Grup Lingkungan.
Dialog Tambahkan Grup Lingkungan akan ditampilkan.
Masukkan nama, lalu klik Tambahkan.
Arahkan kursor ke grup lingkungan yang baru dibuat, lalu klik Edit .

Tambahkan nama host yang akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini. Ini harus berupa domain yang akses pengelolaannya Anda miliki. Jika Anda perlu mendaftarkan domain, lihat registrar domain seperti Google Domains.

Jendela Edit Grup Lingkungan yang tidak menampilkan lingkungan yang ditetapkan

Klik Tambahkan (+).
Dialog Add environment akan ditampilkan.

Dialog tambahkan lingkungan yang mencantumkan lingkungan yang tersedia

Pilih lingkungan dari daftar, lalu klik Tambahkan.

gcloud CLI

Untuk membuat grup lingkungan menggunakan command line, lakukan langkah-langkah berikut:

Di command line, dapatkan kredensial autentikasi gcloud Anda, seperti yang ditunjukkan contoh berikut:
```
TOKEN=$(gcloud auth print-access-token)
```
Untuk memeriksa apakah token Anda telah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo $TOKEN
```
Tindakan ini akan menampilkan token Anda sebagai string yang dienkode.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan alat command line gcloud.
Pastikan Anda telah mengatur variabel lingkungan DOMAIN seperti yang ditunjukkan contoh berikut:
```
echo $DOMAIN
```
Ini adalah nama host yang akan digunakan oleh semua proxy yang dikerahkan ke lingkungan dalam grup ini. Ini harus berupa domain yang akses pengelolaannya Anda miliki.

Jika tidak disetel, buat dengan domain yang akan Anda gunakan untuk penginstalan Apigee hybrid Anda. Contoh:
```
export DOMAIN=domain-name.com
```
Pastikan Anda telah menetapkan variabel lingkungan ENV_NAME ke lingkungan yang baru saja Anda buat pada langkah sebelumnya. Contoh:
```
echo $ENV_NAME
```
Buat variabel lingkungan untuk nama grup lingkungan yang Anda inginkan. Contoh:
```
export ENV_GROUP=environment-group-name
```

Buat grup lingkungan dengan perintah berikut:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Tetapkan lingkungan ke grup baru dengan perintah berikut:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

Langkah berikutnya

Untuk melanjutkan penginstalan, lihat Penginstalan runtime: Sebelum memulai.

Langkah 5: Buat grup lingkungan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Membuat lingkungan

UI Apigee Hybrid

gcloud CLI

Membuat grup lingkungan

UI Apigee Hybrid

gcloud CLI

Langkah berikutnya

Langkah 5: Buat grup lingkungan