Menginstal Edge Microgateway

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

Edge Microgateway v. 3.2.x

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

Persyaratan hardware minimum

Edge Microgateway memerlukan konfigurasi hardware minimum berikut:

  • Pada virtual machine (VM), Edge Microgateway memerlukan minimal 1 core dan RAM minimal 256 MB. Proses Edge Microgateway sendiri membutuhkan RAM kurang dari 128 MB.
  • Pada container, Microgateway dapat digunakan dengan ukuran gambar kurang dari 100 MB.

Prasyarat

  • Apigee mendukung rilis LTS Aktif atau Pemeliharaan LTS di Windows, macOS, dan Linux. Lihat Software yang didukung untuk Apigee Edge Microgateway guna mengetahui informasi selengkapnya.
  • Windows mengharuskan OpenSSL untuk diinstal dan ditambahkan ke PATH.
  • Jika 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 file edgemicro yang dapat dieksekusi 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 bagian Menyiapkan dan mengonfigurasi Edge Microgateway.

Mengupgrade Edge Microgateway

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

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

Mengoperasikan Edge Microgateway di Windows as a Service

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?

Pada situs yang belum memiliki akses internet, administrator dapat menginstal dan mengelola 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 berguna. Dengan registry npm pribadi terinstal, Anda dapat mengikuti petunjuk penginstalan atau upgrade yang diberikan di atas.

Memulai

Jika Anda baru menggunakan Edge Microgateway, bagian 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 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 ditetapkan secara default ke lokasi tempat node diinstal. Pada sebagian besar sistem, jenisnya adalah /usr/local. Di Windows, nilainya adalah %AppData%\npm. Nilai [prefix] dapat dikonfigurasi. Lihat npm-folders untuk informasi selengkapnya tentang lokasi penginstalan modul Node.js 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, di mana [prefiks] adalah awalan npm seperti yang dijelaskan dalam Di mana Edge Microgateway diinstal?
  2. Hapus atau arsipkan file log. Secara default, file edgemicro-*.log berada di /var/tmp/, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi Edge Microgateway jika ragu.
  3. Hapus atau arsipkan file konfigurasi runtime dan konfigurasi cache:
    ~/.edgemicro/*.yaml
    

Dukungan Kubernetes

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

Dukungan Docker

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

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