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. # 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*.