O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Instalar o utilitário Edge de configuração da Apigee

Edge para nuvem privada v. 4.16.09

Para instalar o Edge em um nó, primeiro instale o utilitário apigee-setup do Edge. Se você estiver em um ambiente em que os nós não têm uma conexão de Internet externa, também será necessário instalar uma cópia local do repositório da Apigee.

Como criar um link simbólico de /opt/apigee

O Edge instala todos os arquivos no diretório /opt/apigee. Não é possível alterar esse diretório. No entanto, se quiser, você pode criar um link simbólico para mapear /opt/apigee para outro local.

Antes de criar o link simbólico, é preciso criar um usuário e um grupo chamados "apigee". Esse é o mesmo grupo e usuário criado pelo instalador do Edge.

Para criar o link simbólico, siga estas etapas antes de fazer o download do arquivo bootstrap_4.16.09.sh. Você precisa executar todas estas etapas como raiz:

Crie o usuário e o grupo "apigee":
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
Crie um link simbólico de /opt/apigee para a raiz de instalação desejada:
> ln -Ts /srv/myInstallDir /opt/apigee
em que /srv/myInstallDir é o local desejado dos arquivos do Edge.
Mude a propriedade da raiz de instalação e do link simbólico para o usuário "apigee":
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Pré-requisito: desativar o SELinux

É preciso desativar o SELinux ou defini-lo como modo permissivo antes de instalar o utilitário apigee-setup do Edge ou qualquer componente do Edge. Se necessário, depois de instalar o Edge, reative o SELinux.

Para definir temporariamente o SELinux como modo permissivo, execute o seguinte comando:
1. Em um sistema operacional Linux 6.x:
  echo 0 > /selinux/enforce
  
  Para reativar o SELinux após instalar o Edge:
  echo 1 > /selinux/enforce
2. Em um sistema operacional Linux 7.x:
  setenforce 0
  
  Para reativar o SELinux após instalar o Edge:
  setenforce 1
Para desativar o SELinux permanentemente ou defini-lo como modo permissivo:
1. Abra /etc/sysconfig/selinux em um editor.
2. Defina SELINUX=disabled ou SELINUX=permissive.
3. Salve as mudanças.
4. Reinicie o nó.
5. Se necessário, reative o SELinux após a instalação do Edge repetindo este procedimento para definir SELINUX=enabled.

Instale o utilitário apigee-setup do Edge em um nó com uma conexão de Internet externa

Para instalar o Edge em um nó com uma conexão de Internet externa:

Consiga o nome de usuário e a senha da Apigee que você usa para acessar o repositório da Apigee. Se você já tiver um nome de usuário:senha para o site de FTP da Apigee, use essas credenciais.
Faça login no nó como raiz para instalar os RPMs do Edge
Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
Desative o SELinux conforme descrito acima.
Faça o download do arquivo bootstrap_4.16.09.sh do Edge para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Instale o utilitário apigee-service do Edge e as dependências:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.

Por padrão, o instalador verifica se o Java 1.8 está instalado. Se não tiver, ele será instalado para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa os seguintes valores:

I = Instalar o OpenJDK 1.8 (padrão)
C = Continuar sem instalar o Java
Q = Sair. Para essa opção, você precisa instalar o Java por conta própria.

A instalação do utilitário apigee-service cria o arquivo /etc/yum.repos.d/apigee.repo, que define o repositório da Apigee. Para ver o arquivo de definição, use o comando:
> cat /etc/yum.repos.d/apigee.repo

Para ver o conteúdo do repositório, use o comando:
> sudo yum -v repolist 'apigee*'
Use apigee-service para instalar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Use apigee-setup para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes do Edge em um nó para mais informações.

Instalar o utilitário apigee-setup do Edge em um nó sem conexão de internet externa

Se os nós do Edge estiverem protegidos por um firewall ou, de alguma outra forma, proibidos de acessar o repositório da Apigee pela Internet, será necessário criar um repositório local ou espelho do repositório da Apigee. Esse espelho precisa ser acessível para todos os nós. Depois de criados, os nós podem acessar esse espelho local para instalar o Edge.

Observação: a Apigee não hospeda todas as dependências de terceiros nos nossos repositórios públicos. É necessário baixar e instalar essas dependências de repositórios acessíveis publicamente.

Depois de criar um repositório local do Edge, talvez seja necessário atualizá-lo com os arquivos de versão mais recentes do Edge. As seções a seguir descrevem como criar e atualizar um repositório local.

Criar um repositório local da Apigee

Para criar um repositório local da Apigee:

Consiga o nome de usuário e a senha da Apigee que você usa para acessar o repositório da Apigee. Se você já tiver um nome de usuário:senha para o site de FTP da Apigee, use essas credenciais.
Faça login no nó do RedHat ou do CentOS como raiz para instalar os RPMs do Edge.
Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
Verifique se você tem a versão mais recente do yum-utils:
> sudo yum update yum-utils
Desative o SELinux conforme descrito acima.
Faça o download do arquivo bootstrap_4.16.09.sh do Edge para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Instale o utilitário apigee-service do Edge e as dependências:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.
Instale o utilitário apigee-mirror no nó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

Observação: se você estiver atualizando um repositório para a versão 4.16.09, só será necessário atualizar apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Use o utilitário apigee-mirror para sincronizar o repositório da Apigee com o diretório /opt/apigee/data/apigee-mirror/repos/.

