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.