Etapa 8: promova um arquivo para produção

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Nesta etapa, você promoverá um arquivo da configuração do proxy de API para um ambiente de produção na sua organização da Apigee.

  1. Siga as etapas em Criar um ambiente para realizar o seguinte:
    1. Crie um novo ambiente prod na sua organização da Apigee, ativando Archive como o tipo de implantação. Use a IU ou a API.

      Por exemplo:

      Nova caixa de diálogo de ambiente mostrando as configurações de tipo de implantação de Arquivos

    2. Anexe o ambiente à instância de ambiente de execução usando a API Instances attachment.

      Esse comando aciona uma operação de longa duração. Verifique se o ambiente foi anexado ao ambiente de execução antes de continuar.

    3. Crie um grupo de ambiente, se você ainda não tiver um, usando a API de criação de grupos de ambiente.

      Verifique se o grupo de ambiente foi criado antes de continuar. Verifique o status do novo grupo usando uma solicitação como esta:

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

      Anexar um ambiente ao grupo deixa os proxies nesse ambiente roteáveis pelos nomes dos hosts no grupo. Isso aciona uma operação de longa duração que pode levar vários minutos para ser concluída. Recomendamos que você aguarde um ou dois minutos antes de prosseguir para a próxima etapa. Enquanto isso, verifique o status da operação como antes.

  2. Crie um novo ambiente prod no seu ambiente de desenvolvimento local:
    1. Na Apigee, no VS Code, posicione o cursor sobre a pasta ambientes na seção da Apigee e clique em Ícone de criação.

      + é exibido quando você posiciona o cursor sobre a pasta de ambientes

      O assistente "Criar ambiente" é aberto.

    2. Digite prod como nome do ambiente e pressione Enter.

      O ambiente é criado.

    3. Expanda a pasta do ambiente prod na seção da Apigee para ver o conteúdo dela.
    4. Posicione o cursor sobre o arquivo deployments.json na seção da Apigee e clique em Ícone de configuração.

      O assistente Implantações é aberto.

    5. Selecione o proxy de API helloworld para adicioná-lo à implantação e clique em helloworld.

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

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

      Veja a seguir um exemplo de resposta:

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

      Veja a seguir um exemplo de resposta. 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 a etapa anterior até que state seja definido como FINISHED, indicando que a implantação do arquivo foi concluída.
    5. Execute o seguinte comando para visualizar todas as implantações de arquivo no ambiente prod:
      gcloud beta apigee archives list --environment=prod

      Veja a seguir um exemplo de 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! Você promoveu seu arquivo de API para um ambiente de produção da Apigee.