Etapa 4: instalar a apigeectl

Você está visualizando a versão 1.5 da documentação da Apigee híbrida. This version is end of life. You should upgrade to a newer version. Para mais informações, consulte Versões compatíveis.

Version 1.5 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Esta etapa explica como fazer o download e instalar o apigeectl.

Fazer o download e instalar apigeectl

apigeectl é a interface de linha de comando (CLI, na sigla em inglês) para instalar e gerenciar o Apigee Hybrid em um cluster do Kubernetes.

As etapas a seguir descrevem como conseguir apigeectl:

1. Faça o download do pacote de lançamento do seu sistema operacional usando o seguinte comando:

   Mac 64 bit:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_64.tar.gz

   Linux de 64 bits:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_64.tar.gz

   Mac 32 bits:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_32.tar.gz

   Linux de 32 bits:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_32.tar.gz

2. Crie um diretório no seu sistema para servir como o diretório base para a instalação do Apigee Hybrid.

3. Extraia o conteúdo do arquivo gzip salvo para o diretório base que você acabou de criar usando o seguinte comando:

   tar xvzf filename.tar.gz -C path-to-base-directory

4. Altere o diretório para o diretório base usando o comando cd.

5. O conteúdo de tar é, por padrão, expandido em um diretório com a versão e a plataforma no nome. Por exemplo, ./apigeectl_1.5.0-d591b23_linux_64. Renomeie esse diretório para apigeectl usando o seguinte comando:

   mv apigeectl_1.5.0-d591b23_linux_64 apigeectl

6. Mude para o diretório usando o seguinte comando:

   cd ./apigeectl

   Esse diretório é o diretório inicial apigeectl. É lá que o comando executável apigeectl está localizado.

7. Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:

   export APIGEECTL_HOME=$PWD

8. Verifique se a variável contém o caminho correto usando o seguinte comando:

   echo $APIGEECTL_HOME

Configurar a estrutura de diretórios do projeto

A estrutura de diretório a seguir é uma abordagem sugerida. Ele separa o software de lançamento do Apigee Hybrid dos arquivos de configuração que você precisa criar. Com o uso da variável $APIGEECTL_HOME e dos links simbólicos criados por você, você pode alternar facilmente para uma nova versão do software. Consulte também Como fazer upgrade do Apigee Hybrid.

Observação: para os fins deste guia de início rápido, as etapas de instalação subsequentes pressupõem que você criou a estrutura do projeto conforme descrito nesta seção. Se você seguir essa estrutura sugerida, será possível copiar e colar a maioria dos comandos de instalação diretamente no terminal.

1. Verifique se você está no diretório base (o diretório onde o diretório apigeectl está localizado) usando o seguinte comando:

   cd $APIGEECTL_HOME/..

2. Crie uma nova pasta chamada hybrid-files usando o seguinte comando. É possível nomear o diretório como quiser, mas, nos documentos, o nome hybrid-files é usado de maneira consistente. Posteriormente, você armazenará arquivos de configuração, chaves de conta de serviço e certificados TLS nessa pasta. Essa pasta permite que você mantenha seus arquivos de configuração separados da instalação de software apigeectl:

   mkdir hybrid-files

3. A estrutura de diretório atual agora é assim:

   pwd && ls
   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Altere o diretório na pasta hybrid-files usando o seguinte comando:

   cd hybrid-files

5. Dentro do diretório hybrid-files, crie os seguintes subdiretórios para organizar os arquivos que você criará posteriormente:

   mkdir overrides
   mkdir certs

6. Dentro do diretório hybrid-files, crie os seguintes links simbólicos para $APIGEECTL_HOME. Esses links permitem que você execute o comando apigeectl a partir do diretório hybrid-files, como no exemplo a seguir:

   Observação: se essa não for a primeira vez que você usou esse processo, os seguintes links simbólicos já podem existir. Verifique se os links já existem usando o seguinte comando: Se os diretórios existirem, pule esta etapa.

   ls -l | grep ^l
   

   ln -s $APIGEECTL_HOME/tools tools
   ln -s $APIGEECTL_HOME/config config
   ln -s $APIGEECTL_HOME/templates templates
   ln -s $APIGEECTL_HOME/plugins plugins

7. Para verificar se os links simbólicos foram criados corretamente, execute este comando e certifique-se de que os caminhos do link apontam para os locais corretos:

   ls -l | grep ^l

Agora você tem uma base inicial para configurar, implantar e gerenciar a Apigee híbrida no cluster do Kubernetes. Em seguida, você criará as contas de serviço e as credenciais do Google Cloud necessárias para configurar os componentes do ambiente de execução híbrido.

1 2 3 4 (PRÓXIMA) Etapa 5: configurar contas de serviço 6 7 8 9