Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
Edge Microgateway v. 2.3.x
Público-alvo
Use este guia se precisar instalar ou desinstalar o Edge Microgateway.
Pré-requisitos
- É necessário ter o Node.js versão 4.5 LTS ou mais recente instalado no sistema. Consulte outras instruções do Node.js abaixo.
- O Windows exige que o OpenSSL seja instalado e adicionado ao PATH.
- Se você estiver usando o Apigee Edge para nuvem privada para configurar com o Edge Microgateway, será necessário executar a versão 4.15.07 ou mais recente da nuvem privada.
Como instalar o Node.js
É necessário ter o Node.js versão 4.5 ou mais recente instalado no sistema. Para verificar, execute:
node -v
Há muitas maneiras de receber ou atualizar o Node.js. Por exemplo, você pode usar o HomeBrew, o yum ou
fazer o download diretamente do site do Node.js: https://nodejs.org/download.
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.
- Instale a versão mais recente do Edge Microgateway com
npmusando o comando a seguir. Esse comando instala o software e coloca oedgemicroexecutável no seu caminho. Para saber exatamente onde o comando a seguir instala o Edge Microgateway, consulte Onde o Edge Microgateway está instalado?.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 2.3.1, use o comando a seguir.
npm install edgemicro@2.3.1 -g
- Confira o número da versão. Por exemplo, se você instalou a versão 2.3.5:
edgemicro --version current nodejs version is v6.1.0 current edgemicro version is 2.3.5
- Execute esse comando para criar um arquivo de configuração padrão no diretório principal.
edgemicro init
- (Opcional) Um arquivo de configuração chamado
default.yamlfoi colocado no diretório principal em um subdiretório chamado.edgemicro. Verifique agora para garantir que esse arquivo exista:ls ~/.edgemicro default.yaml
Observação:na documentação do Edge Microgateway, nos referimos ao diretório principal com o til (
~), que é um atalho do UNIX. Se você estiver no Windows, se estiver executando um shell que não oferece suporte ao til, será necessário substituir a variável de ambiente apropriada pelo til em comandos que fazem referência ao diretório principal. Por exemplo:%USERPROFILE%/.edgemicro. - Siga as etapas em Como instalar 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 npm particular instalado, siga as instruções de instalação fornecidas
acima.
Primeiros passos
Se você não conhece o Edge Microgateway, o Como instalar 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 valor de [prefix] é configurável. Consulte npm-folders para mais informações.
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. Verifique o arquivo de configuração em caso de dúvida, conforme explicado em "Como gerenciar arquivos de registro." - Exclua ou arquive os arquivos de configuração de ambiente de execução e de cache:
~/.edgemicro/*.yaml