Bekerja dengan lingkungan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Bagian ini menjelaskan cara membuat, mengedit, dan menghapus lingkungan dengan Apigee.

Tentang lingkungan

Lingkungan adalah area terisolasi dalam organisasi tempat Anda dapat membuat dan deploy proxy API. Anda membuat lingkungan selama penyediaan, dan nantinya dapat menambahkan lingkungan lainnya ke organisasi Anda.

Lingkungan dan instance

Setiap lingkungan harus dilampirkan ke setidaknya satu instance Apigee. Instance adalah virtual machine khusus region. Dengan menambahkan lingkungan ke instance, instance tersebut akan memuat, men-deploy, dan menyalurkan proxy untuk lingkungan tersebut.

Instance atau instance yang dikaitkan dengan lingkungan harus cocok dengan region atau region dengan traffic terbanyak untuk lingkungan tersebut. Anda dapat menambahkan lingkungan ke instance atau memindahkannya ke instance lain jika ada lebih banyak traffic yang berada di region instance baru.

Untuk menyetel dan mengubah instance lingkungan, lihat Melampirkan atau menghapus lingkungan dari instance.

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah ditambahkan ke instance. Anda dapat dikenai biaya sebelum traffic API dimulai. Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan, lihat Contoh harga bayar sesuai penggunaan.

Membuat lingkungan

Anda dapat membuat lingkungan baru menggunakan UI Apigee atau Apigee API, seperti yang dijelaskan di bagian berikut. Sebelum memulai, penting untuk diperhatikan bahwa Apigee dan Apigee Hybrid memiliki batasan jumlah grup lingkungan dan lingkungan yang dapat Anda buat per organisasi dan per region. Untuk mengetahui detailnya, lihat Batasan: Lingkungan dan organisasi.

Membuat lingkungan baru di UI

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

Apigee di Konsol Cloud

Untuk membuat lingkungan baru di Apigee pada Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi sebelah kiri.
3. Di panel Environments, klik + Create Environment.
4. Di panel Create an environment, masukkan perintah berikut:
   • Pilih jenis lingkungan: Jika Anda adalah pelanggan Bayar sesuai penggunaan, klik Pilih untuk memilih jenis lingkungan yang ingin Anda buat: Dasar, Menengah, atau Komprehensif.

     Pemilihan jenis lingkungan tidak berlaku untuk pelanggan Langganan dan tidak akan muncul di UI.

   • Nama: Nama lingkungan terprogram. Name tidak dapat diubah setelah dibuat.

     Nama harus berisi antara 2 hingga 32 karakter yang dapat berupa huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung. Nama ini harus berbeda dari nama lingkungan lain di organisasi Anda.

   • Nama Tampilan: Nama untuk lingkungan yang ditampilkan di UI.
   • Deskripsi: opsional. Deskripsi lingkungan.
   • Instance: Opsional. Pilih instance Apigee yang akan memuat, men-deploy, dan menyalurkan traffic untuk lingkungan.
   • Grup lingkungan: Opsional. Pilih kotak centang untuk menambahkan lingkungan baru ke grup lingkungan yang ada. Klik Oke.
   • Jenis deployment: Pilih apakah Anda ingin men-deploy proxy API individual atau arsip lingkungan konfigurasi proxy API. Untuk mengetahui informasi selengkapnya, lihat Jenis deployment yang didukung.
     Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan tersebut dibuat.
5. Klik Create.

Catatan: Operasi untuk membuat lingkungan ini mungkin memerlukan waktu hingga lima menit jika lampiran instance ditentukan.

Setelah selesai, lingkungan baru akan ditampilkan dalam tabel di panel Environments.

Apigee Klasik

Untuk membuat lingkungan baru di UI Apigee klasik:

1. Buka UI Apigee di browser.
2. Pilih Admin > Environments > Overview di panel navigasi sebelah kiri.

   UI menampilkan kumpulan kartu, masing-masing mewakili lingkungan yang sudah ada:

   

3. Klik +LINGKUNGAN.

   Kotak dialog New environment menampilkan:

   

