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.
- 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áveledgemicro
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
- 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 este comando para criar um arquivo de configuração padrão no diretório principal.
edgemicro init
- (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
. - 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:
- 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-*.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. - Exclua ou arquive os arquivos de configuração em cache e de configuração do ambiente de execução:
~/.edgemicro/*.yaml