Parte 1: serviços do Google Cloud e configuração de interface do híbrido

Antes de começar

As etapas descritas neste processo de instalação do híbrido são realizadas com um ou mais dos seguintes procedimentos:

  • Console do Google Cloud
  • IU do híbrido da Apigee
  • Linha de comando gcloud

Variáveis de ambiente

Nas etapas realizadas com a linha de comando, as variáveis de ambiente criadas pelo usuário são usadas. Se a janela do terminal for desconectada, as variáveis de ambiente não serão salvas.

As variáveis de ambiente usadas nestes procedimentos são as seguintes:

Linux / MacOS

export PROJECT_ID="your_project_id"
export ORG_NAME=$PROJECT_ID
export ORG_DISPLAY_NAME="org_friendly_name"
export ORGANIZATION_DESCRIPTION="org_description_text"
export ANALYTICS_REGION="analytics_region"
export RUNTIMETYPE=HYBRID
export ENV_NAME="environment_name"
export ENV_DISPLAY_NAME="env_friendly_name"
export ENV_DESCRIPTION="env_description_text"
export DOMAIN="example.com"
export ENV_GROUP="environment-group-name"
export CLUSTER_NAME="cluster_name"
export CLUSTER_LOCATION="cluster_region"

O conteúdo do nome da variável que contém espaços precisa ser colocado entre aspas duplas. Exemplo:

export ORGANIZATION_DESCRIPTION="My example organization number 1"

Windows

set PROJECT_ID="your_project_id"
set ORG_NAME=$PROJECT_ID
set ORG_DISPLAY_NAME="org_friendly_name"
set ORGANIZATION_DESCRIPTION="org_description_text"
set ANALYTICS_REGION="analytics_region"
set RUNTIMETYPE=HYBRID
set ENV_NAME="environment_name"
set ENV_DISPLAY_NAME="env_friendly_name"
set ENV_DESCRIPTION="env_description_text"
set DOMAIN="example.com"
set ENV_GROUP="environment-group-name"
set CLUSTER_NAME="cluster_name"
set CLUSTER_LOCATION="cluster_region"

O conteúdo do nome da variável que contém espaços precisa ser colocado entre aspas duplas. Exemplo:

set ORGANIZATION_DESCRIPTION="My example organization number 1"

Token de credenciais de autorização

O token de credenciais de autorização gcloud expira após 20 minutos. Se você não concluir todas as etapas nesse tempo, será necessário conseguir as credenciais de autorização novamente. Exemplo:

Na linha de comando, receba as credenciais de autenticação de gcloud usando o comando a seguir:

Linux / MacOS

TOKEN=$(gcloud auth print-access-token)

Windows

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

Outras variáveis de ambiente

Você será solicitado a adicionar mais variáveis de ambiente no processo deste guia, e talvez queira adicioná-las ao script. Exemplo:

  • LONG_RUNNING_OPERATION_ID: o UUID da operação assíncrona e de longa duração que faz parte do processo de criação da organização.
  • APIGEECTL_HOME: o caminho para o diretório em que você instala o utilitário apigeectl.

Visão geral do processo

Nesta seção, você encontra uma visão geral das tarefas que precisa realizar para configurar a IU do híbrido e os serviços do Google Cloud.

O processo geral para configurar a IU do híbrido da Apigee e os serviços do Google Cloud é o seguinte:

Ação Usando Descrição
Etapa 1: criar uma conta do Google Cloud Console do Google Cloud Você precisa de uma conta do Google Cloud para usar esses procedimentos. Esta conta será vinculada a uma nova organização híbrida.
Etapa 2: criar um projeto do Google Cloud Console do Google Cloud Os projetos do Google Cloud formam a base para criar, ativar e usar os serviços do Google Cloud. Um projeto organiza todos os seus recursos do Google Cloud.
Etapa 3: ativar APIs Console do Google Cloud ou linha de comando Sem esses serviços híbridos, não seria possível conversar entre si ou outros serviços.
Etapa 4: criar uma organização Linha de comando Os projetos pertencem a organizações. Com uma organização, você está quase pronto para fazer chamadas de API e criar proxies de API.
Etapa 5: adicionar um ambiente IU híbrida ou linha de comando da Apigee Um ambiente fornece um contexto isolado ou sandbox para executar proxies de API. Em uma única organização, é possível criar vários ambientes. Se não fizer isso, você não poderá concluir a instalação do ambiente de execução híbrido, nem terá onde implantar seus proxies de API.

Próxima etapa

Cada uma dessas etapas é descrita nas seções a seguir.

Vamos lá!