Uma instalação típica do Edge consiste em componentes do Edge distribuídos por vários nós. Depois de instalar o Edge em um nó, instale e configure um ou mais componentes do Edge nele.
Processo de instalação
A instalação do Edge em um nó é um processo de várias etapas:
- Desative o SELinux no nó ou configure-o para o modo permissivo. Consulte Instalar o utilitário apigee-setup do Edge para mais informações.
- Decida se você quer ativar a autenticação do Cassandra.
- Decida se você quer configurar a replicação mestre em espera para o Postgres.
- Selecione sua configuração do Edge na lista de topologias recomendadas. Por exemplo, é possível instalar o Edge em um único nó para teste ou em 13 nós para produção. Consulte Topologias de instalação para mais informações.
- Em cada nó na topologia selecionada, instale o utilitário
apigee-setup
do Edge:- Faça o download do arquivo
bootstrap_4.52.01.sh
do Edge para/tmp/bootstrap_4.52.01.sh
. - Instale o utilitário
apigee-service
e as dependências do Edge. - Instale o utilitário
apigee-setup
e as dependências do Edge.Consulte Instalar o utilitário de configuração da Apigee do Edge para mais informações.
- Faça o download do arquivo
- Use o utilitário
apigee-setup
para instalar um ou mais componentes do Edge em cada nó com base na topologia selecionada.Consulte Instalar componentes do Edge em um nó.
- No nó do servidor de gerenciamento, use o utilitário
apigee-setup
para instalar oapigee-provision
, os utilitários usados para criar e gerenciar organizações de Edge.Consulte Integrar uma organização para saber mais.
- Reinicie o componente de interface clássica em cada nó após a conclusão da instalação,
conforme o exemplo a seguir:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Recomendado) Depois de concluir a instalação inicial, a Apigee recomenda que você instale a nova interface do Edge (com o nome do componente
edge-management-ui
), que é uma interface de usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.Para mais informações, consulte Instalar a nova interface do Edge.
Depois que a instalação for concluída, confira esta lista de ações comuns pós-instalação.
Quem pode realizar a instalação
Os arquivos de distribuição do Apigee Edge são instalados como um conjunto de RPMs e dependências. Para instalar, desinstalar e atualizar RPMs do Edge, os comandos precisam ser executados pelo usuário raiz ou por um usuário com acesso total ao sudo. Para acesso total ao sudo, isso significa que o usuário tem acesso ao sudo para executar as mesmas operações que o usuário raiz.
Qualquer usuário que queira executar os comandos ou scripts a seguir precisa ser raiz ou um usuário com acesso total ao sudo:
- Utilitário apigee-service:
- Comandos apigee-service:
install, uninstall, update
. - Comandos apigee-all:
install, uninstall, update
.
- Comandos apigee-service:
- setup.sh para instalar componentes do Edge, a menos que você já tenha usado "
apigee-service install
" para instalar as RPMs necessárias. Depois, acesso raiz ou total ao sudo, caso não seja necessário. - Script update.sh para atualizar os componentes do Edge.
Além disso, o instalador do Edge cria um novo usuário no sistema, chamado "apigee". Muitos comandos do Edge invocam o sudo para ser executado como o usuário "apigee".
Qualquer usuário que queira executar todos os outros comandos além dos mostrados acima precisa ser um usuário com acesso total ao sudo para o usuário "apigee". Esses comandos incluem:
-
Comandos utilitários da apigee-service, incluindo:
- Comandos apigee-service, como
start, stop, restart, configure
. - Comandos apigee-all, como
start, stop, restart, configure
.
- Comandos apigee-service, como
Como criar um usuário com acesso total ao sudo para um usuário "apigee"
Para configurar um usuário para ter acesso total ao sudo ao usuário "apigee", use o comando "visudo" para editar o arquivo sudoers e adicionar:
installUser ALL=(apigee) NOPASSWD: ALL
Em que installUser é o nome de usuário da pessoa que trabalha com o Edge.
Definição de permissões em arquivos de configuração
Todos os arquivos ou recursos usados pelos comandos do Edge precisam estar acessíveis ao usuário "apigee". Isso inclui o arquivo de licença do Edge e os arquivos de configuração.
Ao criar um arquivo de configuração, é possível alterar o proprietário para "apigee:apigee" para garantir que ele esteja acessível aos comandos do Edge:
- Crie o arquivo em um editor como qualquer usuário.
chown
o proprietário do arquivo para "apigee:apigee" ou, se você tiver alterado o usuário que executa o serviço do Edge do usuário "apigee", execute o comando "chown" do arquivo para o usuário que está executando o serviço de Edge.
Como separar tarefas de instalação do Edge entre usuários raiz e não raiz
Embora seja mais simples executar todo o processo de instalação do Edge como raiz ou por um usuário com acesso total ao sudo, isso nem sempre é possível. Em vez disso, é possível separar o processo em tarefas realizadas por raiz e tarefas realizadas por um usuário com acesso total ao sudo para o usuário "apigee".
- Tarefas realizadas pela raiz:
- Faça o download e execute o arquivo
bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
Esta etapa instala o utilitário
apigee-service
e cria o usuário "apigee". - Configure um usuário para ter acesso total ao sudo ao usuário "apigee", conforme descrito em Como criar um usuário com acesso total ao sudo para um usuário "apigee".
- Instale o utilitário
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Use o utilitário
apigee-setup
para instalar RPMs do Edge no nó:/opt/apigee/apigee-service/bin/apigee-service compName install
As RPMs de borda que você instala no nó dependem da sua topologia. A lista de componentes disponíveis inclui:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- Faça o download e execute o arquivo
- Depois que o usuário raiz instalar as RPMs de borda no nó, o usuário com acesso total ao sudo para
o usuário "apigee" concluirá o processo de configuração:
- Use o utilitário
setup.sh
para concluir a configuração dos componentes do Edge no nó. O formato do comando depende dos componentes instalados no nó. Para conferir uma lista completa, consulte Instalar componentes do Edge em um nó.Por exemplo, para concluir a instalação do ZooKeeper e do Cassandra, use o seguinte comando:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
Em que configFile é o arquivo de configuração do Edge.
Ou, para executar uma instalação completa, use o seguinte comando:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Use o utilitário
Local dos arquivos de configuração de instalação
Transmita um arquivo de configuração para o utilitário apigee-setup
que contenha as informações sobre a instalação do Edge. O único requisito em instalações silenciosas é que o
arquivo de configuração precisa estar acessível ou legível pelo usuário "apigee". Por exemplo, coloque o arquivo
no diretório /usr/local/var
ou /usr/local/share
no nó e
chown
como "apigee:apigee".
Todas as informações no arquivo de configuração são necessárias, exceto a senha do administrador do
sistema Edge. Se você omitir a senha, o utilitário apigee-setup
solicitará
que você a insira na linha de comando.
Consulte Instalar componentes do Edge em um nó para mais informações.
Como lidar com uma falha de instalação
No caso de uma falha durante a instalação de um componente do Edge, tente corrigir o problema e, em seguida, execute o instalador novamente. O instalador foi projetado para ser executado repetidamente nos casos em que ele detecta uma falha ou se você quiser alterar ou atualizar um componente após a instalação.
Depois de instalar ou fazer upgrade, reinicie o componente de IU do Edge em cada nó em que ele está sendo executado.
Instalação pela Internet ou sem Internet
Para instalar o Edge em um nó, o nó precisa acessar o repositório da Apigee:
- Nós com uma conexão de Internet externa
Os nós com uma conexão de Internet externa acessam o repositório da Apigee para instalar as dependências e RPMs do Edge.
- Nós sem uma conexão de Internet externa
Os nós sem uma conexão de Internet externa podem acessar uma versão espelhada do repositório da Apigee que você configurou internamente. Esse repositório contém todas as RPMs de borda, mas você precisa garantir que todas as outras dependências estejam disponíveis nos repositórios na rede interna.
Para criar o repositório interno da Apigee, você precisa de um nó com acesso externo à Internet para poder fazer o download de RPMs e dependências de borda. Depois de criar o repositório interno, é possível movê-lo para outro nó ou torná-lo acessível aos nós de borda para instalação.
Como usar um repositório do Edge local para manter sua versão do Edge
Um dos motivos para usar um repositório local ou espelhado é para instalar o Edge em nós sem conexão de Internet externa, conforme descrito na seção anterior.
Como resolver dependências de instalação de RPM
Os arquivos de distribuição do Apigee Edge são instalados como um conjunto de arquivos RPM, cada um com a própria cadeia de dependências de instalação. Muitas dessas dependências são definidas por componentes de terceiros que estão fora do controle da Apigee e podem ser alteradas a qualquer momento. Portanto, a documentação não lista o número de versão explícito de cada dependência.
Se você estiver executando uma instalação em uma máquina com acesso à Internet, o nó poderá fazer o download das RPMs e dependências necessárias. No entanto, se estiver instalando a partir de um nó sem acesso à Internet, você normalmente configura um repositório interno com todas as dependências necessárias. A única maneira de garantir que todas as dependências estejam incluídas no repositório local é tentar uma instalação, identificar as dependências ausentes e copiá-las para o repositório local até que a instalação seja bem-sucedida.
Comandos comuns do Yum
As ferramentas de instalação do Edge para Linux dependem do Yum para instalar e atualizar componentes. Talvez seja necessário usar vários comandos do Yum para gerenciar uma instalação em um nó.
- Limpe todos os caches do Yum:
sudo yum clean all
- Para atualizar um componente do Edge:
sudo yum update componentName
Exemplo:
sudo yum update apigee-setup
sudo yum update edge-management-server
Estrutura do sistema de arquivos
O Edge instala todos os arquivos no diretório /opt/apigee
.
Neste guia e no Guia de Operações do Edge, o diretório de instalação raiz é indicado como:
/opt/apigee
A instalação usa a seguinte estrutura do sistema de arquivos para implantar o Apigee Edge para nuvem privada.
Arquivos de registro
O arquivo de registros de apigee-setup
e o script setup.sh
é gravado em
/tmp/setup-root.log
.
Os arquivos de registro de cada componente estão no diretório /opt/apigee/var/log
. Cada componente tem seu próprio subdiretório. Por exemplo, os registros do servidor de gerenciamento estão no diretório:
/opt/apigee/var/log/edge-management-server
As tabelas a seguir listam a localização dos arquivos de registro:
Componente | Local |
---|---|
Servidor de gerenciamento |
/opt/apigee/var/log/edge-management-server
|
Roteador |
/opt/apigee/var/log/edge-router
O roteador de borda é implementado com Nginx. Para registros adicionais, consulte:
|
processador de mensagens |
/opt/apigee/var/log/edge-message-processor
|
Servidor Qpid da Apigee |
/opt/apigee/var/log/edge-qpid-server
|
Servidor Apigee Postgres | /opt/apigee/var/log/edge-postgres-server |
interface clássica (não a nova interface do Edge, que tem o nome do componente
edge-management-ui ) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
Cassandra | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
Banco de dados PostgreSQL | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
Dados
Componente | Local |
---|---|
Servidor de gerenciamento | /opt/apigee/data/edge-management-server |
Roteador | /opt/apigee/data/edge-router |
processador de mensagens | /opt/apigee/data/edge-message-processor |
Agente Qpid da Apigee | /opt/apigee/data/edge-qpid-server |
Agente do Apigee Postgres | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
Cassandra | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
Banco de dados PostgreSQL | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
Ativar a verificação do sistema na instalação
O arquivo de configuração de instalação do Edge é compatível com a seguinte propriedade:
ENABLE_SYSTEM_CHECK=y
Se você definir essa propriedade como "y", o instalador vai verificar se o sistema atende aos requisitos de CPU e memória para o componente que está sendo instalado. O valor padrão é "n" para desativar a verificação.