Passo 4: instale o apigeectl

Está a ver a versão 1.7 da documentação do Apigee híbrido. This version is end of life. You should upgrade to a newer version. Para mais informações, consulte Versões suportadas.

Version 1.7 (unsupported)

Versões com suporte:

• v1.15 (mais recente)                        
• v1.14                        
• v1.13                         
• Lista de versões com suporte

Versões sem suporte:

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

Este passo explica como transferir e instalar o apigeectl.

Transfira e instale a app apigeectl

apigeectl é a interface de linhas de comando (CLI) para instalar e gerir o Apigee Hybrid num cluster do Kubernetes.

Os passos seguintes descrevem como transferir e instalar o apigeectl:

Linux

1. Armazene o número da versão mais recente numa variável através do 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 através do seguinte comando. Se quiser usar uma versão diferente, pode guardá-la numa variável de ambiente.

   echo $VERSION

     1.7.6

3. Transfira o pacote de lançamento para o seu sistema operativo através do 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 do Apigee hybrid.

5. Extraia o conteúdo do ficheiro gzip transferido para o diretório base que acabou de criar através do seguinte comando:

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

6. Altere o diretório para o diretório base através do comando cd.

7. Por predefinição, o conteúdo do TAR é expandido para um diretório com a versão e a plataforma no respetivo nome. Por exemplo: ./apigeectl_1.7.6-d591b23_linux_64. Mude o nome desse diretório para apigeectl através do seguinte comando:

   mv apigeectl_1.7.6-d591b23_linux_64 apigeectl

8. Altere para o diretório através do seguinte comando:

   cd ./apigeectl

   Este diretório é o apigeectldiretório inicial. É onde se encontra o comando executável apigeectl.

9. Valide a versão do apigeectl com o comando version:

   ./apigeectl version

   Version: 1.7.6

10. Crie uma variável de ambiente para conter este caminho do diretório base através do seguinte comando:

    export APIGEECTL_HOME=$PWD

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

    echo $APIGEECTL_HOME

Mac OS

1. Armazene o número da versão mais recente numa variável através do seguinte comando:

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

2. Verifique se a variável foi preenchida com um número de versão através do seguinte comando. Se quiser usar uma versão diferente, pode guardá-la numa variável de ambiente.

   echo $VERSION

     1.7.6

3. Transfira o pacote de lançamento para o seu sistema operativo através do 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 do Apigee hybrid.

5. Extraia o conteúdo do ficheiro gzip transferido para o diretório base que acabou de criar através do seguinte comando:

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

6. Altere o diretório para o diretório base através do comando cd.

7. Por predefinição, o conteúdo do TAR é expandido para um diretório com a versão e a plataforma no respetivo nome. Por exemplo: ./apigeectl_1.7.6-d591b23_mac_64. Mude o nome desse diretório para apigeectl através do seguinte comando:

   mv apigeectl_1.7.6-d591b23_mac_64 apigeectl

8. Altere para o diretório através do seguinte comando:

   cd ./apigeectl

   Este diretório é o apigeectldiretório inicial. É onde se encontra o comando executável apigeectl.

9. Valide a versão do apigeectl com o comando version:

   ./apigeectl version

   Version: 1.7.6

10. Crie uma variável de ambiente para conter este caminho do diretório base através do seguinte comando:

    export APIGEECTL_HOME=$PWD

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

    echo $APIGEECTL_HOME

Windows

1. Armazene o número da versão mais recente numa variável através do 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 através do seguinte comando. Se quiser usar uma versão diferente, pode guardá-la numa variável de ambiente.

   echo %VERSION%

     1.7.6

3. Transfira o pacote de lançamento para o seu sistema operativo através do 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 do Apigee hybrid.

5. Extraia o conteúdo do ficheiro .zip transferido para o diretório atual através do seguinte comando:

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

6. Altere o diretório para o diretório base através do comando cd.

7. Por predefinição, o conteúdo do ficheiro TAR é expandido para um diretório com a versão e a plataforma no nome. Por exemplo: .\apigeectl_1.7.6-d591b23_windows_64. Mude o nome desse diretório para apigeectl através do seguinte comando:

   rename apigeectl_1.7.6-d591b23_windows_64 apigeectl

8. Altere para o diretório através do seguinte comando:

   cd .\apigeectl

   Este diretório é o apigeectldiretório inicial. É onde se encontra o comando executável apigeectl.

9. Valide a versão do apigeectl com o comando version:

   ./apigeectl version

   Version: 1.7.6

10. Crie uma variável de ambiente para conter este caminho do diretório base através do seguinte comando:

    set APIGEECTL_HOME=%CD%

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

    echo %APIGEECTL_HOME%

Configure a estrutura de diretórios do projeto

A seguinte estrutura de diretórios é uma abordagem sugerida. Separa o software de lançamento do Apigee Hybrid dos ficheiros de configuração que tem de criar. Através da utilização da variável $APIGEECTL_HOME e das associações simbólicas que criar, pode mudar facilmente para uma nova versão do software, se quiser. Consulte também o artigo Atualizar o Apigee Hybrid.

