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

  1. Instale a versão mais recente do Edge Microgateway com npm usando o comando a seguir. Esse comando instala o software e coloca o edgemicro executá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
  2. 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
  3. Execute esse comando para criar um arquivo de configuração padrão no diretório principal.
    edgemicro init
  4. (Opcional) Um arquivo de configuração chamado default.yaml foi 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.

  5. 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:

  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 em caso de dúvida, conforme explicado em "Como gerenciar arquivos de registro."
  3. Exclua ou arquive os arquivos de configuração de ambiente de execução e de cache:
    ~/.edgemicro/*.yaml