As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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.ououtput-nameservice_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