CodeBuild detalles y ejemplos de los parámetros de aprovisionamiento

Puede definir los parámetros en las plantillas para los AWS Proton recursos CodeBuild basados y hacer referencia a estos parámetros en el código de aprovisionamiento. Para obtener una descripción detallada de AWS Proton los parámetros, los tipos de parámetros, el espacio de nombres de los parámetros y cómo utilizar los parámetros en los archivos de IaC, consulte. AWS Proton parámetros

Parámetros de entrada

Cuando crea un AWS Proton recurso, como un entorno o un servicio, proporciona valores para los parámetros de entrada que se definen en el archivo de esquema de la plantilla. Cuando el recurso que cree los utilizaAprovisionamiento de CodeBuild, AWS Proton renderiza estos valores de entrada en un archivo de entrada. El código de aprovisionamiento puede importar y obtener valores de parámetros de este archivo.

Para ver un ejemplo de CodeBuild plantilla, consulteCodeBuild paquete de plantillas de aprovisionamiento. Para obtener más información sobre los archivos de manifiesto, consulte Resuma los archivos de plantilla para AWS Proton.

El siguiente ejemplo es un archivo de entrada JSON generado durante el aprovisionamiento CodeBuild basado de una instancia de servicio.

{
  "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 salida

Para volver a comunicar los resultados del aprovisionamiento de recursos AWS Proton, el código de aprovisionamiento puede generar un archivo JSON proton-outputs.json con el nombre de los valores de los parámetros de salida definidos en el archivo de esquema de la plantilla. Por ejemplo, el cdk deploy comando tiene el --outputs-file argumento que le indica que genere un archivo JSON con AWS CDK los resultados del aprovisionamiento. Si tu recurso usa el AWS CDK, especifica el siguiente comando en el manifiesto de la CodeBuild plantilla:

aws proton notify-resource-deployment-status-change

AWS Proton busca este archivo JSON. Si el archivo existe después de que el código de aprovisionamiento se haya completado correctamente, AWS Proton lee los valores de los parámetros de salida del mismo.