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
-
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.9.4/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.9.4-d591b23_linux_64
. Renomeie esse diretório paraapigeectl
usando o seguinte comando:mv apigeectl_1.9.4-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ávelapigeectl
está localizado. - Verifique a versão de
apigeectl
com o comandoversion
:./apigeectl version
Version: 1.9.4
-
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
Mac OS
-
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.9.4/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.9.4-d591b23_mac_64
. Renomeie esse diretório paraapigeectl
usando o seguinte comando:mv apigeectl_1.9.4-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ávelapigeectl
está localizado. - Verifique a versão de
apigeectl
com o comandoversion
:./apigeectl version
Version: 1.9.4
-
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
-
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.9.4/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.9.4-d591b23_windows_64
. Renomeie esse diretório comoapigeectl
usando o seguinte comando:rename apigeectl_1.9.4-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ávelapigeectl
está localizado. - Verifique a versão de
apigeectl
com o comandoversion
:./apigeectl version
Version: 1.9.4
-
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 nomehybrid-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 softwareapigeectl
: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
-
Crie uma variável de ambiente para manter o caminho para seu diretório
hybrid-files
:export HYBRID_FILES=$PWD
echo $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 comandoapigeectl
a partir do diretóriohybrid-files
, como no exemplo a seguir:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -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
Mac OS
-
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 nomehybrid-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 softwareapigeectl
: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
-
Crie uma variável de ambiente para manter o caminho para seu diretório
hybrid-files
:export HYBRID_FILES=$PWD
echo $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 comandoapigeectl
a partir do diretóriohybrid-files
, como no exemplo a seguir:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -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 nomehybrid-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 softwareapigeectl
: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.9.4rc1-437dccc_windows_64.zip 08/05/2021 01:38 PM <DIR> hybrid-files
-
Altere o diretório para a pasta
hybrid-files
. -
Crie uma variável de ambiente para manter o caminho para seu diretório
hybrid-files
:set HYBRID_FILES=%CD%
echo %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 comandoapigeectl
a partir do diretóriohybrid-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\
-
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