Parte 1: serviços do Google Cloud e configuração da IU híbrida

Antes de começar

Os passos descritos neste processo de instalação híbrida são realizados com uma ou mais das seguintes opções:

  • Consola do Google Cloud
  • IU do Apigee Hybrid
  • gcloud linha de comandos

Variáveis de ambiente

Os passos realizados através da linha de comandos usam variáveis de ambiente criadas pelo utilizador. Se a janela do terminal for desligada, as variáveis de ambiente não são guardadas.

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"

Os conteúdos dos nomes das variáveis que contêm espaços têm de estar entre aspas duplas. Por 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"

Os conteúdos dos nomes das variáveis que contêm espaços têm de estar entre aspas duplas. Por exemplo:

set ORGANIZATION_DESCRIPTION="My example organization number 1"

Token de credenciais de autorização

O símbolo das credenciais de autorização gcloud expira após 20 minutos. Se não concluir todos os passos nesse período, tem de obter novamente as credenciais de autorização. Por exemplo:

Na linha de comando, obtenha as suas credenciais de autenticação gcloud através do seguinte comando:

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

É-lhe pedido que adicione mais variáveis de ambiente no processo deste guia e, por isso, é recomendável adicioná-las ao script. Por exemplo:

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

Vista geral do processo

Esta secção oferece uma vista geral das tarefas que tem de realizar para configurar a IU híbrida e os serviços Google Cloud.

O processo geral de configuração da IU híbrida do Apigee e dos serviços do Google Cloud é o seguinte:

Ação Utilizando Descrição
Passo 1: crie uma conta do Google Cloud Consola do Google Cloud Precisa de uma conta do Google Cloud para usar estes procedimentos. Esta conta vai ser associada a uma nova organização híbrida.
Passo 2: crie um projeto do Google Cloud Consola 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.
Passo 3: ative as APIs Google Cloud Console ou linha de comandos Sem estes, os serviços híbridos não podem comunicar entre si nem com outros serviços.
Passo 4: crie uma organização Linha de comandos Os projetos pertencem a organizações. Depois de ter uma organização, tem quase tudo pronto para fazer chamadas à API e criar proxies de API.
Passo 5: adicione um ambiente Interface do utilizador ou linha de comandos do Apigee Hybrid Um ambiente fornece um contexto isolado ou uma sandbox para executar proxies de API. Numa única organização, pode criar vários ambientes. Se não o fizer, não pode concluir a instalação do tempo de execução híbrido nem tem onde implementar os seus proxies de API.

Passo seguinte

Cada um destes passos é descrito nas secções seguintes.

Vamos lá!