Installazione di Edge Microgateway

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Edge Microgateway v. 3.1.5 e successive

In questo argomento viene spiegato come installare o disinstallare Edge Microgateway.

Requisiti hardware minimi

Edge Microgateway richiede la seguente configurazione hardware minima:

  • Su una macchina virtuale (VM), Edge Microgateway richiede almeno 1 core e al e devono avere almeno 256 MB di RAM. Lo stesso processo Edge Microgateway richiede meno di 128 MB di RAM.
  • Su un container, Microgateway può essere utilizzato con dimensioni dell'immagine inferiori a 100 MB.

Prerequisiti

  • Apigee supporta le release Active LTS o Manutenzione LTS su Windows, macOS e Linux. Consulta Software supportato per Apigee Edge Microgateway per ulteriori informazioni.
  • Windows richiede l'installazione e l'aggiunta di OpenSSL al PATH.
  • Se utilizzi il cloud privato di Apigee Edge per eseguire la configurazione con Edge Microgateway, devi avere che esegue Private Cloud versione 4.18.01 o successive.

Installazione di Edge Microgateway se disponi di una connessione a internet

Questa sezione spiega come installare Edge Microgateway e inizializzare un oggetto predefinito configurazione. Se non disponi di una connessione Internet, vedi Posso installare Edge Microgateway senza una connessione a internet?.

  1. Installa la versione più recente di Edge Microgateway con npm come segue. Questo installa il software e inserisce l'eseguibile edgemicro nel tuo percorso. 
    npm install edgemicro -g

    Per installare una versione specifica di Edge Microgateway, devi specificare il version number nel comando di installazione. Se non specifichi il numero di versione, verrà installata la versione più recente. Ad esempio, per installare versione 3.1.5, usare 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 impostazione e configurazione in Configurazione e la configurazione di Edge Microgateway.

Upgrade di Edge Microgateway in corso...

Per eseguire l'upgrade di una versione installata in precedenza di Edge Microgateway, vedi Esegui l'upgrade di Edge Microgateway se disponi di una connessione a internet.

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

Utilizzo di Edge Microgateway su Windows come Servizio

Puoi utilizzare Edge Microgateway su Windows come servizio. Per maggiori dettagli, vedi Best practice per la gestione operativa di Microgateway (edgemicro) su Windows sul Community Apigee

Posso installare Edge Microgateway senza una connessione a internet?

Sui siti che non hanno un accesso a internet pronto, l'amministratore può installare e gestire un registro npm privato sulla tua rete interna. Le istruzioni per configurare un registro npm privato sono: che esulano dall'ambito di questa guida; ma puoi cercare e trovare istruzioni utili. Con un registro npm privato installato, puoi seguire le istruzioni per l'installazione o l'upgrade fornite in alto.

Per iniziare

Se non hai mai utilizzato Edge Microgateway, la sezione Configurazione e configurazione di Edge Microgateway è il punto di partenza migliore dopo aver completato installare l'app. La guida all'impostazione e alla configurazione illustra tutti i passaggi da eseguire per installare, configurare, avviare e utilizzare un'istanza di Edge Microgateway.

Dove Edge Microgateway è installato?

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

npm config get prefix

La configurazione del prefisso è quella in cui è installato il nodo, per impostazione predefinita. Nella maggior parte dei sistemi, /usr/local. Su Windows è %AppData%\npm. Il valore di [prefix] è configurabile. Vedi npm-folders per ulteriori informazioni su dove Node.js sono installati per impostazione predefinita e come configurare il percorso di installazione.

Disinstallazione di Edge Microgateway

Se devi rimuovere Edge Microgateway:

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

Assistenza per Kubernetes

Puoi utilizzare Edge Microgateway per fornire la gestione delle API Apigee per di servizi in esecuzione in un cluster Kubernetes. Vedi Panoramica dell'integrazione di Edge Microgateway con Kubernetes.

Supporto Docker

Ora puoi scaricare la release più recente di Edge Microgateway come immagine Docker:

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