Menginstal Edge Microgateway

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

Edge Microgateway v. 2.5.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

  • Anda harus menginstal Node.js versi 6.x LTS atau 8.x LTS di sistem Anda. Anda dapat memeriksa versi dengan menjalankan perintah berikut:
    node -v
    v6.9.1  
  • Windows mengharuskan OpenSSL diinstal dan ditambahkan ke PATH.
  • Jika menggunakan Apigee Edge Private Cloud untuk mengonfigurasi 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 melakukan inisialisasi konfigurasi default.

  1. Instal Edge Microgateway versi terbaru dengan npm sebagai berikut. Perintah ini menginstal software dan menempatkan file yang dapat dieksekusi 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 2.5.7, gunakan perintah berikut.

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

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 yang siap, administrator dapat menginstal dan memelihara registri 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 menginstal registry npm pribadi, Anda dapat mengikuti petunjuk penginstalan 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 Edge Microgateway diinstal?

Saat Anda menggunakan npm dengan opsi global (npm install -g edgemicro), software 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, ini adalah /usr/local. Di Windows, ini adalah %AppData%\npm. Nilai [prefix] dapat dikonfigurasi. Lihat npm-folders untuk mengetahui informasi selengkapnya tentang tempat modul Node.js diinstal secara default dan cara mengonfigurasi lokasi penginstalan.

Menguninstal 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 Edge Microgateway diinstal?
  2. Menghapus atau mengarsipkan file log. Secara default, file edgemicro-*.log 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 bagi layanan yang berjalan di cluster Kubernetes. Lihat Mengintegrasikan Edge Microgateway dengan ringkasan Kubernetes.

Dukungan Docker

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

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