Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Referenz zur Regelstruktur Dieser Abschnitt dient nur als Referenz für die Regelkonfiguration. Eine konzeptionelle Übersicht über die Pipeline-Struktur finden Sie unter [CodePipeline Referenz zur Pipeline-Struktur](reference-pipeline-structure.md). Jeder Regelanbieter CodePipeline verwendet eine Reihe von erforderlichen und optionalen Konfigurationsfeldern in der Pipeline-Struktur. Dieser Abschnitt enthält die folgenden Referenzinformationen nach Regelanbietern: + Gültige Werte für die `RuleType` Felder, die im Regelblock für die Pipelinestruktur enthalten sind, z. B. `Owner` und`Provider`. + Beschreibungen und andere Referenzinformationen für die `Configuration` Parameter (erforderlich und optional), die im Abschnitt mit der Pipeline-Strukturregel enthalten sind. + Gültiges Beispiel für die Konfiguration von JSON- und YAML-Regeln. Referenzinformationen sind für die folgenden Regelanbieter verfügbar: **Topics** + [CloudWatchAlarm](rule-reference-CloudWatchAlarm.md) + [CodeBuild Regel](rule-reference-CodeBuild.md) + [Befehle](rule-reference-Commands.md) + [DeploymentWindow](rule-reference-DeploymentWindow.md) + [LambdaInvoke](rule-reference-LambdaInvoke.md) + [VariableCheck](rule-reference-VariableCheck.md) # CloudWatchAlarm Wenn Sie eine Bedingung erstellen, können Sie die `CloudWatchAlarm` Regel hinzufügen. Dieser Abschnitt enthält eine Referenz für die Regelparameter. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). Sie müssen bereits einen Alarm in Amazon CloudWatch als separate Ressource erstellt haben. **Topics** + [Art der Regel](#rule-reference-CloudWatchAlarm-type) + [Konfigurationsparameter](#rule-reference-CloudWatchAlarm-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-CloudWatchAlarm-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-CloudWatchAlarm-links) ## Art der Regel + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `CloudWatchAlarm` + Version: `1` ## Konfigurationsparameter **AlarmName** Erforderlich: Ja Der Name des CloudWatch Alarms. Dies ist eine separate Ressource, die in erstellt wurde CloudWatch. **AlarmStates** Erforderlich: Nein Die gewünschten CloudWatch Alarmzustände, die von der Regel überwacht werden sollen. Gültige Werte sind ALARM, OK und INSUFFICIENT\$1DATA. **WaitTime** Erforderlich: Nein Die Wartezeit in Minuten, bis eine Statusänderung möglich ist, bevor das Regelergebnis ausgeführt wird. Konfigurieren Sie beispielsweise 20 Minuten, um zu warten, bis sich der Alarmstatus auf OK ändert, bevor das Regelergebnis angewendet wird. ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ] } ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + [Bedingungen bei Ausfall erstellen](stage-conditions.md#stage-conditions-onfailure)— Dieser Abschnitt enthält Schritte zum Erstellen eines Zustands bei Ausfall mit einer Alarmregel. # CodeBuild Regel Wenn Sie eine Bedingung erstellen, können Sie die CodeBuild Regel hinzufügen. Dieser Abschnitt enthält eine Referenz zu den Regelparametern. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). Sie können die CodeBuild Regel verwenden, um eine Bedingung zu erstellen, unter der die erfolgreiche Ausführung Ihres Build-Projekts die Regelkriterien erfüllt, z. B. wenn die Build-Ausführung für eine BeforeEntry-Bedingung erfolgreich war. **Anmerkung** Für BeforeEntry-Bedingungen, die mit dem **Skip-Ergebnis** konfiguriert sind, sind nur die folgenden Regeln verfügbar: und. `LambdaInvoke` `VariableCheck` **Topics** + [Richtlinienberechtigungen für Servicerollen](#rule-reference-Commands-policy) + [Regeltyp](#rule-reference-Commands-type) + [Konfigurationsparameter](#rule-reference-Commands-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-Commands-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-Commands-links) ## Richtlinienberechtigungen für Servicerollen Informationen zu den Berechtigungen für diese Regel finden Sie in der Richtlinienerklärung zu den CodePipeline Servicerollen wie folgt. Beschränken Sie die Berechtigungen auf die Ressourcenebene. ``` { "Effect": "Allow", "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild" ], "Resource": "resource_ARN" }, ``` ## Regeltyp + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `CodeBuild` + Version: `1` ## Konfigurationsparameter **ProjectName** Erforderlich: Ja `ProjectName`ist der Name des Build-Projekts in CodeBuild. **PrimarySource** Required: Conditional Der Wert des `PrimarySource` Parameters muss der Name eines der Eingabeartefakte für die Aktion sein. CodeBuild sucht nach der Buildspec-Datei und führt die Buildspec-Befehle in dem Verzeichnis aus, das die entpackte Version dieses Artefakts enthält. Dieser Parameter ist erforderlich, wenn für eine CodeBuild -Aktion mehrere Eingabeartefakte angegeben werden. Wenn nur ein Quellartefakt für die Aktion vorhanden ist, verwendet das `PrimarySource`-Artefakt standardmäßig dieses Artefakt. **BatchEnabled** Erforderlich: Nein Der boolesche Wert des `BatchEnabled` Parameters ermöglicht es der Aktion, mehrere Builds in derselben Build-Ausführung auszuführen. Wenn diese Option aktiviert ist, ist die `CombineArtifacts` Option verfügbar. Pipeline-Beispiele mit aktivierten Batch-Builds finden Sie unter [CodePipeline Integration mit CodeBuild und Batch-Builds](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-batch.html). **CombineArtifacts** Erforderlich: Nein Der boolesche Wert des `CombineArtifacts` Parameters kombiniert alle Build-Artefakte aus einem Batch-Build in einer einzigen Artefaktdatei für die Build-Aktion. Um diese Option verwenden zu können, muss der `BatchEnabled` Parameter aktiviert sein. **EnvironmentVariables** Erforderlich: Nein Der Wert dieses Parameters wird verwendet, um Umgebungsvariablen für die CodeBuild -Aktion in Ihrer Pipeline festzulegen. Der Wert für den Parameter `EnvironmentVariables` hat das Format eines JSON-Arrays von Umgebungsvariablenobjekten. Einen Beispielparameter finden Sie unter [Aktionserklärung (CodeBuild Beispiel)](action-reference-CodeBuild.md#action-reference-CodeBuild-example). Jedes Objekt besteht aus drei Teilen. Alle Teile sind Zeichenfolgen: + `name`: Der Name oder Schlüssel der Umgebungsvariable. + `value`: Der Wert der Umgebungsvariable. Wenn Sie den `SECRETS_MANAGER` Typ `PARAMETER_STORE` oder verwenden, muss dieser Wert der Name eines Parameters sein, den Sie bereits im AWS Systems Manager Parameter Store gespeichert haben, bzw. eines Secrets, das Sie bereits in AWS Secrets Manager gespeichert haben. **Anmerkung** Es wird dringend davon abgeraten, Umgebungsvariablen zum Speichern sensibler Werte, insbesondere von AWS Anmeldeinformationen, zu verwenden. Wenn Sie die CodeBuild Konsole oder AWS CLI verwenden, werden Umgebungsvariablen im Klartext angezeigt. Wenn es sich um vertrauliche Werte handelt, sollten Sie stattdessen den Typ `SECRETS_MANAGER` verwenden. + `type`: (Optional) Der Typ der Umgebungsvariablen. Gültige Werte sind `PARAMETER_STORE`, `SECRETS_MANAGER` oder `PLAINTEXT`. Wenn keine Angabe gemacht wird, gilt der Standardwert `PLAINTEXT`. Wenn Sie `name``value`, und `type` für Ihre Umgebungsvariablenkonfiguration eingeben, insbesondere wenn die Umgebungsvariable die Syntax der CodePipeline Ausgabevariablen enthält, sollten Sie die 1000-Zeichen-Grenze für das Wertefeld der Konfiguration nicht überschreiten. Ein Validierungsfehler wird zurückgegeben, wenn dieser Grenzwert überschritten wird. Weitere Informationen finden Sie [ EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html)in der AWS CodeBuild API-Referenz. Ein Beispiel für eine CodeBuild Aktion mit einer Umgebungsvariablen, die in den Namen der GitHub Verzweigung aufgelöst wird, finden Sie unter[Beispiel: Verwenden Sie eine BranchName Variable mit CodeBuild Umgebungsvariablen](actions-variables.md#actions-variables-examples-env-branchname). ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + Weitere Informationen zu Regeln und Bedingungen finden Sie unter [[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)Bedingung](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) und [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)im *CodePipeline API-Leitfaden*. # Befehle Wenn Sie eine Bedingung erstellen, können Sie die `Commands` Regel hinzufügen. Dieser Abschnitt enthält eine Referenz zu den Regelparametern. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). Sie können die `Commands` Regel verwenden, um eine Bedingung zu erstellen, unter der die erfolgreichen Befehle die Regelkriterien erfüllen, z. B. die Ausgabe und den Dateipfad für die Befehle, die bei einer BeforeEntry-Bedingung erfolgreich sind. **Anmerkung** Für BeforeEntry-Bedingungen, die mit dem **Skip-Ergebnis** konfiguriert sind, sind nur die folgenden Regeln verfügbar: und. `LambdaInvoke` `VariableCheck` **Topics** + [Überlegungen zur Befehlsregel](#rule-reference-Commands-considerations) + [Richtlinienberechtigungen für die Servicerolle](#rule-reference-Commands-policy) + [Art der Regel](#rule-reference-Commands-type) + [Konfigurationsparameter](#rule-reference-Commands-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-Commands-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-Commands-links) ## Überlegungen zur Befehlsregel Die folgenden Überlegungen gelten für die Befehlsregel. + Die Befehlsregel verwendet CodeBuild Ressourcen, die der CodeBuild Aktion ähneln, erlaubt aber Befehle in der Shell-Umgebung in einer virtuellen Recheninstanz, ohne dass ein Build-Projekt zugeordnet oder erstellt werden muss. **Anmerkung** Für die Ausführung der Befehlsregel fallen separate Gebühren in an AWS CodeBuild. + Da die Befehlsregel in CodeBuild Ressourcen CodePipeline verbraucht, werden die von der Aktion ausgeführten Builds den Build-Limits für Ihr Konto in CodeBuild zugeordnet. Builds, die mit der Befehlsregel ausgeführt werden, werden auf die Limits für gleichzeitige Builds angerechnet, die für dieses Konto konfiguriert sind. + Das Timeout für Builds mit der Befehlsregel beträgt 55 Minuten, je CodeBuild nach Builds. + Die Recheninstanz verwendet eine isolierte Build-Umgebung in CodeBuild. **Anmerkung** Da die isolierte Build-Umgebung auf Kontoebene verwendet wird, kann eine Instanz für eine andere Pipeline-Ausführung wiederverwendet werden. + Alle Formate außer mehrzeiligen Formaten werden unterstützt. Bei der Eingabe von Befehlen müssen Sie das einzeilige Format verwenden. + Für diese Regel CodePipeline wird die Pipelinedienst-Rolle übernommen und diese Rolle verwendet, um den Zugriff auf Ressourcen zur Laufzeit zu ermöglichen. Es wird empfohlen, die Servicerolle so zu konfigurieren, dass die Berechtigungen bis auf die Aktionsebene beschränkt sind. + Die der CodePipeline Servicerolle hinzugefügten Berechtigungen werden unter detailliert beschrieben. [Fügen Sie der CodePipeline Servicerolle Berechtigungen hinzu](how-to-custom-role.md#how-to-update-role-new-services) + Die zum Anzeigen von Protokollen in der Konsole erforderlichen Berechtigungen finden Sie unter[Zum Anzeigen von Rechenprotokollen in der Konsole sind Berechtigungen erforderlich](security-iam-permissions-console-logs.md). Verwenden Sie in den folgenden Beispielbildschirmen den Link **Logs**, um Logs für eine erfolgreiche Befehlsregel in CloudWatch Logs aufzurufen. ![\[Die Statusseite für eine Pipeline mit der Befehlsregel\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-rule-status.png) ![\[Die Seite „Protokolle“ CloudWatch für eine Pipeline mit der Befehlsregel\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-rule-logs.png) + Im Gegensatz zu anderen Aktionen in CodePipeline legen Sie keine Felder in der Aktionskonfiguration fest. Sie legen die Felder für die Aktionskonfiguration außerhalb der Aktionskonfiguration fest. ## Richtlinienberechtigungen für die Servicerolle Wenn die Regel CodePipeline ausgeführt CodePipeline wird, wird eine Protokollgruppe mit dem Namen der Pipeline wie folgt erstellt. Auf diese Weise können Sie die Berechtigungen für die Protokollierung von Ressourcen mithilfe des Pipelinenamens einschränken. ``` /aws/codepipeline/MyPipelineName ``` Wenn Sie eine vorhandene Servicerolle verwenden, müssen Sie zur Verwendung der Aktion Befehle die folgenden Berechtigungen für die Servicerolle hinzufügen. + Protokolle: CreateLogGroup + Protokolle: CreateLogStream + Protokolle: PutLogEvents Beschränken Sie die Berechtigungen in der Richtlinie zur Servicerolle auf die Pipeline-Ebene, wie im folgenden Beispiel gezeigt. ``` { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:YOUR_AWS_ACCOUNT_ID:log-group:/aws/codepipeline/YOUR_PIPELINE_NAME:*" } ``` Um Protokolle in der Konsole mithilfe der Dialogseite mit den Aktionsdetails anzeigen zu können, muss der Konsolenrolle die Berechtigung zum Anzeigen von Protokollen hinzugefügt werden. Weitere Informationen finden Sie im Beispiel für die Richtlinie zu Konsolenberechtigungen unter[Zum Anzeigen von Rechenprotokollen in der Konsole sind Berechtigungen erforderlich](security-iam-permissions-console-logs.md). ## Art der Regel + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `Commands` + Version: `1` ## Konfigurationsparameter **Befehle** Erforderlich: Ja Sie können Shell-Befehle für die Ausführung der `Commands` Regel bereitstellen. In der Konsole werden Befehle in separaten Zeilen eingegeben. In der CLI werden Befehle als separate Zeichenfolgen eingegeben. Mehrzeilige Formate werden nicht unterstützt und führen zu einer Fehlermeldung. Für die Eingabe von Befehlen in das Befehlsfeld muss ein einzeiliges Format verwendet **werden**. Die folgenden Details stellen die Standardrechnung dar, die für die Befehlsregel verwendet wird. Weitere Informationen finden Sie in der Referenz zu den [Berechnungsmodi und Typen der Build-Umgebung](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) im CodeBuild Benutzerhandbuch. + **CodeBuild Bild:** aws/codebuild/amazonlinux 2-x86\$164-standard:5.0 + **Rechnertyp: Linux Small** + **ComputeType-Wert der Umgebung:** BUILD\$1 \$1SMALL GENERAL1 + **Wert des Umgebungstyps: LINUX\$1CONTAINER** ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ] } ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + Weitere Informationen zu Regeln und Bedingungen finden Sie unter [[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)Bedingung](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) und [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)im *CodePipeline API-Leitfaden*. # DeploymentWindow Wenn Sie eine Bedingung erstellen, können Sie die `DeploymentWindow` Regel hinzufügen. Dieser Abschnitt enthält eine Referenz zu den Regelparametern. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). **Topics** + [Art der Regel](#rule-reference-DeploymentWindow-type) + [Konfigurationsparameter](#rule-reference-DeploymentWindow-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-DeploymentWindow-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-DeploymentWindow-links) ## Art der Regel + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `DeploymentWindow` + Version: `1` ## Konfigurationsparameter **Cron** Erforderlich: Ja Der Ausdruck, der die Tage und Zeiten definiert, an denen die Bereitstellung zulässig ist. Cron-Ausdrücke bestehen aus 6 Pflichtfeldern und einem optionalen Feld, das durch Leerzeichen getrennt ist. Mit den Cron-Ausdrucksfeldern können Sie ein Zeitplanmuster mit einem Cron-Ausdruck wie folgt angeben. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html) + Das Zeichen '\$1' wird verwendet, um alle Werte anzugeben. Zum Beispiel bedeutet „\$1“ im Minutenfeld „jede Minute“. + Das '?' Für die day-of-week Felder day-of-month und ist ein Zeichen zulässig. Es wird verwendet, um „kein spezifischer Wert“ anzugeben. Dies ist nützlich, wenn Sie in einem der beiden Felder etwas angeben müssen, in dem anderen jedoch nicht. + Das Zeichen '-' wird verwendet, um Bereiche anzugeben. Beispielsweise bedeutet „10-12" im Stundenfeld „die Stunden 10, 11 und 12". + Das Zeichen ',' wird verwendet, um zusätzliche Werte anzugeben. Zum Beispiel bedeutet „MON, WED, FR“ in dem day-of-week Feld „die Tage Montag, Mittwoch und Freitag“. + Das Zeichen '/' wird verwendet, um Inkremente anzugeben. Zum Beispiel bedeutet „0/15" im Sekundenfeld „die Sekunden 0, 15, 30 und 45". Und „5/15" im Sekundenfeld bedeutet „die Sekunden 5, 20, 35 und 50". Die Angabe von '\$1' vor dem '/' entspricht der Angabe von 0, dem Wert, mit dem begonnen werden soll. + Das Zeichen 'L' ist für die day-of-week Felder day-of-month und zulässig. Dieses Zeichen ist eine Abkürzung für „letztes“, hat aber in jedem der beiden Felder eine andere Bedeutung. Beispielsweise bedeutet der Wert „L“ in dem day-of-month Feld „der letzte Tag des Monats“ — Tag 31 für Januar, Tag 28 für Februar in Jahren ohne Schaltjahre. Wird er in dem day-of-week Feld alleine verwendet, bedeutet er einfach „7" oder „SAT“. Wenn es jedoch im day-of-week Feld hinter einem anderen Wert verwendet wird, bedeutet es „der letzte Tag des Monats“ - zum Beispiel bedeutet „6L“ „der letzte Freitag des Monats“. Sie können auch einen Offset vom letzten Tag des Monats angeben, z. B. „L-3", was den third-to-last Tag des Kalendermonats bedeuten würde. + Das Zeichen 'W' ist für das day-of-month Feld zulässig. Dieses Zeichen wird verwendet, um den Wochentag (Montag-Freitag) anzugeben, der dem angegebenen Tag am nächsten ist. Wenn Sie beispielsweise „15W“ als Wert für das day-of-month Feld angeben, lautet die Bedeutung: „der Wochentag, der dem 15. des Monats am nächsten liegt“. Wenn der 15. also ein Samstag ist, wird der Auslöser am Freitag, dem 14. ausgelöst. Wenn der 15. ein Sonntag ist, wird der Auslöser am Montag, dem 16. ausgelöst. Wenn der 15. ein Dienstag ist, wird er am Dienstag, dem 15. ausgelöst. + Die Zeichen 'L' und 'W' können auch kombiniert werden, sodass der day-of-month Ausdruck 'LW' ergibt, was übersetzt „letzter Wochentag des Monats“ bedeutet. + Das Zeichen '\$1' ist für das day-of-week Feld zulässig. Dieses Zeichen wird verwendet, um den „n-ten“ Tag des Monats anzugeben. Beispielsweise bedeutet der Wert „6 \$13" im day-of-week Feld den dritten Freitag im Monat (Tag 6 = Freitag und "\$13" = der dritte im Monat). + Bei den zulässigen Zeichen und den Namen der Monate und Wochentage wird nicht zwischen Groß- und Kleinschreibung unterschieden. **TimeZone** Erforderlich: Nein Die Zeitzone für das Bereitstellungsfenster. Der reguläre Ausdruck entspricht Mustern in den folgenden Formaten: + **Format Region/Stadt**. Der Wert entspricht einer Zeitzone im Format Region/City Region/City\$1City. Zum Beispiel `America/New_York` oder `Europe/Berlin`. + **UTC-Format.** Der Wert entspricht der Zeichenfolge UTC, optional gefolgt von einem Offset im Format \$1HH:MM oder -HH:MM. Zum Beispiel,, oder. `UTC` `UTC+05:30` `UTC-03:00` Dies ist das Standardformat, wenn der Parameter nicht anders festgelegt ist. + **Abkürzungsformat**. Der Wert entspricht einer Abkürzung mit 3 bis 5 Zeichen für eine Zeitzone. Zum Beispiel `EST` oder `IST`. Eine Tabelle mit gültigen TimeZone ID-Werten finden Sie unter [https://docs.oracle.com/middleware/1221/.html wcs/tag-ref/MISC/TimeZones](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html). Beachten Sie, dass es sich bei bestimmten Abkürzungen um doppelte Abkürzungen handelt, z. B. CST für Central Standard Time, China Standard Time und Cuba Standard Time. ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ] ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + [Bedingungen bei Erfolg erstellen](stage-conditions.md#stage-conditions-onsuccess)— Dieser Abschnitt enthält Schritte zum Erstellen der Bedingung „Bei Erfolg“ mit einer Regel für das Bereitstellungsfenster. + Weitere Informationen zu Regeln und Bedingungen finden Sie unter [[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)Bedingung](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) und [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)im *CodePipeline API-Leitfaden*. # LambdaInvoke Wenn Sie eine Bedingung erstellen, können Sie die `LambdaInvoke` Regel hinzufügen. Dieser Abschnitt enthält eine Referenz für die Regelparameter. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). Sie müssen bereits eine Funktion in Lambda als separate Ressource erstellt haben. **Topics** + [Regeltyp](#rule-reference-CloudWatchAlarm-type) + [Konfigurationsparameter](#rule-reference-LambdaInvoke-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-LambdaInvoke-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-LambdaInvoke-links) ## Regeltyp + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `LambdaInvoke` + Version: `1` ## Konfigurationsparameter **FunctionName** Erforderlich: Ja Der Name der Lambda-Funktion. **UserParameters** Erforderlich: Nein Dies sind Parameter, die als Eingabe für die Funktion im Schlüssel-Wert-Paarformat bereitgestellt werden. ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ] ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + [Bedingungen bei Ausfall erstellen](stage-conditions.md#stage-conditions-onfailure)— Dieser Abschnitt enthält Schritte zum Erstellen eines Zustands bei Ausfall mit einer Alarmregel. # VariableCheck Wenn Sie eine Bedingung erstellen, können Sie die `VariableCheck` Regel hinzufügen. Dieser Abschnitt enthält eine Referenz zu den Regelparametern. Weitere Informationen zu Regeln und Bedingungen finden Sie unter[Wie funktionieren die Stufenbedingungen?](concepts-how-it-works-conditions.md). Sie können die `VariableCheck` Regel verwenden, um eine Bedingung zu erstellen, bei der die Ausgabevariable mit einem angegebenen Ausdruck verglichen wird. Die Regel besteht die Prüfung, wenn der Variablenwert die Regelkriterien erfüllt, z. B. wenn der Wert gleich oder größer als eine angegebene Ausgabevariable ist. **Topics** + [Art der Regel](#rule-reference-VariableCheck-type) + [Konfigurationsparameter](#rule-reference-VariableCheck-config) + [Beispiel für eine Regelkonfiguration](#rule-reference-VariableCheck-example) + [Weitere Informationen finden Sie auch unter](#rule-reference-VariableCheck-links) ## Art der Regel + Kategorie: `Rule` + Eigentümer: `AWS` + Anbieter: `VariableCheck` + Version: `1` ## Konfigurationsparameter **Operator** Erforderlich: Ja Der Operator, der angibt, welche Operation für die Variablenprüfung ausgeführt werden soll. Im folgenden Beispiel wird die Ausgabevariable für den Repository-Namen daraufhin überprüft, ob sie gleich ist`MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Die folgenden Operatoren stehen zur Verfügung, um einen Ausdruck wie folgt zu erstellen. + **Gleich** — Wählen Sie diesen Operator, um zu überprüfen, ob die Variable dem Zeichenkettenwert entspricht. **CLI-Parameter:** `EQ` + **Enthält** — Wählen Sie diesen Operator, um zu überprüfen, ob die Variable den Zeichenkettenwert als Teilstring enthält. **CLI-Parameter:** `CONTAINS` + **Entspricht** — Wählen Sie diesen Operator, um zu überprüfen, ob die Variable einem bestimmten Regex-Ausdruck als Zeichenkettenwert entspricht. Alle regulären Ausdrücke CodePipeline entsprechen der Java-Regex-Syntax. Eine umfassende Beschreibung der Java Regex-Syntax und ihrer Konstrukte finden Sie unter [java.util.regex.Pattern](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html). **CLI-Parameter:** `MATCHES` + **Entspricht nicht** — Wählen Sie diesen Operator, um zu überprüfen, ob die Variable nicht dem Zeichenkettenwert entspricht. **CLI-Parameter:** `NE` **Variable** Erforderlich: Ja Die zu überprüfenden Pipeline-Variablen. **Wert** Erforderlich: Ja Der Wert für den Ausdruck, gegen den geprüft werden soll. Im folgenden Beispiel wird die Ausgabevariable für den Repository-Namen daraufhin überprüft, ob sie gleich ist`MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Im folgenden JSON-Beispiel werden zwei separate Regeln definiert, eine für eine `EQ` (equals) -Anweisung, die das Repository überprüft, und den Branch-Namen, formatiert als \$1 \$1. SourceVariables RepositoryName\$1 und eine davon überprüft `CONTAINS` die als \$1 \$1formatierte Ausgabevariable der Commit-Nachricht. SourceVariables CommitMessage\$1 gegen den angegebenen Wert „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" } ] } ] } } ], ``` ## Beispiel für eine Regelkonfiguration ------ #### [ 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" } ] ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen können Ihnen bei der Arbeit mit dieser Regel helfen. + [Tutorial: Erstellen Sie eine Regel zur Überprüfung variabler Variablen für eine Pipeline als Eingabebedingung](tutorials-varcheckrule.md)— Dieser Abschnitt enthält ein Tutorial mit Schritten zum Erstellen einer Bedingung bei der Eingabe mit einer Regel zur Überprüfung von Variablen. + [Variablen-Referenz](reference-variables.md)— Dieser Abschnitt enthält Referenzinformationen und Beispiele für Pipeline-Variablen. + Weitere Informationen zu Regeln und Bedingungen finden Sie unter [[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)Bedingung](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) und [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)im *CodePipeline API-Leitfaden*.