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.

Realizar a etapa

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

  1. Faça login no Cloud usando o seguinte comando:
    gcloud auth login

    O comando inicia uma janela do navegador e solicita que você escolha uma conta (se tiver mais de uma). Em seguida, o Cloud solicitará que você permita o acesso. Você só precisa fazer isso uma vez: não precisará executar este comando, escolher uma conta nem permitir o acesso no futuro.

  2. Inicialize o SDK do Cloud, conforme descrito em Como inicializar o SDK do Cloud. Por exemplo:
    gcloud init

    Durante a inicialização do SDK, insira ou selecione o ID do projeto criado em Pré-requisitos. Defina este projeto como padrão. Você não precisará executar esse comando no futuro, a menos que queira alterar os padrões.

  3. Defina as seguintes variáveis de ambiente para o projeto atual:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
    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"

    Em que:

    • AUTH define o cabeçalho Authentication com um token do portador. Você usará esse cabeçalho ao enviar solicitações HTTP para o proxy da API.
    • 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ê. Se preferir, use 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.

    No exemplo a seguir, definimos variáveis de ambiente para uma organização paga:

    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
    PROJECT_ID="my-cloud-project"
    PROJECT_NUMBER="1234567890"
    RUNTIME_LOCATION="us-west1"
    ANALYTICS_REGION="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.

  4. (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.

    As respostas aos comandos echo precisam ser semelhantes a estas:

    echo $AUTH
    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNaTvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_1CxN
    
    echo $PROJECT_ID
    my-cloud-project
    
    echo $PROJECT_NUMBER
    1234567890
    
    echo $RUNTIME_LOCATION
    us-west1
    
    echo $ANALYTICS_REGION
    us-west1

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