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. 2.5.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

  • Você precisa ter o Node.js versão 6.x LTS ou 8.x LTS instalada no sistema. Para verificar a versão, execute o seguinte comando:
    node -v
    v6.9.1  
    
  • 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.

  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 2.5.7, use o comando a seguir.

    npm install edgemicro@2.5.7 -g
    
  2. Confira o número da versão. Por exemplo, se você instalou a versão 2.5.7:
    edgemicro --version
    current nodejs version is v6.9.1
    current edgemicro version is 2.5.7
    
  3. Siga as etapas em Como instalar e configurar o Edge Microgateway.

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 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