Esta página foi traduzida pela API Cloud Translation.

Visão geral da instalação de borda

Uma instalação do Edge típica consiste em componentes do Edge 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 defina-o como 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 do Edge 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 Topologias de instalação para mais informações.
Em cada nó da topologia selecionada, instale o utilitário apigee-setup do Edge:
- Faça o download do arquivo bootstrap_4.50.00.sh do Edge para /tmp/bootstrap_4.50.00.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 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 apigee-provision, os utilitários usados para criar e gerenciar organizações do Edge.
Saiba mais em Integrar uma organização.
Reinicie o componente da interface clássica em cada nó após a conclusão da instalação, conforme mostrado no 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 IU do Edge (com o nome do componente edge-management-ui), que é uma interface do 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 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 seu sistema chamado "apigee". Muitos comandos do Edge invocam o sudo para serem executados 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.

Criação de um usuário com acesso sudo total ao usuário "apigee"

OBSERVAÇÃO: não é possível realizar esta etapa antes de executar o arquivo bootstrap_4.50.00.sh para criar o usuário da "apigee".

Para configurar um usuário para que tenha acesso total ao sudo para o usuário "apigee", use o comando "visudo" para editar o arquivo sudoers a ser adicionado:

installUser        ALL=(apigee)      NOPASSWD: ALL

Em que installUser é o nome de usuário da pessoa que trabalha com o Edge.

Como definir permissões nos arquivos de configuração

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, é possível alterar o proprietário para "apigee:apigee" para garantir que ele fique 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ê mudou o usuário que executa o serviço Edge do usuário "apigee", chown o arquivo para o usuário que está executando o serviço Edge.

Separar as tarefas de instalação do Edge entre usuários raiz e não raiz

Embora seja mais simples realizar todo o processo de instalação do Edge como raiz ou por um usuário que tenha acesso sudo total, nem sempre isso é possível. Em vez disso, é possível separar o processo em tarefas realizadas pelo usuário raiz e por um usuário com acesso total ao sudo para o usuário "apigee".

Tarefas realizadas pelo root:
1. Faça o download e execute o arquivo bootstrap_4.50.00.sh:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
  Esta etapa instala o utilitário apigee-service e cria o usuário "apigee".
2. Configure um usuário para ter acesso sudo total ao usuário "apigee", conforme descrito em Como criar um usuário com acesso sudo total ao usuário "apigee".
3. Instale o utilitário apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
4. Use o utilitário apigee-setup para instalar RPMs do Edge no nó:
```
/opt/apigee/apigee-service/bin/apigee-service compName install
```
  As RPMs do Edge 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.
Depois que o usuário raiz instala os RPMs do Edge no nó, o usuário com acesso sudo completo ao usuário "apigee" conclui o processo de configuração:
1. Use o utilitário setup.sh para concluir a configuração dos componentes de borda no nó. A forma do comando depende dos componentes que você instalou no nó. Para conferir uma lista completa, consulte Instalar componentes de borda 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 realizar uma instalação completa, use o seguinte comando:
```
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
```

Local dos arquivos de configuração de instalação

É preciso 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 ser 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 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 solicitará que ela seja inserida na linha de comando.

Consulte Instalar componentes do Edge em um nó para saber 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.

Depois de instalar ou fazer upgrade, reinicie o componente da interface do Edge em cada nó em que ele está sendo executado.

Instalação na Internet ou fora dela

Para instalar o Edge em um nó, ele precisa ser capaz de acessar o repositório da Apigee:

Nós com uma conexão externa de Internet
Os nós com uma conexão externa de Internet acessam o repositório da Apigee para instalar as dependências e RPMs do Edge.
Nós sem uma conexão externa à Internet
Os nós sem uma conexão externa de Internet podem acessar uma versão espelhada do repositório da 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. Faça o download e instale essas dependências a partir de 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, você pode 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

Um dos motivos para usar um repositório local ou espelhado é instalar o Edge em nós sem conexão de Internet externa, conforme descrito na seção anterior.

Observação:no entanto, há outra vantagem em usar um repositório local, mesmo para nós com uma conexão externa de Internet. Ao instalar o Edge no repositório público do Apigee, você sempre instala as RPMs mais recentes do Edge. Portanto, se você quiser fazer o download e armazenar RPMs do Edge para uma versão específica, 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 do Edge mais recentes 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 de RPMs

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

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 de sistema de arquivos para implantar o Apigee Edge para nuvem privada.

Arquivos de registro

O arquivo de registro de apigee-setup e o script setup.sh são gravados em /tmp/setup-root.log.

Os arquivos de registros de cada componente estão contidos 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 o local 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 usando o Nginx. Para registros adicionais, acesse: `/opt/apigee/var/log/edge-router/nginx` `/opt/nginx/logs`
processador de mensagens	`/opt/apigee/var/log/edge-message-processor`
Servidor Apigee Qpid	`/opt/apigee/var/log/edge-qpid-server`
Servidor Apigee Postgres	`/opt/apigee/var/log/edge-postgres-server`
IU clássica (não a nova interface do Edge, cujo 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 Apigee Qpid	`/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 oferece suporte à 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 do componente que está sendo instalado. O valor padrão é "n" para desativar a verificação.