Passo 8: promova um arquivo para produção

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

Veja a documentação do Apigee Edge.

Neste passo, vai promover um arquivo da configuração do proxy de API para um ambiente de produção na sua organização do Apigee.

  1. Siga os passos em Crie um ambiente para realizar o seguinte:
    1. Crie um novo ambiente prod na sua organização do Apigee, ativando Arquivo como o tipo de implementação. Use a IU ou a API.
    2. Anexe o ambiente a uma instância de tempo de execução através da API de anexos de instâncias.

      Este comando aciona uma operação de longa duração. Certifique-se de que o ambiente foi anexado ao tempo de execução antes de continuar.

    3. Crie um grupo de ambientes, se ainda não tiver um, através da API Create environment groups.

      Certifique-se de que o grupo de ambientes foi criado antes de continuar. Pode verificar o estado do seu novo grupo através de um pedido como o seguinte:

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Associe o novo ambiente ao grupo de ambientes através da API Environment group attachment.

      Anexar um ambiente ao grupo torna os proxies nesse ambiente encaminháveis através dos nomes de anfitrião no grupo. Isto aciona uma operação de longa duração que pode demorar vários minutos a ser concluída. Recomendamos que aguarde um ou dois minutos antes de continuar para o passo seguinte. Entretanto, pode verificar o estado da operação como antes.

  2. Crie um novo ambiente de produção no seu ambiente de desenvolvimento local:
    1. No Apigee no VS Code, posicione o cursor sobre a pasta environments na secção Apigee e clique em Ícone Criar.

      O sinal + é apresentado quando posiciona o cursor sobre a pasta environments

      É aberto o assistente Criar ambiente.

    2. Introduza prod para o nome do ambiente e prima Enter.

      O ambiente é criado.

    3. Expanda a pasta do ambiente prod na secção Apigee para ver o respetivo conteúdo.
    4. Posicione o cursor sobre o ficheiro deployments.json na secção Apigee e clique em Ícone Configurar.

      É aberto o assistente Implementações.

    5. Selecione o proxy da API helloworld para o adicionar à implementação e clique em OK.

      O ficheiro deployments.json é aberto no editor. O ficheiro foi atualizado para incluir o proxy da API helloworld na matriz de implementação proxies, conforme mostrado abaixo:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. Implemente um arquivo da configuração do proxy de API no ambiente prod na sua organização do Apigee.
    1. No separador Terminal no Apigee VS Code, navegue para o diretório myapigeeworkspace.
      cd myapigeeworkspace
    2. Execute o seguinte comando:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      Segue-se um exemplo da resposta:

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. Execute o seguinte comando para verificar o estado da operação, substituindo $OPERATION_ID pelo ID da operação devolvido na chamada anterior:
      gcloud beta apigee operations describe $OPERATION_ID

      Segue-se um exemplo da resposta. Tenha em atenção que state está definido como IN_PROGRESS.

      Using Apigee organization 'prod'
      done: true
      metadata:
        '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
        operationType: INSERT
        state: IN_PROGRESS
        targetResourceName: uri
      name: organizations/prod/operations/$OPERATION_ID
      organization: prod
      response:
        '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
        control: 1-5-0-20210319-071117-ghq74
        endTime: '2021-03-20T06:15:44.329363950Z'
        metricLabels:
          env: test
          location: us-central1
        name: uri
        startTime: '2021-03-20T06:14:44.306534584Z'
        treatment: 1-5-0-20210319-190954-if0wk
        verdict: NONE
      uuid: $OPERATION_ID
    4. Repita o passo anterior até que state esteja definido como FINISHED, o que indica que a implementação do arquivo está concluída.
    5. Execute o seguinte comando para ver todas as implementações de arquivos no ambiente prod:
      gcloud beta apigee archives list --environment=prod

      Segue-se um exemplo da resposta:

      Using Apigee organization 'prod'
      ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
      vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

Parabéns! Promoveu com êxito o seu arquivo de API para um ambiente de produção do Apigee!