Etapa 3: instalar a apigeectl

Você está visualizando a versão 1.11 da documentação da Apigee híbrida. Para mais informações, consulte Versões compatíveis.

Version 1.11 

Versões com suporte:

• v1.12 (mais recente)
• v1.11
• v1.10
• Lista de versões com suporte

Versões sem suporte:

• 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 a Apigee híbrida em um cluster do Kubernetes.

As etapas a seguir descrevem como fazer o download e a instalação do apigeectl:

Linux

1. Armazene o número da versão mais recente em uma variável usando o seguinte comando:

   export VERSION=$(curl -s \
       "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

2. Verifique se a variável foi preenchida com um número de versão usando o seguinte comando: Se você quiser usar uma versão diferente, salve-a em uma variável de ambiente.

   echo $VERSION

     1.11.2

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

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

4. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.

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

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

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

7. 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.11.2-d591b23_linux_64. Renomeie esse diretório para apigeectl usando o seguinte comando:

   mv apigeectl_1.11.2-d591b23_linux_64/ apigeectl

8. 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.

9. Verifique a versão de apigeectl com o comando version:

   ./apigeectl version

   Version: 1.11.2

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

    export APIGEECTL_HOME=$PWD

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

    echo $APIGEECTL_HOME

Mac OS

1. Armazene o número da versão mais recente em uma variável usando o seguinte comando:

   export VERSION=$(curl -s \
       "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

2. Verifique se a variável foi preenchida com um número de versão usando o seguinte comando: Se você quiser usar uma versão diferente, salve-a em uma variável de ambiente.

   echo $VERSION

     1.11.2

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

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

4. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.

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

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

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

7. 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.11.2-d591b23_mac_64. Renomeie esse diretório para apigeectl usando o seguinte comando:

   mv apigeectl_1.11.2-d591b23_mac_64 apigeectl

8. 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.

9. Verifique a versão de apigeectl com o comando version:

   ./apigeectl version

   Version: 1.11.2

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

    export APIGEECTL_HOME=$PWD

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

    echo $APIGEECTL_HOME

Windows

1. Armazene o número da versão mais recente em uma variável usando o seguinte comando:

   for /f "tokens=*" %a in ('curl -s ^
     https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
   do set VERSION=%a

2. Verifique se a variável foi preenchida com um número de versão usando o seguinte comando: Se você quiser usar uma versão diferente, salve-a em uma variável de ambiente.

   echo %VERSION%

     1.11.2

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

   curl -LO ^
     https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

4. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.

5. Extraia o conteúdo do arquivo ZIP salvo no diretório atual usando o seguinte comando:

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

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

7. O conteúdo do arquivo tar é, por padrão, expandido em um diretório com a versão e a plataforma no nome. Por exemplo, .\apigeectl_1.11.2-d591b23_windows_64. Renomeie esse diretório como apigeectl usando o seguinte comando:

   rename apigeectl_1.11.2-d591b23_windows_64 apigeectl

8. 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.

9. Verifique a versão de apigeectl com o comando version:

   ./apigeectl version

   Version: 1.11.2

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

    set APIGEECTL_HOME=%CD%

11. 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.

Linux

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. Crie uma variável de ambiente para manter o caminho para seu diretório hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

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

   mkdir overrides
   mkdir certs

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

8. 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

Mac OS

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. Crie uma variável de ambiente para manter o caminho para seu diretório hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

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

   mkdir overrides
   mkdir certs

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

8. 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

Windows

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:

   dir

    Directory of C:\Users\example\hybrid
   
   08/05/2021  01:38 PM    <DIR>          .
   08/05/2021  01:38 PM    <DIR>          ..
   08/02/2021  01:11 PM    <DIR>          apigeectl
   08/02/2021  11:13 AM         5,803,963 apigeectl_1.11.2rc1-437dccc_windows_64.zip
   08/05/2021  01:38 PM    <DIR>          hybrid-files

4. Altere o diretório para a pasta hybrid-files.
5. Crie uma variável de ambiente para manter o caminho para seu diretório hybrid-files:

   set HYBRID_FILES=%CD%

   echo %HYBRID_FILES%

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

   mkdir overrides
   mkdir certs

7. Dentro do diretório hybrid-files, crie os seguintes links simbólicos para $APIGEECTL_HOME. Esses links permitem executar o comando apigeectl a partir do diretório hybrid-files, como mostra o exemplo a seguir:
   Observação: você vai precisar do privilégio de administrador no computador Windows para executar o comando mklink. Para isso, execute o terminal de comando como administrador ou use o comando runas. Exemplo:

   runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
   

   mklink /d config %APIGEECTL_HOME%\config\
   mklink /d plugins %APIGEECTL_HOME%\plugins\
   mklink /d templates %APIGEECTL_HOME%\templates\
   mklink /d tools %APIGEECTL_HOME%\tools\

8. Para verificar se os links simbólicos foram criados corretamente, use dir:

   dir

    Directory of C:\Users\example\hybrid\hybrid-files
   
   08/05/2021  01:56 PM    <DIR>          .
   08/05/2021  01:56 PM    <DIR>          ..
   08/05/2021  01:46 PM    <DIR>          certs
   08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
   08/05/2021  01:46 PM    <DIR>          overrides
   08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
   08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
   08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]
       

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 (Próxima) Etapa 4: configurar contas de serviço 5 6 7 8 9 10