Detalhes e exemplos de parâmetros do arquivo Service CloudFormation IaC

Você pode definir e referenciar parâmetros em seus arquivos de serviço e pipeline de infraestrutura como código (IaC). Para obter uma descrição detalhada dos parâmetros do AWS Proton , 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.

Definir parâmetros de serviço

Você pode definir os parâmetros de entrada e saída para arquivos IaC do serviço.

• Parâmetros de entrada — Defina os parâmetros de instância de serviço do ambiente em seu arquivo de esquema.

  A lista a seguir inclui exemplos de parâmetros de entrada de serviço para casos de uso típicos.

  • Porta

  • Tamanho da tarefa

  • Imagem

  • Contagem desejada

  • Arquivo Docker

  • Comando de teste unitário

  Você fornece valores para os parâmetros de entrada ao criar um serviço:

  • Use o console para preencher um formulário baseado em esquema que AWS Proton fornece.

  • Use a CLI para fornecer uma especificação que inclua os valores.

• Parâmetros de saída — Defina as saídas da instância de serviço em seus arquivos IaC de serviço. Você pode então consultar essas saídas em arquivos IaC de outros recursos.

Leia valores de parâmetros em arquivos IaC de serviço

Você pode ler os parâmetros relacionados ao serviço e a outros recursos nos arquivos do serviço IaC. Você lê o valor de um parâmetro fazendo referência ao nome do parâmetro no namespace do AWS Proton parâmetro.

• Parâmetros de entrada — Leia um valor de instância do serviço fazendo referência a service_instance.inputs.input-name.

• Parâmetros do AWS Proton recurso — Leia os parâmetros do recurso fazendo referência a nomes como service.nameservice_instance.name, e. environment.name

• Parâmetros de saída — Leia as saídas de outros recursos referenciando environment.outputs.output-name ou service_instance.components.default.outputs.output-name.

Exemplo de arquivo IaC de serviço com parâmetros

O exemplo a seguir é um trecho de um arquivo CloudFormation IaC de serviço. O namespace environment.outputs. se refere às saídas do ambiente de um arquivo IaC do ambiente. O namespace service_instance.inputs. se refere aos parâmetros de entrada da instância de serviço. A service_instance.name propriedade se refere a um parâmetro AWS Proton de 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