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à. # Riferimento alla struttura delle regole Questa sezione è un riferimento solo per la configurazione delle regole. Per una panoramica dei concetti di base della struttura della pipeline, consulta [CodePipeline riferimento alla struttura della tubazione](reference-pipeline-structure.md). Ogni provider di regole CodePipeline utilizza un set di campi di configurazione obbligatori e facoltativi nella struttura della pipeline. Questa sezione fornisce le seguenti informazioni di riferimento per fornitore di regole: + Valori validi per i `RuleType` campi inclusi nel blocco di regole della struttura della pipeline, ad esempio `Owner` e`Provider`. + Descrizioni e altre informazioni di riferimento per i `Configuration` parametri (obbligatori e facoltativi) inclusi nella sezione delle regole della struttura della tubazione. + Campi di configurazione delle regole JSON e YAML di esempio validi. Le informazioni di riferimento sono disponibili per i seguenti provider di regole: **Topics** + [CloudWatchAlarm](rule-reference-CloudWatchAlarm.md) + [CodeBuild regola](rule-reference-CodeBuild.md) + [Comandi](rule-reference-Commands.md) + [DeploymentWindow](rule-reference-DeploymentWindow.md) + [LambdaInvoke](rule-reference-LambdaInvoke.md) + [VariableCheck](rule-reference-VariableCheck.md) # CloudWatchAlarm Quando si crea una condizione, è possibile aggiungere la `CloudWatchAlarm` regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). Devi aver già creato un allarme in Amazon CloudWatch come risorsa separata. **Topics** + [Tipo di regola](#rule-reference-CloudWatchAlarm-type) + [Parametri di configurazione](#rule-reference-CloudWatchAlarm-config) + [Esempio di configurazione delle regole](#rule-reference-CloudWatchAlarm-example) + [Consulta anche](#rule-reference-CloudWatchAlarm-links) ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `CloudWatchAlarm` + Versione: `1` ## Parametri di configurazione **AlarmName** Obbligatorio: sì Il nome dell' CloudWatch allarme. Questa è una risorsa separata creata in CloudWatch. **AlarmStates** Obbligatorio: no Gli stati di CloudWatch allarme desiderati per la regola da monitorare. I valori validi sono ALARM, OK e INSUFFICIENT\$1DATA. **WaitTime** Obbligatorio: no Il tempo di attesa in minuti per consentire una modifica dello stato prima di eseguire il risultato della regola. Ad esempio, configura 20 minuti per attendere che lo stato di allarme passi a OK prima di applicare il risultato della regola. ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` rules: - name: MyMonitorRule ruleTypeId: category: Rule owner: AWS provider: CloudWatchAlarm version: '1' configuration: AlarmName: CWAlarm WaitTime: '1' inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyMonitorRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CloudWatchAlarm", "version": "1" }, "configuration": { "AlarmName": "CWAlarm", "WaitTime": "1" }, "inputArtifacts": [], "region": "us-east-1" } ] } ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + [Creazione delle condizioni On Failure](stage-conditions.md#stage-conditions-onfailure)— Questa sezione fornisce i passaggi per creare una condizione On Failure con una regola di allarme. # CodeBuild regola Quando si crea una condizione, è possibile aggiungere la CodeBuild regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). È possibile utilizzare la CodeBuild regola per creare una condizione in cui l'esecuzione corretta del progetto di compilazione soddisfi i criteri della regola, ad esempio l'esecuzione della compilazione per una condizione BeforeEntry. **Nota** Per le condizioni BeforeEntry configurate con il risultato **Skip**, sono disponibili solo le seguenti regole: e. `LambdaInvoke` `VariableCheck` **Topics** + [Autorizzazioni relative ai ruoli di servizio](#rule-reference-Commands-policy) + [Tipo di regola](#rule-reference-Commands-type) + [Parametri di configurazione](#rule-reference-Commands-config) + [Esempio di configurazione delle regole](#rule-reference-Commands-example) + [Consulta anche](#rule-reference-Commands-links) ## Autorizzazioni relative ai ruoli di servizio Per le autorizzazioni relative a questa regola, aggiungi quanto segue alla dichiarazione sulla politica relativa al ruolo CodePipeline di servizio. Riduci le autorizzazioni a livello di risorsa. ``` { "Effect": "Allow", "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild" ], "Resource": "resource_ARN" }, ``` ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `CodeBuild` + Versione: `1` ## Parametri di configurazione **ProjectName** Campo obbligatorio: sì `ProjectName`è il nome del progetto di compilazione in CodeBuild. **PrimarySource** Obbligatorio: condizionale Il valore del `PrimarySource` parametro deve essere il nome di uno degli elementi di input dell'azione. CodeBuild cerca il file buildspec ed esegue i comandi buildspec nella directory che contiene la versione decompressa di questo elemento. Questo parametro è obbligatorio se vengono specificati più artefatti di input per un'operazione CodeBuild . Quando è presente un solo artefatto di origine per l'operazione, l'impostazione predefinita per l'artefatto `PrimarySource` è tale artefatto. **BatchEnabled** Campo obbligatorio: no Il valore booleano del `BatchEnabled` parametro consente all'azione di eseguire più build nella stessa esecuzione di build. Quando questa opzione è abilitata, l'`CombineArtifacts`opzione è disponibile. Per esempi di pipeline con compilazioni in batch abilitate, consulta [CodePipeline Integrazione con CodeBuild e compilazioni in batch](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-batch.html). **CombineArtifacts** Campo obbligatorio: no Il valore booleano del `CombineArtifacts` parametro combina tutti gli artefatti di compilazione di una compilazione in batch in un unico file di artefatti per l'azione di compilazione. Per utilizzare questa opzione, il parametro deve essere abilitato. `BatchEnabled` **EnvironmentVariables** Campo obbligatorio: no Il valore di questo parametro viene utilizzato per impostare le variabili di ambiente per l'operazione CodeBuild nella pipeline. Il valore per il parametro `EnvironmentVariables` assume la forma di un array JSON di oggetti variabili di ambiente. Vedi il parametro di esempio in [Dichiarazione di azione (CodeBuild esempio)](action-reference-CodeBuild.md#action-reference-CodeBuild-example). Ogni oggetto ha tre parti, tutte costituite da stringhe: + `name`: il nome o la chiave della variabile di ambiente. + `value`: il valore della variabile di ambiente. Quando si utilizza il `SECRETS_MANAGER` tipo `PARAMETER_STORE` o, questo valore deve essere il nome di un parametro già archiviato in AWS Systems Manager Parameter Store o un segreto già archiviato in AWS Secrets Manager, rispettivamente. **Nota** Sconsigliamo vivamente l'uso di variabili di ambiente per archiviare valori sensibili, in particolare AWS le credenziali. Quando si utilizza la CodeBuild console o la AWS CLI, le variabili di ambiente vengono visualizzate in testo semplice. Per i valori sensibili, si consiglia di utilizzare invece il tipo `SECRETS_MANAGER`. + `type`: (facoltativo) il tipo di variabile di ambiente. I valori validi sono `PARAMETER_STORE`, `SECRETS_MANAGER` o `PLAINTEXT`. Se il valore non viene specificato, viene usato il valore predefinito `PLAINTEXT`. Quando inserite la `name` configurazione e `type` per le variabili di ambiente, specialmente se la variabile di ambiente contiene la sintassi della variabile di CodePipeline output, non superate il limite di 1000 caratteri per il campo del valore della configurazione. `value` Quando questo limite viene superato, viene restituito un errore di convalida. Per ulteriori informazioni, consulta l'API [ EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html)Reference. AWS CodeBuild Per un esempio di CodeBuild azione con una variabile di ambiente che si risolve nel nome del GitHub ramo, vedi. [Esempio: utilizzare una BranchName variabile con variabili di CodeBuild ambiente](actions-variables.md#actions-variables-examples-env-branchname) ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` name: codebuild-rule ruleTypeId: category: Rule owner: AWS provider: CodeBuild version: '1' configuration: ProjectName: my-buildproject EnvironmentVariables: '[{"name":"VAR1","value":"variable","type":"PLAINTEXT"}]' inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "name": "codebuild-rule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CodeBuild", "version": "1" }, "configuration": { "ProjectName": "my-buildproject" }, "inputArtifacts": [ { "name": "SourceArtifact", "EnvironmentVariables": "[{\"name\":\"VAR1\",\"value\":\"variable\",\"type\":\"PLAINTEXT\"}]" } ], "region": "us-east-1" } ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + Per ulteriori informazioni su regole e condizioni, consulta [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) e [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)nella *Guida CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html) # Comandi Quando si crea una condizione, è possibile aggiungere la `Commands` regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). È possibile utilizzare la `Commands` regola per creare una condizione in cui i comandi eseguiti correttamente soddisfino i criteri della regola, ad esempio l'output e il percorso del file per i comandi che hanno esito positivo per una condizione BeforeEntry. **Nota** Per le condizioni BeforeEntry configurate con il risultato **Skip**, sono disponibili solo le seguenti regole: e. `LambdaInvoke` `VariableCheck` **Topics** + [Considerazioni sulla regola Commands](#rule-reference-Commands-considerations) + [Autorizzazioni relative ai ruoli di servizio](#rule-reference-Commands-policy) + [Tipo di regola](#rule-reference-Commands-type) + [Parametri di configurazione](#rule-reference-Commands-config) + [Esempio di configurazione delle regole](#rule-reference-Commands-example) + [Consulta anche](#rule-reference-Commands-links) ## Considerazioni sulla regola Commands Le considerazioni seguenti si applicano alla regola Commands. + La regola dei comandi utilizza CodeBuild risorse simili all' CodeBuild azione, ma consente i comandi in ambiente shell in un'istanza di calcolo virtuale senza la necessità di associare o creare un progetto di compilazione. **Nota** L'esecuzione della regola dei comandi comporterà costi separati in. AWS CodeBuild + Poiché la regola Commands in CodePipeline utilizza CodeBuild risorse, le build eseguite dall'azione verranno attribuite ai limiti di build per il tuo account in. CodeBuild Le build eseguite dalla regola Commands verranno conteggiate ai fini dei limiti di compilazione simultanea configurati per quell'account. + Il timeout per le build con la regola Commands è di 55 minuti, in base alle build. CodeBuild + L'istanza di calcolo utilizza un ambiente di compilazione isolato in. CodeBuild **Nota** Poiché l'ambiente di compilazione isolato viene utilizzato a livello di account, un'istanza potrebbe essere riutilizzata per un'altra esecuzione della pipeline. + Sono supportati tutti i formati tranne i formati multilinea. È necessario utilizzare il formato a riga singola quando si immettono i comandi. + In base a questa regola, CodePipeline assumerà il ruolo di servizio di pipeline e utilizzerà tale ruolo per consentire l'accesso alle risorse in fase di esecuzione. Si consiglia di configurare il ruolo di servizio in modo che le autorizzazioni siano limitate al livello di azione. + Le autorizzazioni aggiunte al ruolo di CodePipeline servizio sono dettagliate in. [Aggiungi le autorizzazioni al ruolo di servizio CodePipeline](how-to-custom-role.md#how-to-update-role-new-services) + Le autorizzazioni necessarie per visualizzare i log nella console sono dettagliate in. [Autorizzazioni necessarie per visualizzare i log di calcolo nella console](security-iam-permissions-console-logs.md) Nelle schermate di esempio seguenti, utilizzate il collegamento **Logs** per visualizzare i log relativi a una regola Commands corretta nei log. CloudWatch ![\[La pagina di stato di una pipeline con la regola Commands\]](http://docs.aws.amazon.com/it_it/codepipeline/latest/userguide/images/commands-rule-status.png) ![\[La pagina di log di una pipeline con CloudWatch la regola Commands\]](http://docs.aws.amazon.com/it_it/codepipeline/latest/userguide/images/commands-rule-logs.png) + A differenza di altre azioni in CodePipeline, non si impostano campi nella configurazione dell'azione; si impostano i campi di configurazione dell'azione al di fuori della configurazione dell'azione. ## Autorizzazioni relative ai ruoli di servizio Quando CodePipeline esegue la regola, CodePipeline crea un gruppo di log utilizzando il nome della pipeline come segue. Ciò consente di ridurre l'ambito delle autorizzazioni per registrare le risorse utilizzando il nome della pipeline. ``` /aws/codepipeline/MyPipelineName ``` Se si utilizza un ruolo di servizio esistente, per utilizzare l'azione Comandi, è necessario aggiungere le seguenti autorizzazioni per il ruolo di servizio. + registri: CreateLogGroup + registri: CreateLogStream + registri: PutLogEvents Nella dichiarazione sulla politica relativa al ruolo del servizio, riduci le autorizzazioni a livello di pipeline, come mostrato nell'esempio seguente. ``` { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:YOUR_AWS_ACCOUNT_ID:log-group:/aws/codepipeline/YOUR_PIPELINE_NAME:*" } ``` Per visualizzare i log nella console utilizzando la pagina di dialogo dei dettagli delle azioni, è necessario aggiungere l'autorizzazione alla visualizzazione dei log al ruolo della console. Per ulteriori informazioni, consulta l'esempio di policy sulle autorizzazioni della console in. [Autorizzazioni necessarie per visualizzare i log di calcolo nella console](security-iam-permissions-console-logs.md) ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `Commands` + Versione: `1` ## Parametri di configurazione **Comandi** Obbligatorio: sì È possibile fornire comandi di shell per l'esecuzione della `Commands` regola. Nella console, i comandi vengono immessi su righe separate. Nella CLI, i comandi vengono immessi come stringhe separate. I formati multilinea non sono supportati e genereranno un messaggio di errore. È necessario utilizzare il formato a riga singola per immettere i comandi nel campo **Comandi**. I seguenti dettagli forniscono il calcolo predefinito utilizzato per la regola Commands. Per ulteriori informazioni, consulta il riferimento ai [metodi e ai tipi di calcolo dell'ambiente di compilazione](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) nella Guida per l' CodeBuild utente. + **CodeBuild immagine: 2-x86\$164-standard:5.0** aws/codebuild/amazonlinux + **Tipo di calcolo: Linux Small** + Valore **ComputeType dell'ambiente: BUILD\$1 \$1SMALL** GENERAL1 + **Valore del tipo di ambiente: LINUX\$1CONTAINER** ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` result: FAIL rules: - name: CommandsRule ruleTypeId: category: Rule owner: AWS provider: Commands version: '1' configuration: {} commands: - ls - printenv inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "result": "FAIL", "rules": [ { "name": "CommandsRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "Commands", "version": "1" }, "configuration": {}, "commands": [ "ls", "printenv" ], "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] } ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + Per ulteriori informazioni su regole e condizioni, consulta [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) e [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)nella *Guida CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html) # DeploymentWindow Quando si crea una condizione, è possibile aggiungere la `DeploymentWindow` regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). **Topics** + [Tipo di regola](#rule-reference-DeploymentWindow-type) + [Parametri di configurazione](#rule-reference-DeploymentWindow-config) + [Esempio di configurazione delle regole](#rule-reference-DeploymentWindow-example) + [Consulta anche](#rule-reference-DeploymentWindow-links) ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `DeploymentWindow` + Versione: `1` ## Parametri di configurazione **Cron** Obbligatorio: sì L'espressione che definisce i giorni e gli orari in cui la distribuzione sarà consentita. Le espressioni Cron sono composte da 6 campi obbligatori e un campo opzionale separati da uno spazio bianco. I campi di espressione cron consentono di specificare uno schema di pianificazione con un'espressione cron come segue. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html) + Il carattere '\$1' viene utilizzato per specificare tutti i valori. Ad esempio, «\$1» nel campo dei minuti significa «ogni minuto». + Il '?' il carattere è consentito per i day-of-week campi day-of-month and. Viene utilizzato per specificare «nessun valore specifico». Ciò è utile quando è necessario specificare qualcosa in uno dei due campi, ma non nell'altro. + Il carattere '-' viene utilizzato per specificare gli intervalli. Ad esempio, «10-12" nel campo delle ore significa «le ore 10, 11 e 12". + Il carattere ',' viene utilizzato per specificare valori aggiuntivi. Ad esempio, «MON, WED, FRI» nel day-of-week campo significa «i giorni lunedì, mercoledì e venerdì». + Il carattere '/' viene utilizzato per specificare gli incrementi. Ad esempio, «0/15" nel campo dei secondi significa «i secondi 0, 15, 30 e 45". E «5/15" nel campo dei secondi significa «i secondi 5, 20, 35 e 50". Specificare '\$1' prima di '/' equivale a specificare che 0 è il valore con cui iniziare. + Il carattere 'L' è consentito per i campi day-of-month e day-of-week. Questo carattere è l'abbreviazione di «ultimo», ma ha un significato diverso in ciascuno dei due campi. Ad esempio, il valore «L» nel day-of-month campo indica «l'ultimo giorno del mese»: giorno 31 per gennaio, giorno 28 per febbraio negli anni non bisestili. Se utilizzato da solo sul day-of-week campo, significa semplicemente «7" o «SAT». Ma se usato nel day-of-week campo dopo un altro valore, significa «l'ultimo giorno del mese», ad esempio «6L» significa «l'ultimo venerdì del mese». Puoi anche specificare un offset rispetto all'ultimo giorno del mese, ad esempio «L-3" che significherebbe il third-to-last giorno del mese di calendario. + Il carattere 'W' è consentito per il campo. day-of-month Questo carattere viene utilizzato per specificare il giorno della settimana (lunedì-venerdì) più vicino al giorno specificato. Ad esempio, se si specifica «15W» come valore per il day-of-month campo, il significato è: «il giorno feriale più vicino al 15 del mese». Quindi, se il 15 è un sabato, il grilletto si attiverà venerdì 14. Se il 15 è domenica, il grilletto si attiverà lunedì 16. Se il 15 è un martedì, si attiverà martedì 15. + I caratteri «L» e «W» possono anche essere combinati per ottenere l' day-of-monthespressione «LW», che si traduce in «ultimo giorno della settimana del mese». + Il carattere '\$1' è consentito per il campo. day-of-week Questo carattere viene utilizzato per specificare «l'ennesimo» giorno del mese. Ad esempio, il valore di «6 \$13" nel day-of-week campo indica il terzo venerdì del mese (giorno 6 = venerdì e "\$13" = terzo del mese). + I caratteri legali e i nomi dei mesi e dei giorni della settimana non fanno distinzione tra maiuscole e minuscole. **TimeZone** Obbligatorio: no Il fuso orario per la finestra di distribuzione. L'espressione regolare corrisponde ai modelli nei seguenti formati: + **Formato regione/città**. Il valore corrisponde a un fuso orario nel formato Region/City Region/City\$1City. Ad esempio `America/New_York` o `Europe/Berlin`. + **Formato UTC.** Il valore corrisponde alla stringa UTC seguita facoltativamente da un offset nel formato \$1HH:MM o -HH:MM. Ad esempio,, o. `UTC` `UTC+05:30` `UTC-03:00` Questo è il formato predefinito se il parametro non è impostato diversamente. + **Formato di abbreviazione**. Il valore corrisponde a un'abbreviazione da 3 a 5 caratteri per un fuso orario. Ad esempio `EST` o `IST`. Per una tabella di valori TimeZone ID validi, vedere [https://docs.oracle.com/middleware/wcs/tag-ref/MISC/TimeZones1221/](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html) .html. Tieni presente che alcune abbreviazioni sono abbreviazioni duplicate, come CST per Central Standard Time, China Standard Time e Cuba Standard Time. ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` - name: MyDeploymentRule ruleTypeId: category: Rule owner: AWS provider: DeploymentWindow version: '1' configuration: Cron: 0 0 9-17 ? * MON-FRI * TimeZone: PST inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyDeploymentRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "DeploymentWindow", "version": "1" }, "configuration": { "Cron": "0 0 9-17 ? * MON-FRI *", "TimeZone": "PST" }, "inputArtifacts": [], "region": "us-east-1" } ] ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + [Condizioni di creazione in caso di successo](stage-conditions.md#stage-conditions-onsuccess)— Questa sezione fornisce i passaggi per creare una condizione On Success con una regola relativa alla finestra di distribuzione. + Per ulteriori informazioni su regole e condizioni, consulta [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) e [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)nella *Guida CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html) # LambdaInvoke Quando si crea una condizione, è possibile aggiungere la `LambdaInvoke` regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). Devi aver già creato una funzione in Lambda come risorsa separata. **Topics** + [Tipo di regola](#rule-reference-CloudWatchAlarm-type) + [Parametri di configurazione](#rule-reference-LambdaInvoke-config) + [Esempio di configurazione delle regole](#rule-reference-LambdaInvoke-example) + [Consulta anche](#rule-reference-LambdaInvoke-links) ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `LambdaInvoke` + Versione: `1` ## Parametri di configurazione **FunctionName** Campo obbligatorio: sì Il nome della funzione Lambda. **UserParameters** Campo obbligatorio: no Si tratta di parametri forniti come input per la funzione nel formato di coppia chiave-valore. ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` - name: MyLambdaRule ruleTypeId: category: Rule owner: AWS provider: LambdaInvoke version: '1' configuration: FunctionName: my-function inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyLambdaRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "LambdaInvoke", "version": "1" }, "configuration": { "FunctionName": "my-function" }, "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + [Creazione delle condizioni On Failure](stage-conditions.md#stage-conditions-onfailure)— Questa sezione fornisce i passaggi per creare una condizione On Failure con una regola di allarme. # VariableCheck Quando si crea una condizione, è possibile aggiungere la `VariableCheck` regola. Questa sezione fornisce un riferimento per i parametri della regola. Per ulteriori informazioni su regole e condizioni, vedere[Come funzionano le condizioni dello stage?](concepts-how-it-works-conditions.md). È possibile utilizzare la `VariableCheck` regola per creare una condizione in cui la variabile di output viene confrontata con un'espressione fornita. La regola supera il controllo quando il valore della variabile soddisfa i criteri della regola, ad esempio se il valore è uguale o maggiore di una variabile di output specificata. **Topics** + [Tipo di regola](#rule-reference-VariableCheck-type) + [Parametri di configurazione](#rule-reference-VariableCheck-config) + [Esempio di configurazione delle regole](#rule-reference-VariableCheck-example) + [Consulta anche](#rule-reference-VariableCheck-links) ## Tipo di regola + Categoria: `Rule` + Proprietario: `AWS` + Provider: `VariableCheck` + Versione: `1` ## Parametri di configurazione **Operatore** Obbligatorio: sì L'operatore che indica l'operazione da eseguire per il controllo della variabile. Nell'esempio seguente, verrà verificato se la variabile di output per il nome del repository è uguale a`MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` I seguenti operatori sono disponibili per creare un'espressione come segue. + **Uguale**: scegliete questo operatore per verificare se la variabile è uguale al valore della stringa. **Parametro CLI:** `EQ` + **Contiene**: scegliete questo operatore per verificare se la variabile contiene il valore della stringa come sottostringa. **Parametro CLI:** `CONTAINS` + **Corrispondenze**: scegli questo operatore per verificare se la variabile corrisponde a una determinata espressione regolare come valore di stringa. Tutte le espressioni regolari sono CodePipeline conformi alla sintassi regex di Java. Per una descrizione completa della sintassi regex di Java e dei suoi costrutti, consulta [java.util.regex.Pattern.](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html) **Parametro CLI:** `MATCHES` + **Non uguale**: scegli questo operatore per verificare se la variabile non è uguale al valore della stringa. **Parametro CLI:** `NE` **Variabile** Obbligatorio: sì Le variabili della pipeline da controllare. **Valore** Obbligatorio: sì Il valore dell'espressione da confrontare. Nell'esempio seguente, verrà verificato se la variabile di output per il nome del repository è uguale a`MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Nel seguente esempio JSON, vengono definite due regole separate, una per un'istruzione `EQ` (equals) che controlla il nome del repository e del ramo formattati come \$1 \$1. SourceVariables RepositoryName\$1 e una per `CONTAINS` questa verifica la variabile di output del messaggio di commit formattata come \$1 \$1. SourceVariables CommitMessage\$1 rispetto al valore fornito «update». ``` "beforeEntry": { "conditions": [ { "result": "FAIL", "rules": [ { "name": "MyVarCheckRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "EQ", "Value": "MyDemoRepo", "Variable": "#{SourceVariables.RepositoryName}" }, "inputArtifacts": [], "region": "us-east-1" }, { "name": "MyVarCheckRuleContains", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "CONTAINS", "Value": "update", "Variable": "#{SourceVariables.CommitMessage}" }, "inputArtifacts": [], "region": "us-east-1" } ] } ] } } ], ``` ## Esempio di configurazione delle regole ------ #### [ YAML ] ``` - name: MyVariableCheck ruleTypeId: category: Rule owner: AWS provider: VariableCheck version: '1' configuration: Variable: "#{SourceVariables.RepositoryName}" Value: MyDemoRepo Operator: EQ inputArtifacts: [] region: us-west-2 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyVariableCheck", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, "inputArtifacts": [], "region": "us-west-2" } ] ``` ------ ## Consulta anche Le seguenti risorse correlate possono esserti utili nell'utilizzo di questa regola. + [Tutorial: crea una regola di controllo variabile per una pipeline come condizione di ingresso](tutorials-varcheckrule.md)— Questa sezione fornisce un tutorial con i passaggi per creare una condizione On Entry con una regola di controllo variabile. + [Riferimento alle variabili](reference-variables.md)— Questa sezione fornisce informazioni di riferimento ed esempi per le variabili della pipeline. + Per ulteriori informazioni su regole e condizioni, vedere [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) e [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)nella *Guida CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)