Como instalar o Edge Microgateway

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

Edge Microgateway v. 3.3.x

Neste tópico, explicamos como instalar ou desinstalar o Edge Microgateway.

Requisitos mínimos de hardware

O Edge Microgateway requer a seguinte configuração mínima de hardware:

  • Em uma máquina virtual (VM), o Edge Microgateway exige no mínimo 1 núcleo e pelo menos 256 MB de RAM. O processo do Edge Microgateway usa menos de 128 MB de RAM.
  • Em um contêiner, o Microgateway pode ser usado com uma imagem menor que 100 MB.

Pré-requisitos

  • A Apigee oferece suporte às versões Active LTS ou de manutenção do LTS no Windows, macOS e Linux. Consulte Software compatível com a Apigee Edge Microgateway para mais informações.
  • O Windows exige que o OpenSSL esteja instalado e adicionado para o PATH.
  • Se você estiver usando a nuvem privada do Apigee Edge para configurar com o Edge Microgateway, será necessário com a versão 4.18.01 ou mais recente da nuvem privada.

Instalar o Edge Microgateway se Você tem uma conexão de Internet

Nesta seção, explicamos como instalar o Edge Microgateway e inicializar um gateway configuração do Terraform. Se você estiver operando sem uma conexão de Internet, consulte Posso instalar o Edge Microgateway sem uma conexão de Internet?

  1. Instale a versão mais recente do Edge Microgateway com npm da seguinte maneira. Isso instala o software e coloca o executável edgemicro no seu caminho.
    npm install edgemicro -g
    

    Para instalar uma versão específica do Edge Microgateway, é preciso especificar o número da versão no comando de instalação. Se você não especificar o número da versão, a versão mais recente vai ser instalada. Por exemplo, para instalar versão 3.1.5, use o seguinte comando.

    npm install edgemicro@3.1.5 -g
    
  2. Confira o número da versão. Por exemplo, se você instalou a versão 3.1.5:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.5
    
  3. Siga as etapas de instalação em Como configurar e configurar o Edge Microgateway.

Como fazer upgrade do Edge Microgateway

Para fazer upgrade de uma versão instalada anteriormente do Edge Microgateway, acesse Como fazer upgrade do Edge Microgateway se tiver uma conexão de Internet.

A Apigee recomenda que você teste sua configuração atual com para a nova versão antes de fazer upgrade do ambiente de produção.

O Operating Edge Microgateway no Windows como um Serviço

É possível operar o Edge Microgateway no Windows como um serviço. Para obter detalhes, consulte Práticas recomendadas para o gerenciamento operacional do Microgateway (edgemicro) no Windows no Comunidade Apigee.

Posso instalar o Edge Microgateway sem conexão com a Internet?

Em sites que não têm acesso imediato à Internet, é possível que um administrador Instalar e manter um registro npm particular na sua rede interna. As instruções para configurar um registro npm particular estão estão fora do escopo deste guia. No entanto, você pode pesquisar e encontrar instruções úteis. Com um private npm instalado, siga as instruções de instalação ou atualização fornecidas acima.

Primeiros passos

Se você ainda não conhece o Edge Microgateway, o tópico Como configurar e configurar o Edge Microgateway é o melhor ponto de partida depois de concluir a instalar. O guia de configuração abrange todas as etapas necessárias para a instalação, configurar, iniciar e usar uma instância do Edge Microgateway.

Onde O Edge Microgateway está instalado?

Ao usar npm com a opção global (npm install -g edgemicro), o software está instalado em [prefix]/lib/node_modules/edgemicro. Você encontra de [prefix] com este comando:

npm config get prefix

A configuração do prefixo é padronizada para o local em que o nó está instalado. Na maioria dos sistemas, /usr/local: No Windows, é %AppData%\npm. O valor de [prefix] é configurável. Consulte npm-folders para mais informações sobre onde o Node.js módulos são instalados por padrão e como configurar o local da instalação.

Como desinstalar o Edge Microgateway

Se for necessário remover o Edge Microgateway:

  1. Excluir ou arquivar o diretório de instalação [prefix]/lib/node_modules/edgemicro, em que [prefixo] é o npm como explicado em Onde o Edge Microgateway está instalado?
  2. Exclua ou arquive os arquivos de registro. Por padrão, edgemicro-*.log arquivos estão em /var/tmp/, mas esse local é configurável. Marca de seleção o arquivo de configuração do Edge Microgateway em caso de dúvida.
  3. Exclua ou arquive a configuração do ambiente de execução e os arquivos de configuração em cache:
    ~/.edgemicro/*.yaml
    

Suporte do Kubernetes

É possível usar o Edge Microgateway para gerenciar a API da Apigee para serviços em execução em um cluster do Kubernetes. Consulte Visão geral da integração do Edge Microgateway com o Kubernetes.

Suporte a Docker

Agora é possível fazer o download da versão mais recente do Edge Microgateway como uma imagem do Docker:

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