Passo 1: defina variáveis de ambiente

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

O que está a fazer neste passo

Esta secção descreve como definir várias variáveis de ambiente que são usadas ao longo da documentação (e, especialmente, neste tutorial de configuração). A Google recomenda vivamente que os use para poder introduzir os comandos conforme mostrado.

Este é o primeiro de dois passos que vai executar na linha de comandos antes de iniciar o assistente de aprovisionamento do Apigee.

Realize o passo

Para definir variáveis de ambiente na linha de comandos:

  1. Defina as seguintes variáveis de ambiente para o projeto atual: 
    PROJECT_ID="YOUR_PROJECT_ID"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

    Onde:

    • PROJECT_ID é o ID do projeto do Google Cloud que criou como parte dos Pré-requisitos. Se não tiver a certeza do ID do seu projeto, use a Cloud Console ou o comando gcloud projects list para o encontrar.
    • PROJECT_NUMBER é o número do projeto na nuvem que criou como parte dos Pré-requisitos. Este exemplo emite um comando gcloud para obter o número do projeto. Em alternativa, pode encontrá-lo no painel de controlo do projeto da Google Cloud Console ou usar o comando gcloud projects list para o encontrar.

    • RUNTIME_LOCATION é a localização física onde a sua instância está localizada. Os valores válidos são qualquer região do Compute Engine (para organizações pagas) ou zona do Compute Engine (para organizações de avaliação). Para mais informações, consulte o artigo Localizações do Compute Engine.

    • ANALYTICS_REGION é a localização física na qual armazena os seus dados de estatísticas.

      Os valores válidos são um subconjunto das regiões do Compute Engine. Os valores possíveis são os seguintes:

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      As contas de avaliação e pagas usam regiões para a localização do Analytics. Por conseguinte, para organizações pagas, o respetivo valor pode ser o mesmo que o RUNTIME_LOCATION (também uma região). No entanto, o valor de ANALYTICS_REGION não tem de ser o mesmo que RUNTIME_LOCATION. No entanto, pode haver uma vantagem em termos de desempenho se forem iguais.

      Para contas de avaliação, a localização de análise é uma região, mas a localização de tempo de execução é uma zona, pelo que não são iguais.

    • RUNTIME_LOCATION é a localização física onde o conjunto de chaves e a chave da aplicação estão armazenados. O Apigee usa uma chave de aplicação para encriptar dados da aplicação, como KVMs, cache e segredos do cliente, que são armazenados na base de dados.

      Semelhante à região de análise, os valores válidos são um subconjunto das regiões do Compute Engine. O valor pode ser o mesmo que o seu $RUNTIME_LOCATION (também uma região), mas não tem de o ser. Pode haver uma vantagem no desempenho se forem iguais.

    • RUNTIME_LOCATION é o nome do conjunto de chaves no qual a chave de aplicação está armazenada. O nome do conjunto de chaves tem de ser exclusivo da sua organização. Se criar regiões adicionais, os nomes dos conjuntos de chaves dessas regiões não podem ser os mesmos que os nomes dos conjuntos de chaves existentes.
    • APPKEY_KEY_NAME é o nome da chave da aplicação. Os nomes das chaves de aplicação têm de ser exclusivos num determinado conjunto de chaves.
    • DISK_KEY_RING_NAME é o nome do conjunto de chaves do disco. Tem de ser diferente do nome da chave da aplicação. Vai criar o conjunto de chaves do disco na mesma localização que o seu $RUNTIME_LOCATION.
    • DISK_KEY_NAME é o nome da chave de encriptação de disco, que o Apigee usa para encriptar os dados da instância de tempo de execução antes de serem escritos no disco.

    O exemplo seguinte define variáveis de ambiente para uma organização paga. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_LOCATION="us-west1"
APPKEY_KEY_RING_NAME="us-west1"
APPKEY_KEY_NAME="us-west1"
DISK_KEY_RING_NAME="us-west1"
DISK_KEY_NAME="us-west1"

    Se fosse para uma organização de avaliação, o RUNTIME_LOCATION seria definido para uma zona em vez de uma região.

    Vai usar os nomes das variáveis, como $PROJECT_ID, como literais de string nos seus comandos.

    Tenha em atenção que pode não usar todas estas variáveis de ambiente durante o aprovisionamento e a configuração.

  2. (Opcional) Verifique o seu trabalho repetindo os valores que acabou de definir. Tenha em atenção que, quando quiser usar uma variável nos seus comandos, preceda o nome da variável com um cifrão ($). 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_LOCATION
echo $APPKEY_KEY_RING_NAME
echo $APPKEY_KEY_NAME
echo $DISK_KEY_RING_NAME
echo $DISK_KEY_NAME

    As respostas aos seus comandos echo devem ter o seguinte aspeto:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

Se encontrar erros durante esta parte do processo, consulte a secção Resolução de problemas.

1 SEGUINTE: ative as APIs 3 4 5 6 7 8