Mengelola instance

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

Lihat dokumentasi Apigee Edge.

Instance adalah virtual machine tempat project API dan layanan terkait disimpan. Instance sesuai dengan wilayah. Biasanya, Anda memulai dengan satu instance dan menambahkan instance baru saat organisasi Anda berkembang ke lebih banyak region. Bagian ini menjelaskan cara:

Buat instance baru

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

  • kunci enkripsi disknya sendiri 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.

Apigee di Konsol Cloud

Untuk membuat instance baru di Apigee di konsol Cloud:

  1. Di Google Cloud konsol, buka halaman Management > Instances.

    Buka Instance

    Panel Instances menampilkan daftar instance yang ada.

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

    Halaman Create new instance akan ditampilkan.

  3. Masukkan detail tentang instance baru Anda di kolom:
    Kolom Diperlukan Deskripsi
    Runtime hosting location Wajib Pilih region tempat Anda ingin membuat instance baru. Anda tidak dapat membuat instance baru di region yang sudah memiliki instance. Untuk mengetahui informasi selengkapnya tentang cara bekerja dengan beberapa region, lihat Menggunakan beberapa region.
    Name Wajib

    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 (mengikuti pola /^[a-z0-9\-]+$/).
    • Harus diawali dengan huruf; tidak memiliki angka atau tanda hubung di depannya.
    • Harus diakhiri dengan angka atau huruf; tidak memiliki tanda hubung di akhir.
    • Harus unik di seluruh organisasi Anda.
    IP range allocation Wajib

    Tentukan cara Anda ingin mengalokasikan rentang IP. Pilih salah satu opsi berikut:

    • Otomatis (Direkomendasikan) - Apigee memilih rentang CIDR yang tersedia dengan ukuran awalan /22. Anda tidak perlu melakukan tindakan lebih lanjut.
    • Kustom - Dalam kasus penggunaan lanjutan, Anda mungkin perlu menentukan dengan tepat rentang IP yang ingin digunakan Apigee. Untuk kasus ini, Anda menentukan rentang IP kustom, dan rentang IP tersebut harus memiliki ukuran awalan /22. Rentang harus tersedia sebagai bagian dari koneksi pribadi antara project Anda dan Apigee.
    Disk encryption key Wajib

    Di bagian Disk encryption key, 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 kunci tidak ada, atau jika Anda tidak ingin menggunakan kunci yang ada, Anda dapat membuat kunci baru dari dalam wizard. Untuk membuat kunci:

    1. Klik Create key.
    2. Pilih key ring, atau jika tidak ada, aktifkan Buat key ring dan 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.
    3. Klik Lanjutkan.
    4. 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. Default ini sama dengan yang digunakan oleh Cloud KMS; namun, Anda dapat mengubahnya jika menginginkannya.
    5. Klik Lanjutkan dan tinjau pilihan Anda.
    6. Klik Buat.
    7. Klik Grant untuk memberikan izin akun layanan untuk mengenkripsi/mendekripsi dengan kunci yang dipilih.
    Environments Opsional

    Pilih lingkungan yang ingin Anda lampirkan ke instance ini. Untuk melakukannya, klik menu drop-down Lingkungan, lalu centang kotak di samping lingkungan yang ingin Anda lampirkan. Anda dapat melakukannya untuk sebanyak mungkin lingkungan yang Anda inginkan. Kemudian, klik OK.

    Perhatikan bahwa lingkungan semua instance dihitung dalam jumlah total lingkungan yang dapat Anda alokasikan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.

    Menambahkan lingkungan saat Anda membuat instance baru bersifat opsional. Jika Anda tidak menambahkannya sekarang, Anda dapat menggunakan API pembuatan lampiran Instance 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 untuk mengaktifkan log akses masuk Cloud Logging untuk instance. Fitur ini memungkinkan Anda melihat log yang dihasilkan oleh gateway ingress di infrastruktur Apigee, seperti Load Balancer Aplikasi eksternal atau gateway Anthos, untuk membantu memecahkan masalah panggilan API Apigee.

    Untuk mengetahui informasi selengkapnya, lihat Mencatat log akses Apigee
    Filter Opsional Pilih kode respons HTTP dari kotak kode respons untuk bertindak sebagai filter untuk log akses ingress.

    Jika Anda ingin menyertakan semua log, terlepas dari 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 Tim Penjualan Apigee.

  4. Klik Buat.

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

Apigee API

Jika Apigee disediakan tanpa peering VPC, lihat Membuat instance runtime dalam langkah-langkah penyediaan non-peering 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 Anda tidak melampirkan lingkungan ke instance selama pembuatan lingkungan, atau Anda 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 konsol Apigee di Cloud:

  1. Di Google Cloud konsol, buka halaman Management > Instances.

    Buka Instance

  2. Klik instance yang ingin diedit.

  3. Di halaman Instance details, klik Edit.
  4. Di halaman Edit Instance, klik kolom Environments (opsional) dan pilih lingkungan yang ingin Anda lampirkan ke instance, atau batalkan pilihan lingkungan yang ingin Anda hapus.
  5. Klik Oke.
  6. 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.

Mengedit daftar project yang diterima

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

  1. Di Google Cloud konsol, buka halaman Management > Instances.

    Buka Instance

  2. Klik instance yang ingin diedit.

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

Mengaktifkan atau menonaktifkan log akses ingress untuk instance

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

  1. Di Google Cloud konsol, buka halaman Management > Instances.

    Buka Instance

  2. Klik instance yang ingin diedit.

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

Menghapus instance

Anda dapat menggunakan UI Apigee 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. Saat Anda menghapus instance, 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 diurungkan. Namun, perhatikan bahwa jika Anda memiliki beberapa instance, seperti dalam penginstalan multi-region, data Anda hanya akan hilang jika Anda menghapus semua instance. Sebelum menghapus instance terakhir, pastikan untuk mengekstrak dan mencadangkan data yang tidak ingin Anda hilangkan.

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 Anda simpan.
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 yang di-cache.

Untuk menghapus instance Apigee menggunakan UI Apigee di konsol Cloud:

  1. Di Google Cloud konsol, buka halaman Management > Instances.

    Buka Instance

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