Nota: para efeitos deste início rápido, os passos de instalação subsequentes partem do princípio de que criou a estrutura do projeto conforme descrito nesta secção. Se seguir esta estrutura sugerida, pode copiar e colar a maioria dos comandos de instalação diretamente no seu terminal.

Linux

1. Certifique-se de que está no diretório base (o diretório onde se encontra o diretório apigeectl) através do seguinte comando:

   cd $APIGEECTL_HOME/..

2. Crie uma nova pasta denominada hybrid-files com o seguinte comando. Pode dar ao diretório o nome que quiser, mas na documentação, o nome hybrid-files é usado de forma consistente. Posteriormente, vai armazenar ficheiros de configuração, chaves de contas de serviço e certificados TLS nesta pasta. Esta pasta permite-lhe manter os ficheiros de configuração separados da instalação do software apigeectl.

   mkdir hybrid-files

3. A estrutura de diretórios atual tem agora o seguinte aspeto:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Altere o diretório para a pasta hybrid-files com o seguinte comando:

   cd hybrid-files

5. No diretório hybrid-files, crie os seguintes subdiretórios para organizar os ficheiros que vai criar mais tarde:

   mkdir overrides
   mkdir certs

6. No diretório hybrid-files, crie os seguintes links simbólicos para $APIGEECTL_HOME. Estes links permitem-lhe executar o comando apigeectl a partir do diretório hybrid-files, como mostra o exemplo seguinte:

   Nota: se não for a primeira vez que usa este processo, os seguintes links simbólicos podem já existir. Verifique se os links já existem através do seguinte comando: Se os diretórios existirem, ignore este passo.

   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 o seguinte comando e certifique-se de que os caminhos dos links apontam para as localizações corretas:

   ls -l | grep ^l

Mac OS

1. Certifique-se de que está no diretório base (o diretório onde se encontra o diretório apigeectl) através do seguinte comando:

   cd $APIGEECTL_HOME/..

2. Crie uma nova pasta denominada hybrid-files com o seguinte comando. Pode dar ao diretório o nome que quiser, mas na documentação, o nome hybrid-files é usado de forma consistente. Posteriormente, vai armazenar ficheiros de configuração, chaves de contas de serviço e certificados TLS nesta pasta. Esta pasta permite-lhe manter os ficheiros de configuração separados da instalação do software apigeectl.

   mkdir hybrid-files

3. A estrutura de diretórios atual tem agora o seguinte aspeto:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Altere o diretório para a hybrid-filespasta através do seguinte comando:

   cd hybrid-files

5. No diretório hybrid-files, crie os seguintes subdiretórios para organizar os ficheiros que vai criar mais tarde:

   mkdir overrides
   mkdir certs

6. No diretório hybrid-files, crie os seguintes links simbólicos para $APIGEECTL_HOME. Estes links permitem-lhe executar o comando apigeectl a partir do diretório hybrid-files, como mostra o exemplo seguinte:

   Nota: se não for a primeira vez que usa este processo, os seguintes links simbólicos podem já existir. Verifique se os links já existem através do seguinte comando: Se os diretórios existirem, ignore este passo.

   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 o seguinte comando e certifique-se de que os caminhos dos links apontam para as localizações corretas:

   ls -l | grep ^l

Windows

1. Certifique-se de que está no diretório base (o diretório onde se encontra o diretório apigeectl) através do seguinte comando:

   cd %APIGEECTL_HOME%\..

2. Crie uma nova pasta denominada hybrid-files com o seguinte comando. Pode dar ao diretório o nome que quiser, mas na documentação, o nome hybrid-files é usado de forma consistente. Posteriormente, vai armazenar ficheiros de configuração, chaves de contas de serviço e certificados TLS nesta pasta. Esta pasta permite-lhe manter os ficheiros de configuração separados da instalação do software apigeectl.

   mkdir hybrid-files

3. A estrutura de diretórios atual tem agora o seguinte aspeto:

   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.7.6rc1-437dccc_windows_64.zip
   08/05/2021  01:38 PM    <DIR>          hybrid-files

4. Altere o diretório para a pasta hybrid-files.
5. No diretório hybrid-files, crie os seguintes subdiretórios para organizar os ficheiros que vai criar mais tarde:

   mkdir overrides
   mkdir certs

6. No diretório hybrid-files, crie os seguintes links simbólicos para $APIGEECTL_HOME. Estes links permitem-lhe executar o comando apigeectl a partir do diretório hybrid-files, como mostra o exemplo seguinte:
   Nota: precisa de privilégios de administrador no seu computador Windows para executar o comando mklink. Pode fazê-lo executando o terminal de comandos como administrador ou usando o comando runas. Por 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\

7. 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, tem uma base a partir da qual pode configurar, implementar e gerir o Apigee hybrid no seu cluster do Kubernetes. Em seguida, vai criar as contas de serviço e as credenciais do Google Cloud necessárias para configurar os componentes de tempo de execução híbrido.

1 2 3 4 (NEXT) Passo 5: configure contas de serviço 6 7 8 9