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. 3.2.x

Este tópico explica 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 requer no mínimo um núcleo e pelo menos 256 MB de RAM. O processo do Edge Microgateway 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

  • A Apigee oferece suporte a versões LTS ativas ou de manutenção no Windows, macOS e Linux. Consulte Software compatível com o Edge Microgateway da Apigee para mais informações.
  • 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. 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, especifique 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 de configuração e configuração em Configurar 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.

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 npm particular instalado, siga as instruções de instalação ou upgrade fornecidas 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?

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