Como instalar o Edge Microgateway

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Edge Microgateway v. 3.2.x

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

Requisitos mínimos de hardware

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

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

Pré-requisitos

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

Como instalar o Edge Microgateway se você tiver uma conexão de Internet

Nesta seção, explicamos como instalar o Edge Microgateway e inicializar uma configuração padrão. 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. Esse comando 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 será instalada. Por exemplo, para instalar a versão 3.1.5, use o comando a seguir.

    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 em Como instalar e configurar o Edge Microgateway.

Como fazer upgrade do Edge Microgateway

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

A Apigee recomenda testar a configuração atual com a nova versão antes de fazer upgrade do ambiente de produção.

Operações do Edge Microgateway no Windows como um serviço

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

Posso instalar o Edge Microgateway sem uma conexão de Internet?

Em sites que não têm acesso pronto à Internet, um administrador pode instalar e manter um registro NPM particular na rede interna. As instruções para configurar um registro npm particular estão além do escopo deste guia. No entanto, você pode pesquisar e encontrar instruções úteis. Com um registro npm particular instalado, siga as instruções de instalação ou upgrade fornecidas acima.

Como começar

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

Onde o Edge Microgateway está instalado?

Quando você usa npm com a opção global (npm install -g edgemicro), o software é instalado em [prefix]/lib/node_modules/edgemicro. Encontre o valor de [prefix] com este comando:

npm config get prefix

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

Como desinstalar o Edge Microgateway

Se você precisar remover o Edge Microgateway:

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

Suporte do Kubernetes

É possível usar o Edge Microgateway para fornecer gerenciamento da API 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 Docker:

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