4. Masukkan informasi berikut di kotak dialog New Environment:
   1. Nama tampilan: Nama yang sesuai untuk lingkungan yang digunakan pada UI. Contoh, My Test Environment.

   2. Nama lingkungan: Nama terprogram untuk lingkungan. Nama harus terdiri dari huruf kecil, angka, dan tanda hubung. Nama ini harus diawali dengan huruf kecil dan tidak boleh diakhiri dengan tanda hubung. Sebagai contoh, test.

      Nama lingkungan tidak dapat diubah setelah dibuat.

   3. Deskripsi (opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat.
   4. Jenis deployment (Pratinjau): Pilih apakah Anda ingin men-deploy proxy API individual atau arsip lingkungan konfigurasi proxy API Anda. Untuk mengetahui informasi selengkapnya, lihat Jenis deployment yang didukung.
      Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan tersebut dibuat.

   Semua kolom kecuali Deskripsi wajib diisi.

5. Klik OK.

   Kartu menampilkan status Tertunda Penyediaan sementara Apigee membuat lingkungan baru, seperti yang ditunjukkan contoh berikut:

   

   Mungkin terdapat penundaan beberapa menit sebelum lingkungan baru disediakan.

   Setelah selesai, UI Apigee menampilkan lingkungan baru sebagai kartu dengan lingkungan lain yang telah Anda buat:

   

Setiap lingkungan baru harus dilampirkan ke instance Apigee dan grup lingkungan.

Jika lingkungan tidak ditambahkan ke instance selama pembuatan, Anda dapat melakukan langkah ini di UI Instance atau menggunakan API pembuatan lampiran Instance. Untuk contoh cara melakukannya menggunakan API, lihat Membuat lingkungan dalam dokumentasi penyediaan command line.

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah ditambahkan ke instance. Anda dapat dikenai biaya sebelum traffic API dimulai.

Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan penggunaan node, lihat Contoh harga bayar sesuai penggunaan.

Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan atribut yang diperbarui, lihat Contoh harga bayar sesuai penggunaan (atribut yang diperbarui).

Jika tidak menetapkan lingkungan baru ke grup selama pembuatan, Anda dapat mengikuti langkah-langkah di Menambahkan lingkungan ke grup lingkungan. Lingkungan yang tidak ditetapkan ke grup tidak memiliki nama host yang mengarah ke grup tersebut, sehingga tidak dapat diakses. Untuk mengetahui informasi selengkapnya, lihat Membuat grup lingkungan.

Jika Anda memiliki organisasi Apigee dengan penagihan Bayar sesuai penggunaan, Anda dapat mengaktifkan add-on Analisis API Apigee di lingkungan baru. Untuk informasi selengkapnya, lihat Mengelola add-on Analisis Apigee API.

Membuat lingkungan baru dengan Apigee API

Bagian ini menjelaskan cara membuat lingkungan baru menggunakan Apigee API.

Sebagian besar langkah dalam proses ini memicu operasi yang berjalan lama dan dapat memerlukan waktu beberapa menit.

Untuk membuat lingkungan baru dengan Apigee API:

1. Membuat lingkungan baru dengan Create environment API.
2. Lampirkan lingkungan ke instance runtime menggunakan Instances attachment API.
   Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah ditambahkan ke instance. Anda dapat dikenai biaya sebelum traffic API dimulai.

   Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan penggunaan node, lihat Contoh harga bayar sesuai penggunaan.

   Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan atribut yang diperbarui, lihat Contoh harga bayar sesuai penggunaan (atribut yang diperbarui).

3. Buat grup lingkungan jika Anda belum memilikinya. Untuk melakukannya, gunakan Create environment groups API.
4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

   Penambahan lingkungan ke grup membuat proxy di lingkungan tersebut dapat dirutekan melalui nama host di grup.

Untuk informasi mendetail dan contoh penggunaan Apigee API untuk membuat dan melampirkan lingkungan baru, lihat Membuat lingkungan dalam petunjuk penyediaan command line.

Mengedit lingkungan

Bagian ini menjelaskan cara mengedit lingkungan yang ada di UI Apigee dan dengan Apigee API.

Mengedit lingkungan di UI Apigee

Anda dapat mengubah properti lingkungan yang sudah ada berikut di UI Apigee:

• Nama tampilan: Masukkan nama tampilan baru untuk lingkungan.
• Deskripsi: Masukkan deskripsi baru untuk lingkungan tersebut.
• Environment group: Hapus centang dari kotak yang dipilih sebelumnya lalu pilih kotak centang untuk grup lingkungan baru.

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

Apigee di Konsol Cloud

Untuk mengedit lingkungan di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi sebelah kiri.
3. Di baris lingkungan yang ingin diedit, klik menu tiga titik pada bagian Tindakan dan pilih Edit.
4. Pada dialog Edit Environment, buat perubahan yang Anda inginkan di kolom Display name atau Description.
5. Dalam kotak daftar Environment group, Anda dapat mengosongkan kotak centang yang sebelumnya dipilih dan mencentang kotak untuk grup lingkungan baru.
6. Klik Update untuk menyimpan perubahan.

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

Apigee Klasik

Untuk mengedit lingkungan di UI Apigee klasik

1. Buka UI Apigee di browser.
2. Pilih Lingkungan.

3. Cari kartu untuk lingkungan yang ingin Anda edit.

   Contoh berikut menampilkan kartu untuk empat lingkungan yang berbeda:

   

4. Klik panel lingkungan.

   UI Apigee menampilkan detail tentang lingkungan tersebut di tampilan About:

   

5. Klik Edit di tampilan Tentang.

   Kotak dialog Edit Environment akan menampilkan:

   

6. Edit nilai di kolom Display name dan Description.
7. Klik Save.

Mengedit lingkungan dengan Apigee API

Untuk mengedit lingkungan yang ada dengan Apigee API, gunakan Get environment API untuk mendapatkan daftar properti saat ini yang dapat Anda ubah, dan Update environment API untuk menetapkan atau mengubahnya.

Mengonfigurasi penerusan proxy di lingkungan

Untuk mengonfigurasi forward proxy, tetapkan nilai forwardProxyUri untuk lingkungan menggunakan environments API.

Penting: Saat mengonfigurasi proxy penerusan untuk penginstalan hybrid, gunakan fungsi proxy penerusan hybrid yang dijelaskan dalam Mengonfigurasi proxy penerusan untuk proxy API, bukan petunjuk yang diberikan di sini.

Menonaktifkan proxy penerusan untuk proxy di lingkungan

Jika traffic untuk target tertentu dari proxy API harus langsung menuju ke target backend, dengan mengabaikan proxy penerusan, lalu tetapkan properti berikut di TargetEndpoint untuk mengganti proxy penerusan HTTP:

<Property name="use.proxy">false</Property>

Untuk mengetahui informasi selengkapnya tentang cara menetapkan properti TargetEndpoint, termasuk cara mengonfigurasi koneksi ke endpoint target, lihat Referensi properti endpoint.

Tetapkan use.proxy ke "true" untuk setiap TargetEndpoint yang ingin Anda lalui melalui proxy penerusan HTTP:

<Property name="use.proxy">true</Property>

Menghapus lingkungan

Sebelum menghapus lingkungan, pastikan untuk mempertimbangkan poin penting berikut:

• Anda harus menghapus semua peta nilai kunci dan entri nilai kunci sebelum menghapus lingkungan. Jika tidak, jika Anda membuat ulang lingkungan, operasi entri peta nilai kunci akan mengalami perbedaan enkripsi/dekripsi.
• Saat Anda menghapus lingkungan yang telah mengaktifkan add-on Analisis Apigee API, data analisis untuk lingkungan tersebut juga akan dihapus. Jika Anda ingin menyimpan data analisis untuk lingkungan apa pun, sebaiknya ekspor dan simpan data Anda di lokasi lain. Untuk mengetahui informasi selengkapnya tentang cara menyimpan data, lihat artikel Mengekspor data dari Analytics. Untuk mempelajari dampak penghapusan lingkungan terhadap data Analisis API Apigee lebih lanjut, lihat Mengelola data Analisis API Apigee

Menghapus lingkungan dengan UI Apigee

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

Apigee di Konsol Cloud

Cara menghapus lingkungan di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi sebelah kiri.
3. Di baris lingkungan yang ingin diedit, klik menu tiga titik pada bagian Tindakan dan pilih Hapus.

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

Apigee Klasik

1. Buka UI Apigee di browser.

2. Pilih Admin > Lingkungan > Ringkasan.

   Apigee menampilkan sekumpulan kartu, yang masing-masing merepresentasikan lingkungan dalam organisasi Apigee Anda.

3. Cari kartu untuk lingkungan yang ingin Anda hapus.

4. Klik menu lingkungan, lalu pilih Hapus.

   Apigee menampilkan dialog konfirmasi.

5. Klik OK untuk menghapus lingkungan.

   Kartu lingkungan di UI menampilkan label Penghapusan Menunggu Persetujuan, sementara Apigee menghapus lingkungan.

   Mungkin ada penundaan beberapa menit sebelum penghapusan selesai.

Menghapus lingkungan dengan Apigee API

Untuk menghapus lingkungan, gunakan Delete environment API.