Edge para nuvem privada v. 4.17.01
Uma instalação Edge típica consiste em componentes distribuídos em 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-standby para o Postgres.
- Selecione a configuração de borda na lista de topologias recomendadas. Por exemplo, você pode instalar o Edge em um único nó para testes ou em 13 nós para produção. Consulte Configurar a replicação Master-Standby para Postgres para saber mais.
- Em cada nó na topologia selecionada, instale o utilitário apigee-setup do Edge:
- Faça o download do arquivo bootstrap_4.17.01.sh do Edge para /tmp/bootstrap_4.17.01.sh.
- Instale o utilitário apigee-service e as dependências do Edge.
- Instale o utilitário e as dependências do apigee-setup (link em inglês) do Edge.
Consulte Instalar o utilitário apigee-setup do Edge para mais informações.
- 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 o apigee-provision,
que são os utilitários usados para criar e gerenciar organizações do Edge.
Confira mais informações em Integrar uma organizaçã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 o Edge, os comandos do Edge precisam ser executados pelo usuário raiz ou por um usuário que tenha acesso sudo total. Para acesso sudo total, isso significa que o usuário tem acesso sudo para executar as mesmas operações que o root.
Qualquer usuário que queira executar os comandos ou scripts a seguir precisa ser raiz ou ter acesso total ao sudo:
-
Utilitário apigee-service:
- Comandos apigee-service: install, uninstall, update.
- Comandos apigee-all: install, uninstall, update.
- setup.sh para instalar componentes do Edge, a menos que você já tenha usado apigee-service install para instalar os RPMs necessários. Em seguida, acesso raiz ou sudo completo, se não for necessário.
- 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 ter acesso sudo total ao usuário "apigee". Esses comandos incluem:
-
Comandos de utilitário apigee-service, incluindo:
- Comandos apigee-service, como start, stop, restart, configure.
- comandos apigee-all, como start, stop, restart, configure.
Para configurar um usuário para que tenha acesso total ao sudo para o usuário "apigee", edite o arquivo sudoers para adicionar:
installUser ALL=(apigee) NOPASSWD: ALL
em que installUser é o nome de usuário da pessoa que trabalha com o Edge.
Todos os arquivos ou recursos usados pelos comandos do Edge precisam ser acessíveis ao usuário "apigee". Isso inclui o arquivo de licença do Edge e todos os arquivos de configuração.
Ao criar um arquivo de configuração, você pode mudar o proprietário para "apigee:apigee" para garantir que ele seja acessível aos comandos do Edge:
- Crie o arquivo em um editor como qualquer usuário.
- Defina o proprietário do arquivo como "apigee:apigee" ou, se você tiver alterado o usuário que executa o serviço do Edge do usuário "apigee", mude o arquivo para o usuário que estiver executando o serviço.
Local dos arquivos de configuração de instalação
É necessário transmitir um arquivo de configuração para o utilitário apigee-setup que contém as informações sobre a instalação do Edge. O único requisito para instalações silenciosas é que o arquivo de configuração precisa estar acessível ou legível para o usuário da "apigee". Por exemplo, coloque o arquivo no diretório /usr/local/var ou /usr/local/share no nó e use o comando chown para "apigee:apigee".
Todas as informações no arquivo de configuração são obrigatórias, exceto a senha do administrador do sistema do Edge. Se você omitir a senha, o utilitário apigee-setup vai solicitar que você a insira na linha de comando.
Consulte Instalar componentes do Edge em um nó para mais.
Como lidar com uma falha na instalação
Em caso de falha durante a instalação de um componente Edge, você pode tentar corrigir o problema e executar o instalador novamente. O instalador foi projetado para ser executado repetidamente caso detecte uma falha ou se você quiser alterar ou atualizar um componente após a instalação.
Instalação com ou sem Internet
Para instalar o Edge em um nó, ele precisa ter acesso ao repositório da Apigee:
- Nós com uma conexão externa à Internet
Os nós com uma conexão externa à Internet acessam o repositório da Apigee para instalar os RPMs e as dependências do Edge. - Nós sem uma conexão externa à Internet
Nós sem uma conexão externa à Internet podem acessar uma versão espelhada do repositório Apigee que você configurou internamente. Esse repositório contém todos os RPMs do Edge, mas você precisa garantir que tenha todas as outras dependências disponíveis dos repositórios na rede interna.
Observação: a Apigee não hospeda todas as dependências de terceiros nos nossos repositórios públicos. É necessário fazer o download e a instalação dessas dependências em repositórios acessíveis publicamente.
Para criar o repositório interno da Apigee, você precisa de um nó com acesso externo à Internet para fazer o download dos RPMs e das dependências do Edge. Depois de criar o repositório interno, é possível movê-lo para outro nó ou torná-lo acessível aos nós do Edge para instalação.
Como usar um repositório local do Edge para manter sua versão do Edge
Uma das razões para usar um repositório local ou espelhado é instalar o Edge em nós sem conexão externa à Internet, conforme descrito na seção anterior.
No entanto, há outra vantagem em usar um repositório local, mesmo para nós com uma conexão externa à Internet. Ao instalar o Edge no repositório público do Apigee, você sempre instala os RPMs mais recentes do Edge. Portanto, se você quiser fazer o download e armazenar RPMs do Edge para uma versão específica do Edge, crie um repositório local para essa versão. Em seguida, use esse repositório local para realizar instalações em qualquer versão do Edge.
Por exemplo, primeiro você usa o repositório local para instalar um ambiente de desenvolvimento do Edge. Em seguida, quando estiver tudo pronto para migrar para um ambiente de produção, instale o Edge novamente do repositório local. Ao instalar do repositório local, você garante que os ambientes de desenvolvimento e de produção sejam correspondentes.
Um repositório espelhado é muito flexível. Por exemplo, é possível criar um repositório espelhado a partir dos RPMs mais recentes do Edge ou de uma versão específica do Edge. Depois de criar o repositório, você também pode atualizá-lo para adicionar RPMs de diferentes versões do Edge. Consulte Instalar o utilitário apigee-setup do Edge para mais informações.
Como resolver dependências de instalação do 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 mudar 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 você estiver instalando de um nó sem acesso à Internet, normalmente configurará um repositório interno com todas as dependências necessárias. A única maneira de garantir que todas as dependências sejam 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
Por 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:
<inst_root>/apigee
A instalação usa a seguinte estrutura de sistema de arquivos para implantar o Apigee Edge para nuvem privada.
Arquivos de registro
O arquivo de registros da apigee-setup e o script setup.sh são gravados em /tmp/setup-root.log.
Os arquivos de registro de cada componente estão contidos no diretório /opt/apigee/var/log. Cada componente tem o 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 o local dos arquivos de registro:
|
Componentes |
Local |
|---|---|
|
Servidor de gerenciamento |
<inst_root>/apigee/var/log/edge-management-server |
|
Roteador |
<inst_root>/apigee/var/log/edge-router |
|
processador de mensagens |
<inst_root>/apigee/var/log/edge-message-processor |
|
Servidor Apigee Qpid |
<inst_root>/apigee/var/log/edge-qpid-server |
|
Servidor Apigee Postgres |
<inst_root>/apigee/var/log/edge-postgres-server |
|
Interface do Edge |
<inst_root>/apigee/var/log/edge-ui |
|
ZooKeeper |
<inst_root>/apigee/var/log/apigee-zookeeper |
|
OpenLDAP |
<inst_root>/apigee/var/log/apigee-openldap |
|
Cassandra |
<inst_root>/apigee/var/log/apigee-cassandra |
|
Qpidd |
<inst_root>/apigee/var/log/apigee-qpidd |
|
Banco de dados PostgreSQL |
<inst_root>/apigee/var/log/apigee-postgresql |
Dados
|
Componentes |
Local |
|---|---|
|
Servidor de gerenciamento |
<data_root>/apigee/data/edge-management-server |
|
Roteador |
<data_root>/apigee/data/edge-router |
|
processador de mensagens |
<data_root>/apigee/data/edge-message-processor |
|
Agente Apigee Qpid |
<data_root>/apigee/data/edge-qpid-server |
|
Agente do Apigee Postgres |
<data_root>/apigee/data/edge-postgres-server |
|
ZooKeeper |
<data_root>/apigee/data/apigee-zookeeper |
|
OpenLDAP |
<data_root>/apigee/data/apigee-openldap |
|
Cassandra |
<data_root>/apigee/data/apigee-cassandra/data |
|
Qpidd |
<data_root>/apigee/data/apigee-qpid/data |
|
Banco de dados PostgreSQL |
<data_root>/apigee/data/apigee-postgres/pgdata |
Tarefas pós-instalação
Após a conclusão da instalação, você pode realizar outras ações nos componentes do Edge.
Como configurar os componentes do Edge após a instalação
Para configurar o Edge após a instalação, use uma combinação de arquivos .properties e utilitários do Edge. Por exemplo, para configurar o TLS/SSL na interface do Edge, edite os arquivos .properties para definir as propriedades necessárias. As mudanças nos arquivos .properties exigem que você reinicie o componente do Edge afetado.
Os arquivos .properties estão localizados no diretório /opt/apigee/customer/application. Cada componente tem o próprio arquivo .properties nesse diretório. Por exemplo, router.properties e management-server.properties.
Para definir uma propriedade para um componente, edite o arquivo .properties correspondente e reinicie o componente:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Exemplo:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Quando você atualiza o Edge, os arquivos .properties no diretório /opt/apigee/customer/application são lidos. Isso significa que a atualização mantém todas as propriedades que você definiu no componente.
Consulte Como configurar o Edge para mais informações sobre a configuração do Edge.
Invocar comandos em componentes do Edge
O Edge instala utilitários de gerenciamento em /opt/apigee/apigee-service/bin que podem ser usados para gerenciar uma instalação do Edge. Por exemplo, use o utilitário apigee-all para iniciar, parar, reiniciar ou determinar o status de todos os componentes do Edge no nó:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
Use o utilitário apigee-service para controlar e configurar componentes individuais. O utilitário apigee-service tem o seguinte formato:
/opt/apigee/apigee-service/bin/apigee-service component action
Por exemplo, para reiniciar o roteador de borda:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
É possível determinar a lista de componentes instalados no nó examinando o diretório /opt/apigee. Esse diretório contém um subdiretório para cada componente do Edge instalado no nó. Cada subdiretório é prefixado por:
- Apigee: um componente de terceiros usado pelo Edge. Por exemplo, apigee-cassandra.
- edge: um componente Edge da Apigee. Por exemplo, edge-management-server.
- edge-mint: um componente de monetização. Por exemplo, edge-mint-management-server.
- baas: um componente de API BaaS. Por exemplo, baas-usergrid.
A lista completa de ações de um componente depende dele, mas todos os componentes oferecem suporte às seguintes ações:
- iniciar, parar, reiniciar
- status, version
- backup, restauração
- instalar, desinstalar