AWS Proton parametri - AWS Proton
Tipi di parametroUtilizzo dei parametri

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS Proton parametri

È possibile definire e utilizzare i parametri nella propria infrastruttura come file di codice (IaC) per renderli flessibili e riutilizzabili. Leggete il valore di un parametro nei vostri file IAc facendo riferimento al nome del parametro nello spazio dei nomi dei AWS Proton parametri. AWS Proton inserisce i valori dei parametri nei file IAc renderizzati che genera durante l'approvvigionamento delle risorse. Per elaborare i parametri AWS CloudFormation IAc, utilizza Jinja. AWS Proton Per elaborare i parametri Terraform IAc, AWS Proton genera un file di valori dei parametri Terraform e si basa sulla capacità di parametrizzazione integrata in HCL.

ConCodeBuildapprovvigionamento, AWS Proton genera un file di input che il codice può importare. Il file è un file JSON o HCL, a seconda di una proprietà nel manifesto del modello. Per ulteriori informazioni, consulta CodeBuild dettagli ed esempi dei parametri di provisioning.

È possibile fare riferimento ai parametri nei file IAc di ambiente, servizio e componente o al codice di provisioning con i seguenti requisiti:

  • La lunghezza di ogni nome di parametro non supera i 100 caratteri.

  • La lunghezza dello spazio dei nomi dei parametri e del nome della risorsa combinati non supera il limite di caratteri per il nome della risorsa.

AWS Proton il provisioning fallisce se queste quote vengono superate.

Tipi di parametro

I seguenti tipi di parametri sono disponibili come riferimento nei AWS Proton file IAc:

Parametro di input

Gli ambienti e le istanze di servizio possono accettare parametri di input definiti in un file di schema associato all'ambiente o al modello di servizio. È possibile fare riferimento ai parametri di input di una risorsa nel file IAc della risorsa. I file IAc dei componenti possono fare riferimento ai parametri di input dell'istanza del servizio a cui è collegato il componente.

AWS Proton confronta i nomi dei parametri di input con il file di schema e li confronta con i parametri a cui si fa riferimento nei file IAc per inserire i valori di input forniti in un file di specifiche durante l'approvvigionamento delle risorse.

Parametro di output

È possibile definire gli output in qualsiasi file IAc. Un output può essere, ad esempio, un nome, un ID o un ARN di una delle risorse fornite dal modello oppure può essere un modo per passare attraverso uno degli input del modello. È possibile fare riferimento a questi output nei file IAc di altre risorse.

Nei file CloudFormation IAc, definite i parametri di output nel blocco. Outputs: In un file Terraform IAc, definisci ogni parametro di output utilizzando un'istruzione. output

Parametro di risorsa

AWS Proton crea automaticamente i parametri AWS Proton delle risorse. Questi parametri espongono le proprietà dell'oggetto AWS Proton risorsa. Un esempio di parametro di risorsa èenvironment.name.

Utilizzo AWS Proton dei parametri nei file IAc

Per leggere il valore di un parametro in un file IAc, fate riferimento al nome del parametro nello spazio AWS Proton dei nomi dei parametri. Per i file AWS CloudFormation IAc, utilizzate la sintassi Jinja e racchiudete il parametro con coppie di parentesi graffe e virgolette.

La tabella seguente mostra la sintassi di riferimento per ogni linguaggio di template supportato, con un esempio.

Linguaggio dei modelli Sintassi Esempio: input di ambiente denominato «VPC»

CloudFormation

"{{ parameter-name }}"

"{{ environment.inputs.VPC }}"

Terraform

var.parameter-name

var.environment.inputs.VPC

Definizioni delle variabili Terraform generate
Nota

Se utilizzi parametri CloudFormation dinamici nel tuo file IAc, devi evitarli per evitare errori di interpretazione errata di Jinja. Per ulteriori informazioni, consultare Risoluzione dei problemi AWS Proton

La tabella seguente elenca i nomi dei namespace per tutti i parametri delle risorse. AWS Proton Ogni tipo di file modello può utilizzare un sottoinsieme diverso dello spazio dei nomi dei parametri.

File modello Tipo parametro Nome del parametro Descrizione

Ambiente

risorsa

environment.name

Nome ambiente

input

environment.inputs.input-name

Input di ambiente definiti dallo schema

Servizio

risorsa

environment.name

environment.account_id

Nome e ID dell'ambiente Account AWS

output

environment.outputs.output-name

Output di file IAc di ambiente

risorsa

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nome del servizio e archivio del codice

risorsa

service_instance.name

Nome dell'istanza del servizio

input

service_instance.inputs.input-name

Input dell'istanza di servizio definiti dallo schema

risorsa

service_instance.components.default.name

Nome del componente predefinito allegato

output

service_instance.components.default.outputs.output-name

Uscite di file IAc del componente predefinito allegate

Pipeline

risorsa

service_instance.environment.name

service_instance.environment.account_id

Nome e ID dell'ambiente dell'istanza di servizio Account AWS

output

service_instance.environment.outputs.output-name

Output dei file IAc dell'ambiente di istanza di servizio

input

pipeline.inputs.input-name

Ingressi della pipeline definiti dallo schema

risorsa

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nome del servizio e archivio del codice

input

service_instance.inputs.input-name

Input delle istanze di servizio definiti dallo schema

collezione

{% for service_instance in service_instances %}...{% endfor %}

Una raccolta di istanze di servizio che è possibile consultare in loop

Componente

risorsa

environment.name

environment.account_id

Nome dell'ambiente e ID Account AWS dell'account

output

environment.outputs.output-name

Output di file IAc di ambiente

risorsa

service.branch_name

service.name

service.repository_connection_arn

service.repository_id

Nome del servizio e archivio del codice (componenti allegati)

risorsa

service_instance.name

Nome dell'istanza del servizio (componenti allegati)

input

service_instance.inputs.input-name

Input dell'istanza di servizio definiti dallo schema (componenti collegati)

risorsa

component.name

Nome componente

Per ulteriori informazioni ed esempi, vedere i sottoargomenti relativi ai parametri nei file modello IAc per diversi tipi di risorse e linguaggi di modello.

Argomenti