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 diatur ke dalam grup lingkungan, yang menyediakan nama host untuk semua proxy yang di-deploy ke lingkungan dalam grup. Anda harus memiliki minimal satu lingkungan dan minimal 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 hibrid Apigee atau CLI. Anda mungkin perlu menggunakan UI untuk langkah-langkah ini untuk 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, model hybrid akan menampilkan dialog izin. Jika Anda diminta untuk memilih di antara beberapa akun, pilih akun yang memiliki project yang dibuat di Langkah 2: Buat project Google Cloud. Lalu klik Izinkan.

Browser Anda akan membuka halaman landing utama UI campuran:

Halaman landing di UI campuran
Apigee, yang terdiri dari navigasi sebelah kiri dan gambar besar yang merupakan link.

Pastikan organisasi Anda yang mendukung sistem campuran dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down seperti yang ditampilkan pada 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 > Lingkungan > Ringkasan.

Tampilan Environments ditampilkan, namun belum ada lingkungan:
Klik +Lingkungan.
Dialog New environment akan ditampilkan:
Masukkan informasi berikut dalam dialog New Environment:
1. Nama tampilan (Wajib): Nama yang sesuai untuk lingkungan yang digunakan di UI. Misalnya, My First Environment atau test. Tidak seperti Environment name, Display name 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 besar atau karakter khusus lainnya. Selain itu, panjang maksimal Environment name adalah 32 karakter. Misalnya: my-test-env atau my-test-env-42.
  
  Display name dan Environment name dapat berbeda.
3. Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan. Misalnya, Created during initial installation.
Klik Create.
Apigee membuat lingkungan baru dan menunjukkan bahwa lingkungan tersebut Penyediaan Tertunda:

Dalam beberapa saat, status berubah menjadi disediakan:

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

gcloud CLI

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

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

Untuk mengetahui informasi selengkapnya, baca ringkasan alat command line gcloud.
Membuat variabel lingkungan untuk elemen-elemen lingkungan. Anda akan menggunakan variabel berikut dalam perintah untuk membuatnya:
- ENV_NAME (Wajib) adalah ID terprogram untuk lingkungan Anda. Nama lingkungan dapat berisi huruf kecil, tanda pisah, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai ID dan tidak dapat diubah setelah dibuat
```
export ENV_NAME=ENVIRONMENT_NAME
```
- ENV_DISPLAY_NAME (Wajib) adalah nama lingkungan Anda yang mudah digunakan. Nilai ini tidak harus unik, dan dapat berisi spasi dan karakter khusus. Misalnya, "Contoh Lingkungan Saya".
```
ENV_DISPLAY_NAME=FRIENDLY_NAME
```
- ORG_NAME (Wajib) adalah ID organisasi Anda. Pastikan Anda telah menentukan variabel lingkungan ORG_NAME dari Langkah 4: Buat organisasi:
```
echo $ORG_NAME
```
- ENV_DESCRIPTION (Opsional) adalah informasi tentang lingkungan yang ingin Anda gunakan sebagai pengingat tujuannya. Misalnya, "Contoh lingkungan untuk instruksi Apigee Hybrid".
```
ENV_DESCRIPTION=DESCRIPTION_TEXT
```
Mengirim permintaan POST yang diautentikasi ke Create lingkungan API.
Catatan: Setelah membuat organisasi yang mendukung hybrid, Anda tidak dapat menghapus organisasi, mengubah ID organisasi, atau mengubah project Google Cloud yang terikat dengan organisasi Anda. Untuk mengubah hal-hal tersebut, hubungi Dukungan Apigee.

Contoh berikut menampilkan struktur permintaan yang membuat organisasi, 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"
```
Pada permintaan pembuatan yang 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 properti state dalam respons, Apigee sudah mulai membuat lingkungan baru, sehingga statusnya adalah IN_PROGRESS. Proses ini dapat memerlukan waktu beberapa menit.

Membuat grup lingkungan

Sekarang buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat ke dalamnya. Grup lingkungan memungkinkan Anda mengelompokkan lingkungan, dan menyediakan nama host untuk mengarahkan proxy yang di-deploy ke lingkungan dalam grup. Anda harus membuat minimal satu grup lingkungan, dan menetapkan minimal satu nama host ke grup. Untuk ringkasan 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 membuka halaman landing utama UI campuran.

Pastikan organisasi Anda yang mendukung sistem campuran dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down.
Klik Admin > Lingkungan > Grup.
Tampilan Environment Groups Overview ditampilkan, dengan grup lingkungan yang dibuat:
Klik +Environment Group.
Dialog Add an Environment Group 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. Domain ini harus berupa domain yang akses pengelolaannya Anda miliki. Jika Anda perlu mendaftarkan domain, lihat registrar domain seperti Google Domains.

Jendela Edit Environment Group yang tidak menampilkan lingkungan yang ditetapkan

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

Tambahkan dialog 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:

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

Untuk mengetahui informasi selengkapnya, baca ringkasan alat command line gcloud.
Pastikan Anda telah menetapkan variabel lingkungan DOMAIN seperti yang ditunjukkan pada contoh berikut:
```
echo $DOMAIN
```
Ini adalah 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 belum disetel, buat domain tersebut dengan domain yang ingin Anda gunakan untuk penginstalan hybrid Apigee. Contoh:
```
export DOMAIN=YOUR-DOMAIN.COM
```
Pastikan variabel lingkungan ENV_NAME telah ditetapkan ke lingkungan yang baru saja Anda buat di 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 Bagian 2: Penyiapan runtime hybrid: Sebelum memulai.