Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 3: 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 memberikan 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 Apigee atau API. Sebaiknya gunakan UI untuk langkah-langkah ini agar Anda dapat memahaminya.

UI Apigee

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

Buka UI Apigee. Jika ini adalah pertama kalinya Anda login, sistem hybrid akan menampilkan dialog izin. Jika diminta untuk memilih dari beberapa akun, pilih akun yang memiliki project Google Cloud yang Anda gunakan untuk menginstal Apigee Hybrid. Lalu klik Izinkan.

Browser Anda membuka halaman landing utama UI:

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

Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down, seperti yang ditunjukkan contoh berikut:
Klik Admin > Lingkungan > Ringkasan.

Tampilan Environments ditampilkan, tetapi belum memiliki 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 "pengujian". Tidak seperti Environment name, Display name dapat berisi 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 boleh 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 boleh berbeda.
3. Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat saat penginstalan awal".
Tetap gunakan nilai default lainnya dan klik Create.
Apigee membuat lingkungan baru.

Anda sekarang perlu membuat grup lingkungan dan menambahkan lingkungan baru ke grup.

API Apigee

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 menggunakan perintah berikut:
Linux / MacOS
```
export TOKEN=$(gcloud auth print-access-token)
```
Untuk memeriksa apakah token Anda sudah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo $TOKEN
```
Ini akan menampilkan token Anda sebagai string yang dienkode.
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Untuk memeriksa apakah token Anda sudah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo %TOKEN%
```
Ini akan menampilkan token Anda sebagai string yang dienkode.
Buat variabel lingkungan berikut:
Linux / MacOS
```
export ENV_NAME="YOUR_ENV_NAME"
```
Windows
```
set ENV_NAME="YOUR_ENV_NAME"
```
Dengan keterangan:
- ENV_NAME (Wajib) Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai ID dan tidak dapat diubah setelah pembuatan lingkungan.

Panggil Apigee API berikut:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

Pada permintaan pembuatan yang berhasil, Environments API akan merespons dengan pesan yang serupa 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.

Periksa untuk memastikan lingkungan berhasil dibuat:
```
curl -H "Authorization: Bearer $TOKEN" \
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"
```
Pada permintaan pembuatan yang berhasil, Environments API akan merespons dengan pesan yang serupa dengan berikut ini:
```
[
  "your-environment-name"
]
```

Membuat grup lingkungan

Sekarang buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat.

UI Apigee

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

Buka UI Apigee.

Browser Anda akan membuka halaman landing utama UI Apigee.

Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down.
Klik Admin > Lingkungan > Grup.
Tampilan Environment Groups Overview akan ditampilkan:
Klik +Environment Group.
Dialog Add an Environment Group akan ditampilkan.
Masukkan nama, lalu klik Tambahkan.
Tahan 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. Alamat ini harus berupa domain yang akses pengelolaannya Anda miliki. Nama host dapat berupa domain itu sendiri, seperti example.com atau dapat menyertakan subdomain seperti my-proxies.example.com.

Jika Anda perlu mendaftarkan domain, lihat registrar domain seperti Google Domains.

Jendela Edit Environment Group tidak menampilkan lingkungan yang ditetapkan

Klik Add (+) di kotak Environments.
Dialog Add environment akan ditampilkan.

Tambahkan dialog lingkungan yang mencantumkan lingkungan yang tersedia

Pilih lingkungan dari daftar, lalu klik Tambahkan.

API Apigee

Untuk membuat grup lingkungan menggunakan Apigee API:

Pada command line, dapatkan kredensial autentikasi gcloud menggunakan perintah berikut:

Linux / MacOS

TOKEN=$(gcloud auth print-access-token)

Windows

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

Buat variabel lingkungan berikut:
Linux / MacOS
```
export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
```
Windows
```
 data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
 data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"
```
Dengan keterangan:
- DOMAIN (Wajib) Ini adalah nama host yang akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini. Ini harus berupa domain yang Anda kelola. Alamat dapat berupa domain itu sendiri, seperti example.com atau dapat menyertakan subdomain seperti my-proxies.example.com. Jika tidak memiliki domain terkelola, Anda dapat memasukkan placeholder untuk saat ini. Anda dapat mengubah alamat domain di lain waktu.
- ENV_GROUP (Wajib) Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai ID dan tidak dapat diubah setelah dibuat.

Buat grup lingkungan:

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:

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"

Pastikan apakah grup lingkungan berhasil dibuat dengan perintah CURL berikut:

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Pada permintaan pembuatan yang berhasil, Environments Group API akan merespons dengan pesan yang serupa dengan berikut ini:

      {
        "environmentGroups": [
          {
            "name": "your_envgroup_hybrid",
            "hostnames": [
              "apigee.hybrid.com"
            ],
            "createdAt": "1677826235324",
            "lastModifiedAt": "1677826235324",
            "state": "ACTIVE"
          }
        ]
      }

Ambil lampiran terbaru untuk grup lingkungan yang baru dibuat menggunakan perintah CURL berikut:

curl -H "Authorization: Bearer $TOKEN" \ 
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

Pembuatan dan lampiran grup lingkungan berhasil jika hasilnya menampilkan nilai hash yang unik, seperti ditunjukkan dalam contoh output respons di bawah:

     
        {
          "environmentGroupAttachments": [
            {
              "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }

Langkah berikutnya

Untuk melanjutkan penginstalan, buka Bagian 2: Penyiapan runtime hybrid.