Etapa 1: definir variáveis de ambiente

Você está vendo a documentação da Apigee X.
Ver a documentação da Apigee Edge

O que você está fazendo nesta etapa

Nesta seção, descrevemos como definir várias variáveis de ambiente que são usadas em toda a documentação (e principalmente neste tutorial de configuração). O Google recomenda o uso deles para que você possa inserir os comandos conforme mostrado.

Esta é a primeira de duas etapas que serão executadas na linha de comando antes de iniciar o assistente de provisionamento da Apigee.

Realizar a etapa

Para definir variáveis de ambiente na linha de comando, siga estas etapas:

  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"
    APPKEY_LOCATION="APPKEY_LOCATION"
    APPKEY_KEY_RING_NAME="APPKEY_KEY_RING_NAME"
    APPKEY_KEY_NAME="APPKEY_KEY_NAME"
    DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
    DISK_KEY_NAME="DISK_KEY_NAME"
    

    Em que:

    • PROJECT_ID é o ID do projeto do Cloud que você criou como parte dos pré-requisitos. Se você não tiver certeza de qual é o ID do projeto, use o Console do Cloud ou o comando gcloud projects list para encontrá-lo.
    • PROJECT_NUMBER é o número do projeto do Cloud que você criou como parte dos pré-requisitos. Este exemplo emite um comando gcloud para receber o número do projeto para você. Como alternativa, você pode encontrá-lo no painel do projeto do Console do Google Cloud ou usar o comando gcloud projects list para encontrá-lo.
    • RUNTIME_LOCATION é o local físico em que a instância está localizada. Os valores válidos são qualquer região do Compute Engine (para organizações pagas) ou zonas do Compute Engine (para organizações de avaliação). Para mais informações, consulte Locais do Compute Engine.

    • ANALYTICS_REGION é o local físico em que você armazena seus dados de análise.

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

      • 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 o local da análise. Portanto, para organizações pagas, o valor pode ser igual ao RUNTIME_LOCATION (também uma região). Porém, o valor de ANALYTICS_REGION não precisa ser igual ao de RUNTIME_LOCATION. No entanto, isso poderá resultar em uma melhoria no desempenho.

      Para contas de avaliação, o local de análise é uma região, mas o local do ambiente de execução é uma zona, então eles não serão iguais.

    • RUNTIME_LOCATION é o local físico em que o keyring e a chave do app são armazenados. A Apigee usa uma chave para criptografar os dados do aplicativo, como KVMs, cache e chaves secretas do cliente, que são armazenadas no banco de dados.

      Assim como a região de análise, os valores válidos são um subconjunto das regiões do Compute Engine. O valor pode ser igual ao seu $RUNTIME_LOCATION (também uma região), mas não precisa ser. Pode haver um benefício de desempenho se forem iguais.

    • RUNTIME_LOCATION é o nome do keyring em que a chave do app está armazenada. O nome do keyring precisa ser exclusivo para sua organização. Se você criar outras regiões, os nomes dos keyrings dessas regiões não poderão ser iguais aos nomes dos keyrings existentes.
    • APPKEY_KEY_NAME é o nome da chave do aplicativo. Os nomes das chaves de aplicativos precisam ser exclusivos dentro de um determinado keyring.
    • DISK_KEY_RING_NAME é o nome do keyring de chave de disco. Ele precisa ser diferente do nome da chave do aplicativo. O keyring será criado no mesmo local que o $RUNTIME_LOCATION.
    • Disco_KEY_NAME é o nome da chave de criptografia de disco, que a Apigee usa para criptografar os dados da instância do ambiente de execução antes de serem gravados no disco.

    No exemplo a seguir, definimos 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"
    APPKEY_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 uma organização de avaliação, RUNTIME_LOCATION seria definido como uma zona em vez de uma região.

    Você usará os nomes de variáveis, como $PROJECT_ID como literais de string nos comandos.

    Talvez você não use todas essas variáveis de ambiente durante o provisionamento e a configuração.

  2. (Opcional) Verifique seu trabalho incluindo os valores que você acabou de definir. Quando quiser usar uma variável nos comandos, coloque o cifrão ($) antes do nome dela.
    echo $PROJECT_ID
    echo $PROJECT_NUMBER
    echo $ANALYTICS_REGION
    echo $APPKEY_LOCATION
    echo $APPKEY_KEY_RING_NAME
    echo $APPKEY_KEY_NAME
    echo $DISK_KEY_RING_NAME
    echo $DISK_KEY_NAME
    

    As respostas aos comandos echo precisam ser semelhantes a estas:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
    TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
    1CxN
    my-cloud-project
    1234567890
    us-west1
    us-west1
    us-west1
    my-app-key-ring
    my-app-key
    my-disk-key-ring
    my-disk-key
    

Se você encontrar erros durante essa parte do processo, consulte Solução de problemas.


1 A SEGUIR: Ativar APIs 3 4 5 6 7 8 9