Passo 4: instale o apigeectl

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 obter apigeectl:

  1. Transfira o pacote de lançamento para o seu sistema operativo através do seguinte comando:

    Mac 64 bits:

    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 de 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 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
  4. Altere o diretório para o diretório base através do comando cd.

  5. 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.5.0-d591b23_linux_64. Mude o nome desse diretório para apigeectl através do seguinte comando:

    mv apigeectl_1.5.0-d591b23_linux_64 apigeectl
  6. 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.

  7. Crie uma variável de ambiente para conter este caminho do diretório base através do seguinte comando: 
    export APIGEECTL_HOME=$PWD
  8. 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.

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

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