Mengelola instance

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Instance adalah mesin virtual tempat project API dan layanan terkait disimpan. {i>Instance <i}berkaitan dengan region. Biasanya, Anda akan memulai dengan satu instance dan menambahkan instance baru saat organisasi Anda diperluas ke lebih banyak region. Bagian ini menjelaskan cara:

• Membuat instance baru.
• Melampirkan atau menghapus lingkungan dari instance.
• Mengedit daftar project yang diterima
• Mengaktifkan atau menonaktifkan log akses masuk untuk instance.
• Menghapus instance.

Catatan: Organisasi evaluasi hanya dapat memiliki satu instance (region). Untuk memperluas jangkauan ke luar satu region dan instance, Anda harus memiliki organisasi berbayar. Hak langganan Anda membatasi jumlah instance (wilayah) yang dapat ditambahkan. Anda dapat menambahkan lebih banyak instance (region) dengan membeli Paket Org. Untuk mengetahui informasi selengkapnya, lihat Hak langganan.

Buat instance baru

Untuk membuat instance baru, Anda dapat menggunakan Instances API atau UI Apigee. Setiap instance memerlukan:

• kunci enkripsi {i>disk <i}untuk jaringan. Apigee merekomendasikan agar Anda juga membuat key ring terpisah untuk instance baru. Untuk mengetahui informasi selengkapnya, lihat Tentang kunci enkripsi Apigee.
• rentang CIDR /22 dan /28 yang tidak tumpang-tindih untuk peering jaringan. Rentang tidak dapat dibagikan antar-instance.

Catatan: Anda harus memiliki organisasi berbayar untuk menambahkan instance. Akun evaluasi dibatasi pada satu region atau instance dan tidak dapat diperluas ke satu detik. Hak Anda membatasi jumlah wilayah yang dapat ditambahkan. Untuk mengetahui informasi selengkapnya, lihat Harga Apigee.

Apigee di Konsol Cloud

Penting: Topik ini hanya berlaku untuk organisasi yang dibuat dengan peering VPC diaktifkan. Lihat juga Opsi jaringan Apigee.

Untuk membuat instance baru di Apigee di Cloud Console:

1. Buka UI Apigee di Konsol Cloud di browser Anda.

2. Pilih Management > Instances. Panel Instances menampilkan daftar instance yang ada.

3. Klik + Buat. Mungkin ada penundaan saat UI menentukan apakah organisasi Anda memiliki hak yang tepat untuk membuat instance baru.

   Halaman Create new instance akan ditampilkan.

