Menginstal Edge Microgateway

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Edge Microgateway v. 3.3.x

Topik ini menjelaskan cara menginstal atau meng-uninstal Edge Microgateway.

Persyaratan hardware minimum

Edge Microgateway memerlukan konfigurasi hardware minimum berikut:

  • Di mesin virtual (VM), Edge Microgateway memerlukan minimal 1 core dan RAM minimal 256 MB. Proses Edge Microgateway itu sendiri memerlukan RAM kurang dari 128 MB.
  • Di container, Microgateway dapat digunakan dengan ukuran image kurang dari 100 MB.

Prasyarat

  • Apigee mendukung rilis LTS Aktif atau LTS Pemeliharaan di Windows, macOS, dan Linux. Lihat Software yang didukung untuk Apigee Edge Microgateway untuk mengetahui informasi selengkapnya.
  • Windows mengharuskan OpenSSL diinstal dan ditambahkan ke PATH.
  • Jika Anda menggunakan Apigee Edge Private Cloud untuk mengonfigurasi dengan Edge Microgateway, Anda harus menjalankan Private Cloud versi 4.18.01 atau yang lebih baru.

Menginstal Edge Microgateway jika Anda memiliki koneksi internet

Bagian ini menjelaskan cara menginstal Edge Microgateway dan menginisialisasi konfigurasi default. Jika Anda beroperasi tanpa koneksi internet, lihat Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?.

  1. Instal Edge Microgateway versi terbaru dengan npm sebagai berikut. Perintah ini menginstal software dan menempatkan executable edgemicro di jalur Anda. 
    npm install edgemicro -g

    Untuk menginstal Edge Microgateway versi tertentu, Anda harus menentukan nomor versi dalam perintah penginstalan. Jika Anda tidak menentukan nomor versi, versi terbaru akan diinstal. Misalnya, untuk menginstal versi 3.1.5, gunakan perintah berikut. 

    npm install edgemicro@3.1.5 -g
  2. Lihat nomor versi aplikasi. Misalnya, jika Anda menginstal versi 3.1.5: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. Ikuti langkah-langkah penyiapan dan konfigurasi di Menyiapkan dan mengonfigurasi Edge Microgateway.

Mengupgrade Edge Microgateway

Untuk mengupgrade Edge Microgateway versi yang sebelumnya diinstal, lihat Mengupgrade Edge Microgateway jika Anda memiliki koneksi internet.

Apigee merekomendasikan Anda menguji konfigurasi yang ada dengan versi baru sebelum mengupgrade lingkungan produksi.

Mengoperasikan Edge Microgateway di Windows sebagai Layanan

Anda dapat mengoperasikan Edge Microgateway di Windows sebagai layanan. Untuk mengetahui detailnya, lihat Praktik terbaik untuk pengelolaan operasional Microgateway (edgemicro) di Windows di Komunitas Apigee.

Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?

Di situs yang tidak memiliki akses internet siap pakai, administrator dapat menginstal dan memelihara registry npm pribadi di jaringan internal Anda. Petunjuk untuk menyiapkan registry npm pribadi berada di luar cakupan panduan ini; namun, Anda dapat menelusuri dan menemukan petunjuk yang bermanfaat. Dengan registry pribadi npm yang diinstal, Anda dapat mengikuti petunjuk penginstalan atau upgrade yang diberikan di atas.

Memulai

Jika Anda baru menggunakan Edge Microgateway, Menyiapkan dan mengonfigurasi Edge Microgateway adalah tempat terbaik untuk memulai setelah Anda menyelesaikan penginstalan. Panduan penyiapan dan konfigurasi mencakup semua langkah yang perlu Anda lakukan untuk menginstal, mengonfigurasi, memulai, dan menggunakan instance Edge Microgateway.

Di mana lokasi Edge Microgateway diinstal?

Saat Anda menggunakan npm dengan opsi global (npm install -g edgemicro), software akan diinstal di [prefix]/lib/node_modules/edgemicro. Anda dapat menemukan nilai [prefix] dengan perintah ini:

npm config get prefix

Konfigurasi awalan secara default adalah lokasi tempat node diinstal. Di sebagian besar sistem, lokasi ini adalah /usr/local. Di Windows, lokasi ini adalah %AppData%\npm. Nilai [prefix] dapat dikonfigurasi. Lihat npm-folders untuk mengetahui informasi selengkapnya tentang lokasi modul Node.js diinstal secara default dan cara mengonfigurasi lokasi penginstalan.

Meng-uninstal Edge Microgateway

Jika Anda perlu menghapus Edge Microgateway:

  1. Hapus atau arsipkan direktori penginstalan [prefix]/lib/node_modules/edgemicro, dengan [prefix] adalah awalan npm seperti yang dijelaskan di Di mana lokasi Edge Microgateway diinstal?
  2. Hapus atau arsipkan file log. Secara default, edgemicro-*.log file berada di /var/tmp/, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi Edge Microgateway jika Anda ragu.
  3. Hapus atau arsipkan file konfigurasi runtime dan konfigurasi cache: 
    ~/.edgemicro/*.yaml

Dukungan Kubernetes

Anda dapat menggunakan Edge Microgateway untuk menyediakan pengelolaan API Apigee untuk layanan yang berjalan di cluster Kubernetes. Lihat Mengintegrasikan Edge Microgateway dengan ringkasan Kubernetes.

Dukungan Docker

Anda kini dapat mendownload rilis Edge Microgateway terbaru sebagai image Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest