CodeBuild detalhes e exemplos de parâmetros de provisionamento

Você pode definir parâmetros em seus modelos para AWS Proton recursos CodeBuild baseados e referenciar esses parâmetros em seu código de provisionamento. Para obter uma descrição detalhada dos AWS Proton parâmetros, dos tipos de parâmetros, do namespace do parâmetro e de como usar os parâmetros em seus arquivos IaC, consulte. AWS Proton parâmetros

nota

Você pode usar o CodeBuild provisionamento com ambientes e serviços. No momento, você não pode provisionar componentes dessa forma.

Parâmetros de entrada

Ao criar um AWS Proton recurso, como um ambiente ou um serviço, você fornece valores para os parâmetros de entrada definidos no arquivo de esquema do seu modelo. Quando o recurso que você cria usaProvisionamento do CodeBuild, AWS Proton renderiza esses valores de entrada em um arquivo de entrada. Seu código de aprovisionamento pode importar e obter valores de parâmetros desse arquivo.

Para obter um exemplo de um CodeBuild modelo, consulteCodeBuild pacote de modelos de provisionamento. Para obter mais informações sobre arquivos manifesto, consulte Encapsular arquivos de modelo para AWS Proton.

O exemplo a seguir é um arquivo de entrada JSON gerado durante o provisionamento CodeBuild baseado de uma instância de serviço.

Exemplo: usando o AWS CDK com CodeBuild provisionamento

{
  "service_instance": {
    "name": "my-service-staging",
    "inputs": {
      "port": "8080",
      "task_size": "medium"
    }
  },
  "service": {
    "name": "my-service"
  },
  "environment": {
    "account_id": "123456789012",
    "name": "my-env-staging",
    "outputs": {
      "vpc-id": "hdh2323423"
    }
  }
}

Parâmetros de saída

Para devolver as saídas do provisionamento de recursos AWS Proton, seu código de provisionamento pode gerar um arquivo JSON nomeado proton-outputs.json com valores para os parâmetros de saída definidos no arquivo de esquema do seu modelo. Por exemplo, o cdk deploy comando tem o --outputs-file argumento que instrui o AWS CDK a gerar um arquivo JSON com saídas de provisionamento. Se seu recurso usa o AWS CDK, especifique o seguinte comando no manifesto CodeBuild do modelo:

aws proton notify-resource-deployment-status-change

AWS Proton procura esse arquivo JSON. Se o arquivo existir após a conclusão bem-sucedida do código de provisionamento, AWS Proton lerá os valores dos parâmetros de saída dele.