4. Masukkan detail tentang instance baru Anda di kolom:

   Kolom	Diperlukan	Deskripsi
   Runtime hosting location	Diperlukan	Pilih region tempat Anda ingin membuat instance baru. Anda tidak dapat membuat instance baru di region yang sudah memiliki instance. Untuk informasi selengkapnya tentang cara bekerja dengan beberapa region, lihat Menggunakan beberapa region.
   Name	Diperlukan	Masukkan ID instance baru. Nilai defaultnya adalah nama region hosting runtime yang Anda pilih, tetapi Anda dapat mengubahnya menjadi nama bermakna apa pun yang Anda inginkan, selama Anda mengikuti aturan penamaan: Panjang minimum 2. Panjang maksimum 32. Hanya gunakan huruf kecil, angka, dan tanda hubung (dengan mengikuti pola /^[a-z0-9\-]+$/). Harus diawali dengan huruf; tidak memiliki angka di depan atau tanda hubung. Harus diakhiri dengan angka atau huruf; tidak boleh memiliki tanda hubung. Harus unik di seluruh organisasi Anda.
   IP range allocation	Diperlukan	Tentukan cara mengalokasikan rentang IP. Pilih di antara opsi berikut: Catatan: Setelah dibuat, Anda tidak dapat mengubah rentang IP nanti. Jika perlu mengubah rentang, Anda harus membuat instance baru. Otomatis (Direkomendasikan) - Apigee memilih rentang CIDR yang tersedia dengan ukuran awalan /22. Anda tidak perlu melakukan tindakan apa pun. Kustom - Dalam kasus penggunaan lanjutan, Anda mungkin harus menentukan secara tepat rentang IP mana yang akan digunakan Apigee. Untuk kasus ini, Anda menentukan rentang IP kustom, dan harus memiliki ukuran awalan /22. Rentang ini harus tersedia sebagai bagian dari koneksi pribadi antara project Anda dan Apigee.
   Disk encryption key	Diperlukan	Di bagian Kunci enkripsi disk, pilih kunci enkripsi yang dikelola pelanggan. Jika kunci sudah ada, Anda dapat memilihnya. Wizard mencantumkan semua kunci di lokasi yang sama dengan region hosting runtime di semua key ring. Jika tidak ada kunci, atau jika Anda tidak ingin menggunakan kunci yang ada, Anda dapat membuat kunci baru dari dalam wizard. Untuk membuat kunci: Klik Create key. Pilih key ring, atau jika tidak ada, aktifkan Buat key ring, lalu masukkan nama key ring dan pilih lokasi key ring. Nama key ring dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Key ring tidak dapat diganti namanya atau dihapus. Klik Lanjutkan. Buat kunci. Masukkan nama dan tingkat perlindungan. Perhatikan bahwa nama kunci dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kunci tidak dapat diganti namanya atau dihapus. Untuk tingkat perlindungan, Software adalah pilihan yang baik. Opsi ini adalah opsi default yang sama dengan yang digunakan oleh Cloud KMS. Namun, Anda dapat mengubahnya jika ingin. Klik Lanjutkan dan tinjau pilihan Anda. Klik Create. Klik Grant untuk memberi akun layanan izin enkripsi/dekripsi dengan kunci yang dipilih.
   Environments	Opsional	Pilih lingkungan yang ingin Anda lampirkan ke instance ini. Untuk melakukannya, klik menu drop-down Environments dan pilih kotak centang di samping lingkungan yang ingin Anda lampirkan. Anda dapat melakukannya untuk lingkungan sebanyak yang Anda inginkan. Lalu klik OK. Perlu diketahui bahwa semua lingkungan instance akan dihitung dalam jumlah total lingkungan yang dapat Anda alokasikan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan. Menambahkan lingkungan saat membuat instance baru bersifat opsional. Jika tidak menambahkannya sekarang, Anda dapat menggunakan Instances attachment create API atau UI untuk menambahkan dan menghapusnya nanti. Lihat Melampirkan atau menghapus lingkungan.
   Accepted projects	Opsional	Klik Tambahkan project yang diterima untuk memilih satu atau beberapa project Cloud. Project yang dipilih dapat terhubung secara pribadi ke lampiran layanan untuk instance Anda. Secara default, project yang terkait dengan organisasi Apigee Anda disertakan dalam daftar ini.
   Enable logging	Opsional	Klik tombol Enable logging guna mengaktifkan log akses masuk Cloud Logging untuk instance tersebut. Dengan fitur ini, Anda dapat melihat log yang dihasilkan oleh gateway masuk di infrastruktur Apigee, seperti Load Balancer Aplikasi eksternal atau gateway Anthos, untuk membantu memecahkan masalah panggilan API Apigee. Untuk mengetahui informasi selengkapnya, lihat Logging log akses Apigee
   Filter	Opsional	Pilih kode respons HTTP dari kotak response code agar berfungsi sebagai filter untuk log akses masuk. Jika Anda ingin menyertakan semua log, apa pun kode respons HTTP, pilih None (all HTTP responses). Untuk membuat filter kustom, pilih Custom dan masukkan filter dalam format berikut: status_code > XX && status code <= YY Contoh: status_code >= 500 && status_code < 504

   Jika organisasi Anda tidak dapat membuat instance baru, hubungi Bagian Penjualan Apigee.

5. Klik Create.

   Apigee memulai operasi yang berjalan lama dan dapat diselesaikan dalam waktu 20 menit atau lebih. Setelah selesai, instance baru akan muncul dalam daftar instance di UI Instances.

API Apigee

Jika Apigee disediakan tanpa peering VPC, lihat Membuat instance runtime dalam langkah-langkah penyediaan peering non-VPC.

Jika Apigee disediakan dengan peering VPC, lihat Membuat instance runtime dalam langkah-langkah penyediaan peering VPC.

Melampirkan atau menghapus lingkungan dari instance

Saat membuat lingkungan menggunakan UI Apigee di Konsol Google Cloud, Anda memiliki opsi untuk menetapkan lingkungan ke instance yang ada. Untuk mengetahui informasi selengkapnya, lihat Membuat lingkungan baru di UI.

