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
-
gcloudlinha 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_IDexport ORG_DISPLAY_NAME="org_friendly_name"export ORGANIZATION_DESCRIPTION="org_description_text"export ANALYTICS_REGION="analytics_region"export RUNTIMETYPE=HYBRIDexport 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_IDset ORG_DISPLAY_NAME="org_friendly_name"set ORGANIZATION_DESCRIPTION="org_description_text"set ANALYTICS_REGION="analytics_region"set RUNTIMETYPE=HYBRIDset 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=%aOutras 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.