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

Puede definir y hacer referencia a los parámetros de su infraestructura de servicios y canalizaciones como archivos de código (IaC). 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

Defina los parámetros de servicio

Puede definir los parámetros de entrada y salida para los archivos IaC del servicio.

• Parámetros de entrada: defina los parámetros de entrada de la instancia de servicio en el archivo de esquema.

  La siguiente lista incluye ejemplos de parámetros de entrada del servicio para casos de uso típicos.

  • Puerto

  • Tamaño de tarea

  • Imagen

  • Recuento deseado

  • Archivo de Docker

  • Comando de prueba unitaria

  Al crear un servicio, se proporcionan valores para los parámetros de entrada:

  • Utilice la consola para rellenar un formulario basado en un esquema que AWS Proton proporciona.

  • Utilice la CLI para proporcionar una especificación que incluya los valores.

• Parámetros de salida: defina las salidas de las instancias de servicio en sus archivos IaC de servicio. A continuación, puede consultar estos resultados en los archivos IaC de otros recursos.

Lea los valores de los parámetros en los archivos IaC del servicio

Puede leer los parámetros relacionados con el servicio y con otros recursos en los archivos IaC del servicio. Para leer el valor de un parámetro, haga referencia al nombre del parámetro en el espacio de nombres del AWS Proton parámetro.

• Parámetros de entrada: lee el valor de entrada de una instancia de servicio haciendo referencia a él. service_instance.inputs.input-name

• Parámetros de recursos: lea los parámetros de los AWS Proton recursos haciendo referencia a nombres como service.nameservice_instance.name, y. environment.name

• Parámetros de salida: lea las salidas de otros recursos haciendo referencia a environment.outputs.output-name o. service_instance.components.default.outputs.output-name

Ejemplo de archivo IaC de servicio con parámetros

El siguiente ejemplo es un fragmento de un archivo IaC de un servicio CloudFormation . El espacio de environment.outputs. nombres hace referencia a las salidas del archivo IaC del entorno. El espacio de service_instance.inputs. nombres hace referencia a los parámetros de entrada de la instancia de servicio. La service_instance.name propiedad hace referencia a un parámetro de AWS Proton recurso.

Resources:
  StoreServiceInstanceInputValue:
    Type: AWS::SSM::Parameter
    Properties:
      Type: String
      Value: "{{ service.name }} {{ service_instance.name }} {{ service_instance.inputs.my_sample_service_instance_required_input }} {{ service_instance.inputs.my_sample_service_instance_optional_input }} {{ environment.outputs.MySampleInputValue }} {{ environment.outputs.MyOtherSampleInputValue }}"
              #  resource parameter references               # input parameter references                                                                                                                    # output references to an environment infrastructure as code file
Outputs:
  MyServiceInstanceParameter:                                                         # output definition
    Value: !Ref StoreServiceInstanceInputValue 
  MyServiceInstanceRequiredInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_required_input }}"  # input parameter reference
  MyServiceInstanceOptionalInputValue:                                                # output definition
    Value: "{{ service_instance.inputs.my_sample_service_instance_optional_input }}"  # input parameter reference
  MyServiceInstancesEnvironmentSampleOutputValue:                                     # output definition
    Value: "{{ environment.outputs.MySampleInputValue }}"                             # output reference to an environment IaC file
  MyServiceInstancesEnvironmentOtherSampleOutputValue:                                # output definition
    Value: "{{ environment.outputs.MyOtherSampleInputValue }}"                        # output reference to an environment IaC file