Jika tidak melampirkan lingkungan ke instance selama pembuatan lingkungan, atau ingin menghapus lingkungan dari instance, Anda dapat mengikuti langkah-langkah berikut. Untuk mengetahui informasi selengkapnya tentang lingkungan dan instance, lihat Lingkungan dan instance.

Untuk melampirkan atau menghapus lingkungan dari instance menggunakan Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser Anda.
2. Pilih Management > Instances.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. Di halaman Edit Instance, klik kolom Environments (optional) dan pilih lingkungan yang ingin Anda lampirkan ke instance, atau batalkan pilihan lingkungan yang ingin dihapus.
6. Klik OK.
7. Klik Simpan untuk menyimpan perubahan.

Selain menggunakan UI, Anda juga dapat melampirkan lingkungan ke instance menggunakan API pembuatan lampiran instance. Sebagai contoh, lihat Membuat lingkungan dalam dokumentasi penyediaan command line.

Edit daftar project yang diterima

Anda dapat menambahkan atau menghapus project dari daftar Project yang diterima:

1. Buka UI Apigee di Konsol Cloud di browser Anda.
2. Pilih Management > Instances.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. Di bagian Accepted projects pada halaman Edit Instance, klik ikon hapus di samping project untuk menghapusnya. Untuk menambahkan project, klik Tambahkan project yang diterima, lalu masukkan ID project yang akan ditambahkan.
6. Klik Simpan untuk menyimpan perubahan.

Mengaktifkan atau menonaktifkan log akses masuk untuk instance

Setelah membuat instance, Anda dapat mengaktifkan dan menonaktifkan log akses masuk Cloud Logging untuk instance tersebut:

1. Buka UI Apigee di Konsol Cloud di browser Anda.
2. Pilih Management > Instances.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. halaman Edit Instance, klik tombol Enable logging untuk menonaktifkan fitur tersebut.
6. Klik Simpan untuk menyimpan perubahan.

Menghapus instance

Anda dapat menggunakan UI Apigee di Cloud Console untuk menghapus instance yang ada, seperti yang dijelaskan di bagian ini. Atau, Anda dapat menghapus instance menggunakan Instances API.

Hanya satu instance Apigee yang dapat berada di region Google Cloud tertentu. Ketika instance dihapus, instance tersebut akan dihapus sepenuhnya dari regionnya. Lihat juga penginstalan multi-region.

Peringatan: Saat Anda menghapus instance, semua data yang terkait dengan instance tersebut akan hilang. Langkah ini tidak dapat dibatalkan. Namun, perlu diperhatikan bahwa jika Anda memiliki beberapa instance, misalnya dalam penginstalan multi-region, data hanya akan hilang jika Anda menghapus semua instance. Sebelum menghapus instance terakhir, pastikan untuk mengekstrak dan mencadangkan data apa pun yang ingin Anda hapus.

Catatan: Menghapus instance akan menghapus pengaitan untuk semua lingkungan yang terpasang. Anda mungkin perlu memindahkan lingkungan yang terpasang ke instance baru dengan Melampirkan dan menghapus lingkungan dari instance sebelum menghapus instance. Semua lingkungan harus dilampirkan ke setidaknya satu instance agar proxy-nya dapat berfungsi.

Data berikut disimpan dalam instance Apigee dan akan dihapus jika Anda menghapus instance:

Jenis data	Deskripsi
Sistem pengelolaan kunci (KMS)	Data KMS mencakup produk API, developer, aplikasi developer, token OAuth (termasuk token akses, token refresh, dan kode otorisasi), serta kunci API. Gunakan kebijakan AccessEntity atau Apigee API terkait untuk mengambil data yang ingin disimpan.
Peta nilai kunci (KVM)	Data apa pun yang dapat dibuat atau dikelola dengan kebijakan KVM. Lihat Mengambil KVM.
Kuota	Definisi kuota, bucket, dan penghitung.
Cache lingkungan	Semua data dalam cache.

Untuk menghapus instance Apigee menggunakan UI Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser Anda.

2. Pilih Management > Instances.

3. Klik instance yang ingin Anda hapus.
4. Di halaman Instance Details, klik Delete.