Como instalar o Edge Microgateway

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X
.info

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 exige no mínimo um núcleo e pelo menos 256 MB de RAM. O processo do Edge Microgateway em si ocupa 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

  • É necessário ter o Node.js versão 6.x LTS ou 8.x LTS instalado no sistema. Para verificar a versão, execute o seguinte comando:
    node -v
    v6.9.1  
  • O Windows exige que o OpenSSL seja instalado e adicionado ao PATH.
  • Se você estiver usando o Apigee Edge Private Cloud para configurar com o Edge Microgateway, será necessário executar a versão 4.18.01 ou mais recente do Private Cloud.

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

Esta seção explica 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, é necessário 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 de configuração e configuração em Configurar e configurar o Edge Microgateway.

Como operar o 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 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 à Internet, é possível que um administrador instale e mantenha um registro npm particular na rede interna. As instruções para configurar um registro npm particular estão fora do escopo deste guia. No entanto, você pode pesquisar e encontrar instruções úteis. Com um registro particular npm instalado, siga as instruções de instalação acima.

Primeiros passos

Se você não conhece o Edge Microgateway, o Configurar o Edge Microgateway é o melhor lugar para começar depois de concluir a instalação. O guia de configuração e configuração abrange 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. É possível encontrar o valor de [prefix] com este comando:

npm config get prefix

O prefixo de configuração é definido como o local em que o nó está instalado. Na maioria dos sistemas, esse é /usr/local. No Windows, é %AppData%\npm. O valor de [prefix] é configurável. Consulte npm-folders para mais informações sobre onde os módulos do Node.js são instalados por padrão e como configurar o local de 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. Em caso de dúvida, verifique o arquivo de configuração do Edge Microgateway.
  3. Exclua ou arquive os arquivos de configuração de ambiente de execução e de cache:
    ~/.edgemicro/*.yaml

Suporte do Kubernetes

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

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