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 hybrid Apigee atau CLI. Sebaiknya gunakan UI untuk langkah-langkah ini agar Anda dapat memahaminya.
UI hybrid Apigee
Untuk mengakses UI hybrid dan menambahkan lingkungan, lakukan langkah-langkah berikut:
- Buka UI Apigee. Jika ini adalah pertama kalinya Anda login, sistem hybrid akan menampilkan dialog izin. Jika Anda diminta memilih dari beberapa akun, pilih akun yang memiliki project yang dibuat di Langkah 2: Buat project Google Cloud. Lalu klik Izinkan.
-
Pastikan organisasi yang mengaktifkan sistem hybrid 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:
- 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.
- Nama lingkungan (Wajib): Nama terprogram untuk lingkungan; juga dikenal
sebagai ID lingkungan.
Misalnya, "my-environment" atau "test".
Display name dan Environment name boleh berbeda.
- Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat saat penginstalan awal".
- Klik Create.
Apigee membuat lingkungan baru dan menunjukkan bahwa lingkungan tersebut Tertunda Penyediaan:
Dalam beberapa saat, setelan akan berubah menjadi disediakan:
Namun, Anda belum selesai. Anda juga harus menambahkan lingkungan baru ke file
overrides.yaml
runtime — tetapi Anda harus menginstal runtime tersebut terlebih dahulu. Jadi, jangan terburu-buru.
Browser Anda akan membuka halaman landing utama UI hybrid:
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
menggunakan perintah berikut:Linux / MacOS
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 untuk elemen-elemen lingkungan tersebut. 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 hubung, serta angka, dan harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai ID dan tidak dapat diubah setelah dibuatexport ENV_NAME=environment_name
ENV_DISPLAY_NAME
(Wajib) adalah nama lingkungan Anda yang mudah digunakan. Nilai ini tidak harus unik, dan dapat berisi spasi serta karakter khusus. Misalnya, "Contoh Lingkungan Saya".ENV_DISPLAY_NAME=friendly_name
ORG_NAME
(Wajib) adalah ID organisasi Anda. Pastikan Anda telah menentukan variabel lingkunganORG_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 petunjuk Apigee Hybrid".ENV_DESCRIPTION=description_text
- Kirim permintaan
POST
yang diautentikasi ke Create environment API.Contoh berikut menampilkan 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"
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 adalahIN_PROGRESS
. Proses ini dapat memerlukan waktu beberapa menit.
Membuat grup lingkungan
Sekarang buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat. Grup lingkungan memungkinkan Anda mengelompokkan lingkungan bersama, dan memberikan nama host untuk mengarahkan proxy yang di-deploy ke lingkungan dalam grup. Anda harus membuat minimal satu grup lingkungan, dan harus menetapkan minimal satu nama host ke grup tersebut. Untuk ringkasan tentang grup lingkungan, lihat Tentang lingkungan dan grup lingkungan.
UI hybrid Apigee
Untuk membuat grup lingkungan menggunakan UI Apigee, lakukan langkah-langkah berikut:
- Buka UI Apigee.
- Pastikan organisasi yang mengaktifkan sistem hybrid dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down.
-
Klik Admin > Lingkungan > Grup.
Tampilan Environment Groups Overview akan ditampilkan dengan grup lingkungan yang dibuat:
-
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 sepertimy-proxies.example.com
.Jika Anda perlu mendaftarkan domain, lihat registrar domain seperti Google Domains.
- Klik Add (+).
- Dialog Add environment akan ditampilkan.
- Pilih lingkungan dari daftar, lalu klik Tambahkan.
Browser Anda akan membuka halaman landing utama UI campuran.
gcloud CLI
Untuk membuat grup lingkungan menggunakan command line, lakukan langkah-langkah berikut:
-
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
- Pastikan Anda telah menetapkan variabel lingkungan DOMAIN seperti yang ditampilkan dalam contoh berikut:
echo $DOMAIN
Ini adalah 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 sepertimy-proxies.example.com
.Jika belum disetel, buat domain dengan domain yang akan digunakan untuk penginstalan hybrid Apigee. Contoh:
export DOMAIN=domain-name.com
- Pastikan Anda telah menetapkan variabel lingkungan ENV_NAME ke lingkungan yang baru saja dibuat 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.