View a markdown version of this page

Infrastruttura dei componenti come file di codice - AWS Proton
Utilizzo dei parametri con i componentiCreazione di file IaC robusti

Avviso di fine del supporto: il 7 ottobre 2026, AWS terminerà il supporto per AWS Proton. Dopo il 7 ottobre 2026, non potrai più accedere alla AWS Proton console o AWS Proton alle risorse. L'infrastruttura implementata rimarrà intatta. Per ulteriori informazioni, consulta la AWS Proton Service Deprecation and Migration Guide.

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à.

Infrastruttura dei componenti come file di codice

I file Component Infrastructure as code (IaC) sono simili a quelli per altre AWS Proton risorse. Scopri qui alcuni dettagli specifici dei componenti. Per informazioni complete sulla creazione di file IaC per AWS Proton, consulta. Creazione di modelli e creazione di pacchetti per AWS Proton

Utilizzo dei parametri con i componenti

Lo spazio AWS Proton dei nomi dei parametri include alcuni parametri a cui un file IAc di servizio può fare riferimento per ottenere il nome e gli output di un componente associato. Lo spazio dei nomi include anche parametri a cui un file IAc di un componente può fare riferimento per ottenere input, output e valori delle risorse dall'ambiente, dal servizio e dall'istanza del servizio a cui il componente è associato.

Un componente non dispone di input propri: riceve i propri input dall'istanza del servizio a cui è collegato. Un componente può anche leggere gli output dell'ambiente.

Per ulteriori informazioni sull'utilizzo dei parametri nei componenti e nei file IaC di servizio associati, vedere. Dettagli ed esempi dei parametri del file CloudFormation IAc del componente Per informazioni generali sui AWS Proton parametri e un riferimento completo allo spazio dei nomi dei parametri, vedere. AWS Proton parametri

Creazione di file IaC robusti

In qualità di amministratore, quando crei una versione del modello di servizio, puoi decidere se consentire alle istanze di servizio create dalla versione del modello di avere componenti collegati. Vedi il ComponentSources parametro supportato dell'azione CreateServiceTemplateVersion API nel Riferimento AWS Proton API. Tuttavia, per qualsiasi istanza di servizio futura, la persona che crea l'istanza decide se allegarvi o meno un componente e (nel caso di componenti definiti direttamente) l'autore del componente IaC è in genere una persona diversa: uno sviluppatore che utilizza il modello di servizio. Pertanto, non è possibile garantire che un componente venga collegato a un'istanza del servizio. Inoltre, non è possibile garantire l'esistenza di nomi di output specifici dei componenti o la validità e la sicurezza dei valori di tali output.

AWS Proton e la sintassi Jinja ti aiuta a risolvere questi problemi e a creare modelli di servizio robusti che renderizzano senza errori nei seguenti modi:

  • AWS Proton filtri dei parametri: quando si fa riferimento alle proprietà di output dei componenti, è possibile utilizzare i filtri dei parametri, ossia modificatori che convalidano, filtrano e formattano i valori dei parametri. Per maggiori informazioni ed esempi, consulta filtri parametrici per CloudFormation file IAc.

  • Proprietà singola predefinita: quando si fa riferimento a una singola risorsa o proprietà di output di un componente, è possibile garantire che il rendering del modello di servizio non abbia esito negativo utilizzando il default filtro, con o senza un valore predefinito. Se il componente, o uno specifico parametro di output a cui ti riferisci, non esiste, viene invece renderizzato il valore predefinito (o una stringa vuota, se non hai specificato un valore predefinito) e il rendering ha esito positivo. Per ulteriori informazioni, consulta Fornite valori predefiniti per riferimenti inesistenti.

    Esempi:

    • {{ service_instance.components.default.name | default("") }}

    • {{ service_instance.components.default.outputs.my-output | default("17") }}

    Nota

    Non confondete la .default parte del namespace, che designa i componenti definiti direttamente, con il default filtro, che fornisce un valore predefinito quando la proprietà di riferimento non esiste.

  • Riferimento all'intero oggetto: quando si fa riferimento all'intero componente o alla raccolta degli output di un componente, AWS Proton restituisce un oggetto vuoto e garantisce quindi che il rendering del {} modello di servizio non abbia esito negativo. Non è necessario utilizzare alcun filtro. Assicuratevi di creare il riferimento in un contesto che possa accettare un oggetto vuoto o di utilizzare una {{ if .. }} condizione per verificare la presenza di un oggetto vuoto.

    Esempi:

    • {{ service_instance.components.default }}

    • {{ service_instance.components.default.outputs }}