Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
Edge Microgateway v. 3.0.x
Este tópico explica 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 8.x LTS ou 12.x
instalado no sistema. Para verificar a versão, execute o seguinte comando:
node -v v12.5.0
- 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?.
- Instale a versão mais recente do Edge Microgateway com
npmda seguinte maneira. Esse comando instala o software e coloca o executáveledgemicrono 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 seguinte comando.
npm install edgemicro@3.0.2 -g
- Confira o número da versão. Por exemplo, se você instalou a versão 3.0.2:
edgemicro --version current nodejs version is v12.5.0 current edgemicro version is 3.0.2
- Siga as etapas de configuração e instalação em Configurar e instalar 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, é possível 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 e configurar o Edge Microgateway é o melhor lugar para começar depois de concluir a instalação. O guia de configuração e instalaçã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 é o
/usr/local. No Windows, é %AppData%\npm. O valor de
[prefix] é configurável. Consulte npm-folders (em inglês) 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:
- 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? -
Exclua ou arquive os arquivos de registro. Por padrão, os arquivos
edgemicro-*.logestão em/var/tmp/, mas esse local é configurável. Em caso de dúvida, verifique o arquivo de configuração do Edge Microgateway. - Exclua ou arquive os arquivos de configuração do ambiente de execução e do 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