AWS Proton parámetros

PDFRSS

Puede definir y usar los parámetros de su infraestructura como archivos de código (IaC) para hacerlos flexibles y reutilizables. Para leer el valor de un parámetro en los archivos IaC, consulte el nombre del parámetro en el espacio de nombres del parámetro. AWS Proton AWS Proton inyecta valores de parámetros en los archivos IaC renderizados que genera durante el aprovisionamiento de recursos. Para procesar los parámetros de AWS CloudFormation IaC, usa Jinja. AWS Proton Para procesar los parámetros del IaC de Terraform, AWS Proton genera un archivo de valores de parámetros de Terraform y se basa en la capacidad de parametrización integrada en el HCL.

ConAprovisionamiento de CodeBuild, AWS Proton genera un archivo de entrada que su código puede importar. El archivo es un archivo JSON o HCL, según una propiedad del manifiesto de la plantilla. Para obtener más información, consulte CodeBuild detalles y ejemplos de los parámetros de aprovisionamiento.

Puede hacer referencia a los parámetros de los archivos IaC de su entorno, servicio y componente o al código de aprovisionamiento si cumple los siguientes requisitos:

• La longitud del nombre de cada parámetro no supera los 100 caracteres.

• La longitud combinada del espacio de nombres del parámetro y del nombre del recurso no supera el límite de caracteres del nombre del recurso.

AWS Proton el aprovisionamiento falla si se superan estas cuotas.

Tipos de parámetros

Los siguientes tipos de parámetros están disponibles como referencia en los archivos AWS Proton IaC:

Parámetro de entrada

Los entornos y las instancias de servicio pueden tomar los parámetros de entrada que usted defina en un archivo de esquema que asocie a la plantilla de entorno o servicio. Puede consultar los parámetros de entrada de un recurso en el archivo IaC del recurso. Los archivos IaC de los componentes pueden hacer referencia a los parámetros de entrada de la instancia de servicio a la que está conectado el componente.

AWS Proton compara los nombres de los parámetros de entrada con el archivo de esquema y los compara con los parámetros a los que se hace referencia en los archivos IaC para introducir los valores de entrada que se proporcionan en un archivo de especificaciones durante el aprovisionamiento de recursos.

Parámetro de salida

Puede definir las salidas en cualquiera de sus archivos IaC. Una salida puede ser, por ejemplo, el nombre, el ID o el ARN de uno de los recursos que proporciona la plantilla, o puede ser una forma de pasar por una de las entradas de la plantilla. Puede hacer referencia a estas salidas en los archivos de IaC de otros recursos.

En los archivos CloudFormation IaC, defina los parámetros de salida en el Outputs: bloque. En un archivo iAC de Terraform, defina cada parámetro de salida mediante una sentencia. output

Parámetro de recurso

AWS Proton crea automáticamente los parámetros AWS Proton de los recursos. Estos parámetros exponen las propiedades del objeto AWS Proton de recurso. Un ejemplo de parámetro de recurso esenvironment.name.

Uso de AWS Proton parámetros en los archivos IaC

Para leer el valor de un parámetro en un archivo IaC, consulte el nombre del parámetro en el espacio de nombres del AWS Proton parámetro. En los archivos AWS CloudFormation IaC, se utiliza la sintaxis Jinja y se coloca el parámetro entre pares de llaves y comillas.

En la siguiente tabla se muestra la sintaxis de referencia para cada lenguaje de plantillas compatible, con un ejemplo.

Lenguaje de plantillas	Sintaxis	Ejemplo: entrada de entorno denominada «VPC»
CloudFormation	"{{ parameter-name }}"	"{{ environment.inputs.VPC }}"
Terraform	var.parameter-name	var.environment.inputs.VPC Definiciones de variables de Terraform generadas

nota

Si utiliza parámetros CloudFormation dinámicos en su archivo IaC, debe evitarlos para evitar errores de interpretación errónea de Jinja. Para obtener más información, consulte Solución de problemas de AWS Proton

En la siguiente tabla se muestran los nombres de los espacios de nombres de todos los parámetros de los recursos. AWS Proton Cada tipo de archivo de plantilla puede utilizar un subconjunto diferente del espacio de nombres de parámetros.

Archivo de plantilla	Tipo de parámetro	Nombre del parámetro	Descripción
Entorno	recurso	environment.name	Nombre del entorno
	input	environment.inputs.input-name	Entradas de entorno definidas por el esquema
Servicio	recurso	environment.name environment.account_id	Nombre e ID del entorno Cuenta de AWS
	salida	environment.outputs.output-name	Salidas del archivo IaC del entorno
	recurso	service.branch_name service.name service.repository_connection_arn service.repository_id	Nombre del servicio y repositorio de códigos
	recurso	service_instance.name	Nombre de la instancia de servicio
	input	service_instance.inputs.input-name	Entradas de instancia de servicio definidas por el esquema
	recurso	service_instance.components.default.name	Nombre del componente predeterminado adjunto
	salida	service_instance.components.default.outputs.output-name	Las salidas del archivo IaC del componente predeterminado adjunto
Canalización	recurso	service_instance.environment.name service_instance.environment.account_id	Nombre e Cuenta de AWS ID del entorno de la instancia de servicio
	salida	service_instance.environment.outputs.output-name	Salidas del archivo IaC del entorno de la instancia de servicio
	input	pipeline.inputs.input-name	Entradas de canalización definidas por el esquema
	recurso	service.branch_name service.name service.repository_connection_arn service.repository_id	Nombre del servicio y repositorio de códigos
	input	service_instance.inputs.input-name	Entradas de instancia de servicio definidas por el esquema
	collection	{% for service_instance in service_instances %}...{% endfor %}	Un conjunto de instancias de servicio que puede recorrer en bucle
Componente	recurso	environment.name environment.account_id	Nombre del entorno e ID Cuenta de AWS de cuenta
	salida	environment.outputs.output-name	Salidas del archivo IaC del entorno
	recurso	service.branch_name service.name service.repository_connection_arn service.repository_id	Nombre del servicio y repositorio de códigos (componentes adjuntos)
	recurso	service_instance.name	Nombre de la instancia de servicio (componentes adjuntos)
	input	service_instance.inputs.input-name	Entradas de instancia de servicio definidas por el esquema (componentes adjuntos)
	recurso	component.name	Nombre del componente

Para obtener más información y ejemplos, consulte los subtemas sobre los parámetros de los archivos de plantilla de IaC para los distintos tipos de recursos y lenguajes de plantillas.

Temas

• Detalles y ejemplos de los parámetros del archivo CloudFormation IaC de entorno

• Detalles y ejemplos de los parámetros del archivo CloudFormation IAC del servicio

• Detalles y ejemplos de los parámetros del archivo CloudFormation IaC del componente

• Filtros de parámetros para archivos CloudFormation IaC

• CodeBuild detalles y ejemplos de los parámetros de aprovisionamiento

• Detalles y ejemplos de los parámetros del archivo de infraestructura como código (IaC) de Terraform