Bekerja dengan lingkungan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

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

Tentang lingkungan

Sebuah environment adalah area terisolasi dalam organisasi tempat Anda dapat buat dan deploy proxy API. Anda membuat lingkungan selama penyediaan, dan dapat menambahkan lebih banyak lingkungan ke organisasi Anda?

Lingkungan dan instance

Setiap lingkungan harus dilampirkan ke setidaknya satu instance Apigee. Channel adalah virtual machine khusus region. Menyertakan lingkungan ke instance berarti instance memuat, men-deploy, dan menyalurkan proxy untuk lingkungan.

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

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

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dilampirkan ke hanya memerlukan satu instance. Tagihan dapat dikenakan sebelum traffic API dimulai. Untuk selengkapnya informasi 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 lingkungan dan grup lingkungan yang dapat Anda buat per organisasi dan per region. Untuk mengetahui detailnya, lihat Batasan: Lingkungan dan organisasi.

Membuat lingkungan baru di UI

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

Apigee di Konsol Cloud

Untuk membuat lingkungan baru di Apigee di Konsol Cloud:

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

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

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

     Nama harus terdiri dari 2 hingga 32 karakter yang dapat berupa huruf kecil, angka, atau tanda hubung. Nama harus dimulai dengan huruf dan tidak boleh diakhiri dengan tanda hubung. Nama tersebut harus berbeda dari nama lingkungan lainnya di organisasi Anda?

   • Display Name: 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 menerapkan 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 boleh berubah setelah lingkungan dibuat.
5. Klik Create.

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

Setelah selesai, lingkungan baru akan ditampilkan dalam tabel di bagian Environments Google Analytics.

Apigee Klasik

Untuk membuat lingkungan baru di UI Apigee klasik:

1. Buka UI Apigee di browser.
2. Pilih Admin > Lingkungan > Ringkasan di panel navigasi sebelah kiri.

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

   

3. Klik +LINGKUNGAN.

   Kotak dialog Lingkungan baru akan menampilkan:

   

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

   2. Nama lingkungan: Nama terprogram untuk lingkungan. Nama harus terdiri dari huruf kecil, angka, dan tanda hubung. 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 penerapan (Pratinjau): Pilih apakah Anda ingin menerapkan 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 boleh berubah setelah lingkungan dibuat.

   Semua kolom kecuali Description wajib diisi.

5. Klik Oke.

   Kartu tersebut menampilkan status Pending Provisioning sementara Apigee membuat lingkungan baru, sebagai contoh berikut menunjukkan:

   

   Mungkin ada penundaan beberapa menit sebelum lingkungan baru disediakan.

   Setelah selesai, UI Apigee akan 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 dikaitkan ke instance selama pembuatan, Anda dapat melakukan langkah ini di UI Instance atau menggunakan Instances attachment create API. Untuk contoh cara melakukan hal ini dengan menggunakan API, lihat Buat lingkungan kustom dalam dokumentasi penyediaan command line.

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dilampirkan ke hanya memerlukan satu instance. Tagihan dapat dikenakan sebelum traffic API dimulai.

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

Jika Anda 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 selengkapnya informasi tambahan, lihat Membuat grup lingkungan.

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

Menciptakan 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. Buat 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 dilampirkan ke hanya memerlukan satu instance. Tagihan dapat dikenakan sebelum traffic API dimulai.

   Untuk 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 Buat API grup lingkungan.
4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

   Melampirkan lingkungan ke grup membuat proxy di lingkungan tersebut dapat dirutekan melalui nama {i>host<i} dalam grup.

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

Mengedit lingkungan

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

Edit lingkungan di UI Apigee

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

• Nama tampilan: Masukkan nama tampilan baru untuk lingkungan.
• Deskripsi: Masukkan deskripsi baru untuk lingkungan.
• Environment group: Hapus centang dari kotak yang sebelumnya dipilih, 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. Tujuan pada dua tab pertama di bawah ini menjelaskan cara menggunakan Apigee di Konsol Cloud atau Apigee klasik.

Apigee di Konsol Cloud

Untuk mengedit lingkungan di Apigee di Konsol Cloud:

1. Buka halaman Apigee di konsol.

   Buka Apigee

2. Pilih project dengan lingkungan yang ingin Anda perbarui.
3. Pilih Pengelolaan > Lingkungan di panel navigasi sebelah kiri.
4. Di baris di lingkungan yang ingin Anda edit, klik menu tiga titik di Tindakan dan pilih Edit. Dialog Edit lingkungan akan ditampilkan.
5. Pilih jenis lingkungan: Jika Anda adalah pelanggan Bayar sesuai penggunaan, pilih opsi di bagian Pilih jenis lingkungan untuk mengubah jenis lingkungan. Opsi mencakup Dasar, Menengah, atau Komprehensif.

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

6. Anda dapat membuat perubahan yang diperlukan di kolom Nama tampilan atau Deskripsi.
7. Di kotak daftar Grup lingkungan, Anda dapat menghapus centang dari kotak yang sebelumnya dipilih, lalu memilih kotak centang untuk {i>new environment group<i}.
8. Klik Update untuk menyimpan perubahan.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit untuk diselesaikan.

Apigee Klasik

Untuk mengedit lingkungan di UI Apigee klasik

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

3. Temukan 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 dalam tampilan Tentang:

   

5. Klik Edit di tampilan Tentang.

   Kotak dialog Edit Lingkungan akan menampilkan:

   

6. Edit nilai di Nama tampilan dan Deskripsi kolom.
7. Klik Simpan.

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 mengatur atau mengubahnya.

Mengonfigurasi penerusan proxy pada lingkungan

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

Penting: Saat mengonfigurasi forward proxy untuk hybrid penginstalan, gunakan fungsi {i> hybrid forward proxy<i} yang dijelaskan di Mengonfigurasi forward proxy untuk proxy API bukan petunjuk yang diberikan di sini.

Menonaktifkan penerusan proxy untuk proxy di lingkungan

Jika lalu lintas untuk target spesifik dari proxy API harus langsung mengarah ke target backend, proxy, lalu atur properti berikut di TargetEndpoint untuk mengganti penerusan HTTP {i>proxy<i}:

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

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

Tetapkan use.proxy ke "benar" untuk TargetEndpoint mana pun yang ingin Anda jalankan proxy penerusan HTTP:

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

Menghapus lingkungan

Sebelum menghapus lingkungan, pastikan untuk mempertimbangkan hal-hal 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 dengan Apigee API Analytics add-on yang aktif, data analisis untuk lingkungan tersebut juga akan dihapus. Jika Anda ingin mempertahankan data analytics untuk lingkungan apa pun, sebaiknya ekspor dan simpan data di lokasi lain. Untuk informasi selengkapnya tentang cara menyimpan data Anda, lihat Mengekspor data dari Analytics. Untuk mempelajari lebih lanjut dampak penghapusan lingkungan terhadap Analisis API Apigee data, lihat Mengelola data Analisis API Apigee

Menghapus lingkungan dengan UI Apigee

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

Apigee di Konsol Cloud

Untuk menghapus lingkungan di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Pengelolaan > Lingkungan di panel navigasi sebelah kiri.
3. Di baris di lingkungan yang ingin Anda edit, klik menu tiga titik di Tindakan dan pilih Hapus.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit untuk diselesaikan.

Apigee Klasik

1. Buka UI Apigee di browser.

2. Pilih Admin > Lingkungan > Ringkasan.

   Apigee menampilkan serangkaian kartu, yang masing-masing mewakili lingkungan dalam Organisasi Apigee.

3. Cari kartu untuk lingkungan yang ingin Anda hapus.

4. Klik menu lingkungan dan pilih Hapus.

   Apigee menampilkan dialog konfirmasi.

5. Klik Oke untuk menghapus lingkungan.

   Kartu lingkungan di UI menampilkan label Pending Deletion saat Apigee menghapus lingkungan.

   Mungkin ada penundaan beberapa menit sebelum penghapusan selesai.

Menghapus lingkungan dengan Apigee API

Untuk menghapus lingkungan, gunakan Delete lingkungan API.