Como instalar o Edge Microgateway

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Edge Microgateway v. 2.3.x

Público-alvo

Use este guia se precisar instalar ou desinstalar o Edge Microgateway.

Pré-requisitos

  • Você precisa ter o Node.js versão 4.5 LTS ou posterior instalado no sistema. Consulte mais instruções do Node.js abaixo.
  • O Windows exige que o OpenSSL esteja instalado e adicionado ao PATH.
  • Se você estiver usando a nuvem privada do Apigee Edge para configurar com o Edge Microgateway, precisará executar a nuvem privada na versão 4.15.07 ou posterior.

Como instalar o Node.js

Você precisa ter o Node.js versão 4.5 ou posterior instalado no sistema. Para verificar, execute:

node -v

Há muitas maneiras de receber ou atualizar o Node.js. Por exemplo, é possível 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

Nesta seção, explicamos 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 executável edgemicro 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, é preciso 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.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 este 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 seu diretório principal em um subdiretório chamado .edgemicro. Verifique agora se esse arquivo existe:
    ls ~/.edgemicro
    default.yaml
    

    Observação: nos documentos do Edge Microgateway, nos referimos ao diretório principal com o til (~), que é um atalho do UNIX. No Windows, caso esteja executando um shell que não ofereça suporte ao til, substitua a variável de ambiente apropriada pelo til nos comandos que se referem ao diretório principal. Por exemplo: %USERPROFILE%/.edgemicro.

  5. Siga as etapas em Como instalar o Edge Microgateway.

Operações do 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 o 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 pronto à Internet, um administrador pode instalar e manter um registro NPM particular na rede interna. As instruções para configurar um registro npm particular estão além 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.

Como começar

Se você não tem experiência com o Edge Microgateway, o melhor ponto de partida é Como instalar o Edge Microgateway depois de concluir a instalação. O guia de configuração aborda 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. Encontre 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. Em caso de dúvida, verifique o arquivo de configuração, conforme explicado em Como gerenciar arquivos de registros.
  3. Exclua ou arquive os arquivos de configuração em cache e de configuração do ambiente de execução:
    ~/.edgemicro/*.yaml