Installazione di Edge Microgateway

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Edge Microgateway v. 3.2.x

Questo argomento spiega come installare o disinstallare Edge Microgateway.

Requisiti minimi per l'utilizzo dell'hardware

Edge Microgateway richiede la seguente configurazione hardware minima:

  • Su una macchina virtuale (VM), Edge Microgateway richiede un minimo di 1 core e almeno 256 MB di RAM. Il processo Edge Microgateway stesso richiede meno di 128 MB di RAM.
  • Su un container, Microgateway può essere utilizzato con una dimensione dell'immagine inferiore a 100 MB.

Prerequisiti

  • Apigee supporta le release Active LTS o Maintenance LTS su Windows, macOS e Linux. Per ulteriori informazioni, consulta Software supportato per Apigee Edge Microgateway.
  • Windows richiede l'installazione di OpenSSL e l'aggiunta al PATH.
  • Se utilizzi Apigee Edge Private Cloud per la configurazione con Edge Microgateway, devi essere in esecuzione la versione Private Cloud 4.18.01 o successive.

Installare Edge Microgateway se hai una connessione a internet

Questa sezione spiega come installare Edge Microgateway e inizializzare una configurazione predefinita Se operi senza una connessione a internet, consulta Posso installare Edge Microgateway senza una connessione a internet?.

  1. Installa l'ultima versione di Edge Microgateway con npm come segue. Questo comando installa il software e inserisce l'eseguibile edgemicro nel percorso. 
    npm install edgemicro -g

    Per installare una versione specifica di Edge Microgateway, devi specificare il numero di versione nel comando di installazione. Se non specifichi il numero di versione, verrà installata l'ultima versione. Ad esempio, per installare la versione 3.1.5, utilizza il seguente comando. 

    npm install edgemicro@3.1.5 -g
  2. Controlla il numero di versione. Ad esempio, se hai installato la versione 3.1.5: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. Segui i passaggi di configurazione descritti in Configurare Edge Microgateway.

Eseguire l'upgrade di Edge Microgateway

Per eseguire l'upgrade di una versione di Edge Microgateway installata in precedenza, consulta Eseguire l'upgrade di Edge Microgateway se hai una connessione a internet.

Apigee consiglia di testare la configurazione esistente con la nuova versione prima di eseguire l'upgrade dell'ambiente di produzione.

Eseguire Edge Microgateway su Windows come servizio

Puoi eseguire Edge Microgateway su Windows come servizio. Per maggiori dettagli, consulta Best practices for operational management of Microgateway (edgemicro) on Windows nella community Apigee.

Posso installare Edge Microgateway senza una connessione a internet?

Nei siti che non dispongono di un accesso a internet immediato, un amministratore può installare e gestire un registro npm privato sulla rete interna. Le istruzioni per configurare un registro npm privato non rientrano nell'ambito di questa guida, ma puoi cercare e trovare istruzioni utili. Con un registro npm privato installato, puoi seguire le istruzioni di installazione o upgrade riportate sopra.

Per iniziare

Se non hai mai utilizzato Edge Microgateway, la guida Configurare Edge Microgateway è il punto di partenza ideale dopo aver completato l'installazione. La guida alla configurazione e all'installazione illustra tutti i passaggi necessari per installare, configurare, avviare e utilizzare un'istanza di Edge Microgateway.

Dove viene installato Edge Microgateway?

Quando utilizzi npm con l'opzione globale (npm install -g edgemicro), il software viene installato in [prefix]/lib/node_modules/edgemicro. Puoi trovare il valore di [prefix] con questo comando:

npm config get prefix

Per impostazione predefinita, il prefisso di configurazione è il percorso in cui è installato Node. Nella maggior parte dei sistemi, questo percorso è /usr/local. Su Windows, è %AppData%\npm. Il valore di [prefix] è configurabile. Per ulteriori informazioni su dove vengono installati i moduli Node.js per impostazione predefinita e su come configurare la posizione di installazione, consulta npm-folders.

Disinstallare Edge Microgateway

Se devi rimuovere Edge Microgateway:

  1. Elimina o archivia la directory di installazione [prefix]/lib/node_modules/edgemicro, dove [prefix] è il prefisso npm come spiegato in Dove viene installato Edge Microgateway?
  2. Elimina o archivia i file di log. Per impostazione predefinita, edgemicro-*.log file si trovano in /var/tmp/, ma questa posizione è configurabile. In caso di dubbi, controlla il file di configurazione di Edge Microgateway.
  3. Elimina o archivia i file di configurazione di runtime e di configurazione della cache: 
    ~/.edgemicro/*.yaml

Supporto di Kubernetes

Puoi utilizzare Edge Microgateway per fornire la gestione delle API Apigee per i servizi in esecuzione in un cluster Kubernetes. Consulta la panoramica Integrare Edge Microgateway con Kubernetes.

Supporto di Docker

Ora puoi scaricare l'ultima release di Edge Microgateway come immagine Docker:

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