Esta etapa explica como fazer o download e instalar o apigeectl, configurar os diretórios de instalação e criar contas de serviço do GCP e credenciais TLS necessárias para o Apigee híbrido operar.
Fazer o download e instalar apigeectl
apigeectl
é a interface de linha de comando
(CLI, na sigla em inglês) para instalar e gerenciar o Apigee Hybrid em um cluster do Kubernetes.
As etapas a seguir descrevem como conseguir apigeectl
:
-
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.4.0
-
Faça o download do pacote de lançamento do seu sistema operacional usando o seguinte comando:
Mac 64 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
Linux de 64 bits:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
Mac 32 bits:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz
Linux de 32 bits:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz
- Crie um diretório no seu sistema para servir como o diretório base para a instalação do Apigee Hybrid.
-
Extraia o conteúdo do arquivo gzip salvo para o 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.4.0-d591b23_linux_64
. Renomeie esse diretório paraapigeectl
usando o seguinte comando:mv apigeectl_1.4.0-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. -
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
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.
-
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
-
Dentro do diretório
hybrid-files
, crie os seguintes subdiretórios para organizar os arquivos que você criará posteriormente:mkdir overrides
mkdir service-accounts
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
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