Etapa 4: instalar a apigeectl

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. 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/1.6.9/apigeectl_linux_64.tar.gz
  2. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
  3. 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
  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.6.9-d591b23_linux_64. Renomeie esse diretório para apigeectl usando o seguinte comando:

    mv apigeectl_1.6.9-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. Verifique a versão de apigeectl com o comando version:
    ./apigeectl version
    Version: 1.6.9
  8. Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
    export APIGEECTL_HOME=$PWD
  9. Verifique se a variável contém o caminho correto usando o seguinte comando:
    echo $APIGEECTL_HOME

Mac OS

  1. 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/1.6.9/apigeectl_mac_64.tar.gz
  2. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
  3. 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
  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.6.9-d591b23_mac_64. Renomeie esse diretório para apigeectl usando o seguinte comando:

    mv apigeectl_1.6.9-d591b23_mac_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. Verifique a versão de apigeectl com o comando version:
    ./apigeectl version
    Version: 1.6.9
  8. Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
    export APIGEECTL_HOME=$PWD
  9. Verifique se a variável contém o caminho correto usando o seguinte comando:
    echo $APIGEECTL_HOME

Windows

  1. 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/1.6.9/apigeectl_windows_64.zip
  2. Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
  3. 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
  4. Altere o diretório para o diretório base usando o comando cd.
  5. 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.6.9-d591b23_windows_64. Renomeie esse diretório como apigeectl usando o seguinte comando:

    rename apigeectl_1.6.9-d591b23_windows_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. Verifique a versão de apigeectl com o comando version:
    ./apigeectl version
    Version: 1.6.9
  8. Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
    set APIGEECTL_HOME=%CD%
  9. 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.

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

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

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.6.9rc1-437dccc_windows_64.zip
    08/05/2021  01:38 PM    <DIR>          hybrid-files
  4. Altere o diretório para a pasta 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 executar o comando apigeectl a partir do diretório hybrid-files, como mostra o exemplo a seguir:
    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 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