Para minimizar o tamanho do repositório, inclua --only-new-rpms para fazer o download apenas dos RPMs mais recentes. Você precisa de aproximadamente 1,6 GB de espaço em disco para o download:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Se você quiser fazer o download de todo o repositório, incluindo RPMs mais antigos, omita --only-new-rpms. Você precisa de aproximadamente 6 GB de espaço em disco para o download completo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Agora você tem uma cópia local do repositório da Apigee. A próxima seção descreve como instalar o utilitário apigee-setup do Edge no repositório local.
(Opcional) Se você quiser instalar o Edge do repositório local no mesmo nó que hospeda o repositório local, primeiro execute os seguintes comandos:
1. Execute bootstrap_4.16.09.sh no repositório local para instalar o utilitário apigee-service:
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. Use apigee-service para instalar o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
3. Use apigee-setup para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes do Edge em um nó para mais informações.

Instalar o apigee-setup em um nó remoto do repositório local

Você tem duas opções para instalar o Edge do repositório local. Você pode fazer o seguinte:

Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e instale o Edge usando o arquivo .tar.
Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. Nginx e até mesmo o servidor da Web Apache.

Instale usando o arquivo .tar:

No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Copie o arquivo .tar para o nó em que você quer instalar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
No novo nó, desative o SELinux conforme descrito acima.
No novo nó, descompacte o arquivo no diretório /tmp:
> tar -xzf apigee-4.16.09.tar.gz

Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.
Instale o utilitário apigee-service do Edge e as dependências de /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Observe que você inclui o caminho para o diretório de repositórios neste comando.
Use apigee-service para instalar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Use apigee-setup para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes do Edge em um nó para mais informações.

Instale do repositório usando o servidor da Web Nginx:

Instale o servidor da Web Nginx no nó do repositório:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
Por padrão, o Nginx é configurado para usar localhost como o nome do servidor e a porta 3939. Para mudar esses valores
1. Abra /opt/apigee/customer/application/mirror.properties em um editor. Crie o arquivo, caso ele não exista.
2. Defina os seguintes valores conforme necessário:
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. Reinicie o Nginx:
  > /opt/nginx/scripts/apigee-nginx restart
Por padrão, o repositório exige um nome de usuário:senha de admin:admin. Para mudar essas credenciais, defina as seguintes variáveis de ambiente:
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
No novo nó, desative o SELinux conforme descrito acima.
No nó remoto, faça o download do arquivo bootstrap_4.16.09.sh do Edge para /tmp/bootstrap_4.16.09.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

em que uName:pWord são o nome de usuário e a senha que você definiu acima para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.
No nó remoto, instale o utilitário apigee-service do Edge e as dependências:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

em que uName:pWord são o nome de usuário e a senha do repositório.
No nó remoto, use apigee-service para instalar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Use apigee-setup para instalar e configurar componentes do Edge no nó remoto. Consulte Instalar componentes do Edge em um nó para mais informações.

Atualizar um repositório local da Apigee

Para atualizar o repositório, faça o download do arquivo bootstrap_4.16.09.sh mais recente e realize uma nova sincronização:

Faça o download do arquivo bootstrap_4.16.09.sh do Edge para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Execute o arquivo bootstrap_4.16.09.sh do Edge:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que você o insira.
Atualize apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Realize a sincronização:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Se você quiser fazer o download de todo o repositório:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Limpar um repositório local da Apigee

A limpeza do repositório local exclui /opt/apigee/data/apigee-mirror e /var/tmp/yum-apigee-*.

Para limpar o repositório local, use:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Adicionar ou atualizar o Edge 4.16.01/4.16.05 em um repositório 4.16.09

Se você precisar manter instalações para o Edge 4.16.01 e 4.16.05 em um repositório 4.16.09, poderá manter um repositório que contenha todas as versões. Nesse repositório, é possível instalar qualquer versão do Edge.

Para adicionar 4.16.01/4.16.05 a um repositório 4.16.09:

Verifique se você instalou a versão 4.16.09 do utilitário apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

Você verá um resultado no formato abaixo, em que xyz é o número da versão:
apigee-mirror-4.16.09-0.0.xyz
Use o utilitário apigee-mirror para fazer o download do Edge 4.16.01 ou 4.16.05 para seu repositório. Observe como você prefixa o comando com apigeereleasever=4.16.01 ou apigeereleasever=4.16.05:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Use esse mesmo comando para atualizar o repositório 4.16.01/4.16.05 posteriormente.
Examine o diretório /opt/apigee/data/apigee-mirror/repos para ver a estrutura do arquivo:
> ls /opt/apigee/data/apigee-mirror/repos

Você verá os seguintes arquivos e diretórios:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.16.09.sh thirdparty

Observe que você tem um arquivo de inicialização para todas as versões do Edge. O diretório apigee também contém diretórios separados para cada versão do Edge.
Para empacotar o repositório em um arquivo .tar, use o seguinte comando:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

Esse comando empacota os repositórios 4.16.09 e 4.16.01 no mesmo arquivo .tar. Não é possível empacotar apenas parte do repositório.

Para instalar o Edge do repositório local ou do arquivo .tar, execute o arquivo de inicialização correto usando um dos seguintes comandos:

Se você estiver instalando de um arquivo .tar, execute o arquivo de inicialização correto do repositório:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Para concluir a instalação, siga as etapas restantes de "Instalar do arquivo .tar" acima.
Se você estiver instalando usando o servidor da Web Nginx, faça o download e execute o arquivo de inicialização correto do repositório:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

Para concluir a instalação, siga as etapas restantes de "Instalar do repositório usando o servidor da Web Nginx" acima.