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

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)

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

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

Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
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
```
Altere o diretório para o diretório base usando o comando cd.
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.7.6-d591b23_linux_64. Renomeie esse diretório para apigeectl usando o seguinte comando:
```
mv apigeectl_1.7.6-d591b23_linux_64 apigeectl
```
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.
Verifique a versão de apigeectl com o comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
```
export APIGEECTL_HOME=$PWD
```
Verifique se a variável contém o caminho correto usando o seguinte comando:
```
echo $APIGEECTL_HOME
```

macOS

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)

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

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

Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
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
```
Altere o diretório para o diretório base usando o comando cd.
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.7.6-d591b23_mac_64. Renomeie esse diretório para apigeectl usando o seguinte comando:
```
mv apigeectl_1.7.6-d591b23_mac_64 apigeectl
```
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.
Verifique a versão de apigeectl com o comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
```
export APIGEECTL_HOME=$PWD
```
Verifique se a variável contém o caminho correto usando o seguinte comando:
```
echo $APIGEECTL_HOME
```

Windows

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

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

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

Crie um diretório no seu sistema para servir como o diretório base para a instalação da Apigee híbrida.
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
```
Altere o diretório para o diretório base usando o comando cd.
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.7.6-d591b23_windows_64. Renomeie esse diretório como apigeectl usando o seguinte comando:
```
rename apigeectl_1.7.6-d591b23_windows_64 apigeectl
```
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.
Verifique a versão de apigeectl com o comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
Crie uma variável de ambiente para manter esse caminho do diretório inicial usando o seguinte comando:
```
set APIGEECTL_HOME=%CD%
```
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

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

A estrutura de diretório atual agora é assim:

pwd && ls

/hybrid-base-directory
  apigeectl
  hybrid-files

Altere o diretório na pasta hybrid-files usando o seguinte comando:
```
cd hybrid-files
```
Dentro do diretório hybrid-files, crie os seguintes subdiretórios para organizar os arquivos que você criará posteriormente:
```
mkdir overrides
mkdir certs
```
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
```
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
```

macOS

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

A estrutura de diretório atual agora é assim:

pwd && ls

/hybrid-base-directory
  apigeectl
  hybrid-files

Altere o diretório na pasta hybrid-files usando o seguinte comando:
```
cd hybrid-files
```
Dentro do diretório hybrid-files, crie os seguintes subdiretórios para organizar os arquivos que você criará posteriormente:
```
mkdir overrides
mkdir certs
```
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
```
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

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%\..
```
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
```

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

Altere o diretório para a pasta hybrid-files.
Dentro do diretório hybrid-files, crie os seguintes subdiretórios para organizar os arquivos que você criará posteriormente:
```
mkdir overrides
mkdir certs
```
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\
```

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 (A SEGUIR) Etapa 5: configurar contas de serviço 6 7 8 9

Etapa 4: instalar a apigeectl

Fazer o download e instalar apigeectl

Linux

macOS

Windows

Configurar a estrutura de diretórios do projeto

Linux

macOS

Windows

Fazer o download e instalar `apigeectl`