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. # CodeCommit Referenz zur Quellaktion Startet die Pipeline, wenn ein neuer Commit für das konfigurierte CodeCommit Repository und den Branch vorgenommen wird. Wenn Sie die Konsole verwenden, um die Pipeline zu erstellen oder zu bearbeiten, CodePipeline erstellt sie eine EventBridge Regel, die Ihre Pipeline startet, wenn eine Änderung im Repository erfolgt. **Anmerkung** Für Amazon ECR, Amazon S3 oder CodeCommit Quellen können Sie auch eine Quellüberschreibung mithilfe des Eingabe-Transformationseintrags erstellen, um den `revisionValue` In EventBridge für Ihr Pipeline-Ereignis zu verwenden, wobei der von der Quellereignisvariablen für Ihren Objektschlüssel, Ihren Commit oder Ihre Image-ID abgeleitet `revisionValue` wird. Weitere Informationen finden Sie im optionalen Schritt für die Eingabe der Eingabetransformation, der in den Verfahren unter [Amazon ECR-Quellaktionen und Ressourcen EventBridge](create-cwe-ecr-source.md)[Verbindung zu Amazon S3 S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle herstellen](create-S3-source-events.md), oder [CodeCommit Quellaktionen und EventBridge](triggering.md) enthalten ist. Sie müssen bereits ein CodeCommit Repository erstellt haben, bevor Sie die Pipeline über eine CodeCommit Aktion verbinden können. Nachdem eine Codeänderung erkannt wurde, haben Sie die folgenden Optionen, um den Code an nachfolgende Aktionen zu übergeben: + **Standard** — Konfiguriert die CodeCommit Quellaktion so, dass sie eine ZIP-Datei mit einer flachen Kopie Ihres Commits ausgibt. + **Vollständiger Klon** — Konfiguriert die Quellaktion so, dass sie für nachfolgende Aktionen eine Git-URL-Referenz an das Repository ausgibt. Derzeit kann die Git-URL-Referenz nur von CodeBuild Downstream-Aktionen verwendet werden, um das Repo und die zugehörigen Git-Metadaten zu klonen. Der Versuch, eine Git-URL-Referenz an CodeBuild Nichtaktionen zu übergeben, führt zu einem Fehler. **Topics** + [Aktionstyp](#action-reference-CodeCommit-type) + [Konfigurationsparameter](#action-reference-CodeCommit-config) + [Input artifacts (Eingabeartefakte)](#action-reference-CodeCommit-input) + [Ausgabeartefakte](#action-reference-CodeCommit-output) + [Ausgabevariablen](#action-reference-CodeCommit-variables) + [Berechtigungen für Servicerollen: CodeCommit Aktion](#edit-role-codecommit) + [Beispielaktionskonfiguration](#action-reference-CodeCommit-example) + [Weitere Informationen finden Sie auch unter](#action-reference-CodeCommit-links) ## Aktionstyp + Kategorie: `Source` + Eigentümer: `AWS` + Anbieter: `CodeCommit` + Version: `1` ## Konfigurationsparameter **RepositoryName** Erforderlich: Ja Der Name des Repositorys, in dem Quelländerungen erkannt werden sollen. **BranchName** Erforderlich: Ja Der Name des Zweigs, in dem Quelländerungen erkannt werden sollen. **PollForSourceChanges** Erforderlich: Nein `PollForSourceChanges`steuert, ob das CodeCommit Repository nach Quellenänderungen CodePipeline abfragt. Wir empfehlen, stattdessen CloudWatch Ereignisse zu verwenden, um Quellenänderungen zu erkennen. Weitere Informationen zur Konfiguration von CloudWatch Ereignissen finden Sie unter [Migrieren von Abfrage-Pipelines (CodeCommit Quelle) (CLI)](update-change-detection.md#update-change-detection-cli-codecommit) oder[Migrieren Sie Abfrage-Pipelines (CodeCommit Quelle) (CloudFormation Vorlage)](update-change-detection.md#update-change-detection-cfn-codecommit). Wenn Sie beabsichtigen, eine CloudWatch Ereignisregel zu konfigurieren, müssen Sie „`PollForSourceChanges`auf“ festlegen, `false` um doppelte Pipeline-Ausführungen zu vermeiden. Gültige Werte für diesen Parameter sind: + `true`: Wenn diese Option gesetzt ist, CodePipeline wird Ihr Repository nach Quellenänderungen abgefragt. **Anmerkung** Wenn Sie diese Option weglassen`PollForSourceChanges`, wird CodePipeline standardmäßig Ihr Repository nach Quelländerungen abgefragt. Dieses Verhalten ist das gleiche, als ob `PollForSourceChanges` enthalten wäre und auf `true` festgelegt würde. + `false`: Falls gesetzt, fragt dein Repository CodePipeline nicht nach Quellenänderungen ab. Verwenden Sie diese Einstellung, wenn Sie beabsichtigen, eine CloudWatch Ereignisregel zur Erkennung von Quelländerungen zu konfigurieren. ****OutputArtifactFormat**** Erforderlich: Nein Das Format des Ausgabeartefakts. Werte können entweder `CODEBUILD_CLONE_REF` oder `CODE_ZIP` sein. Wenn dieser Parameter nicht angegeben wird, lautet der Standardwert `CODE_ZIP`. Die `CODEBUILD_CLONE_REF`-Option kann nur von CodeBuild nachgeschalteten Aktionen verwendet werden. Wenn Sie diese Option wählen, müssen Sie Ihrer CodeBuild Servicerolle die `codecommit:GitPull` entsprechende Berechtigung hinzufügen, wie unter beschrieben[Fügen Sie CodeBuild GitClone Berechtigungen für CodeCommit Quellaktionen hinzu](troubleshooting.md#codebuild-role-codecommitclone). Sie müssen Ihrer CodePipeline Servicerolle auch die `codecommit:GetRepository` Berechtigung hinzufügen, wie unter beschrieben[Fügen Sie der CodePipeline Servicerolle Berechtigungen hinzu](how-to-custom-role.md#how-to-update-role-new-services). Ein Tutorial, das Ihnen zeigt, wie Sie die Option **Vollständiges Klonen** verwenden, finden Sie unter[Tutorial: Vollständigen Klon mit einer CodeCommit Pipeline-Quelle verwenden](tutorials-codecommit-gitclone.md). ## Input artifacts (Eingabeartefakte) + **Anzahl der Artefakte:** `0` + **Beschreibung:** Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig. ## Ausgabeartefakte + **Anzahl der Artefakte:** `1` + **Beschreibung:** Das Ausgabe-Artefakt dieser Aktion ist eine ZIP-Datei, die den Inhalt des konfigurierten Repositorys und Zweigs beim Commit enthält, der als Quellrevision für die Pipeline-Ausführung angegeben wurde. Die aus dem Repository generierten Artefakte sind die Ausgabeartefakte für die CodeCommit Aktion. Die Quellcode-Commit-ID wird CodePipeline als Quellrevision für die ausgelöste Pipeline-Ausführung angezeigt. ## Ausgabevariablen Wenn dies konfiguriert ist, werden durch diese Aktion Variablen erzeugt, die von der Aktionskonfiguration einer nachgeschalteten Aktion in der Pipeline referenziert werden können. Diese Aktion erzeugt Variablen, die als Ausgabevariablen angezeigt werden können, auch wenn die Aktion keinen Namespace hat. Sie konfigurieren eine Aktion mit einem Namespace, um diese Variablen für die Konfiguration nachgeschalteter Aktionen zur Verfügung zu stellen. Weitere Informationen finden Sie unter [Variablen-Referenz](reference-variables.md). **CommitId** Die CodeCommit Commit-ID, die die Pipeline-Ausführung ausgelöst hat. Commit IDs sind die vollständigen SHA-Werte des Commits. **CommitMessage** Die Beschreibungsmeldung (wenn vorhanden), die dem Commit zugeordnet ist, der die Pipeline-Ausführung ausgelöst hat. **RepositoryName** Der Name des CodeCommit Repositorys, in dem der Commit vorgenommen wurde, der die Pipeline ausgelöst hat. **BranchName** Der Name des Branches für das CodeCommit Repository, in dem die Quellenänderung vorgenommen wurde. **AuthorDate** Das Datum im Zeitstempelformat, an dem der Commit erstellt wurde. **CommitterDate** Das Datum im Zeitstempelformat, an dem der Commit durchgeführt wurde. ## Berechtigungen für Servicerollen: CodeCommit Aktion Wenn die Aktion CodePipeline ausgeführt wird, erfordert die CodePipeline Dienstrollenrichtlinie die folgenden Berechtigungen, die entsprechend auf den ARN der Pipeline-Ressource beschränkt sind, um den Zugriff mit den geringsten Rechten aufrechtzuerhalten. Fügen Sie Ihrer Richtlinienerklärung beispielsweise Folgendes hinzu: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "codecommit:CancelUploadArchive", "codecommit:GetBranch", "codecommit:GetCommit", "codecommit:GetRepository", "codecommit:GetUploadArchiveStatus", "codecommit:UploadArchive" ], "Resource": [ "arn:aws:codecommit:*:111122223333:[[codecommitRepostories]]" ] } ] } ``` ------ ## Beispielaktionskonfiguration ### Beispiel für das Standardformat für Ausgabeartefakte ------ #### [ YAML ] ``` name: Source actionTypeId: category: Source owner: AWS provider: CodeCommit version: '1' runOrder: 1 configuration: BranchName: main PollForSourceChanges: 'false' RepositoryName: MyWebsite outputArtifacts: - name: Artifact_MyWebsiteStack inputArtifacts: [] region: us-west-2 namespace: SourceVariables ``` ------ #### [ JSON ] ``` { "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "provider": "CodeCommit", "version": "1" }, "runOrder": 1, "configuration": { "BranchName": "main", "PollForSourceChanges": "false", "RepositoryName": "MyWebsite" }, "outputArtifacts": [ { "name": "Artifact_MyWebsiteStack" } ], "inputArtifacts": [], "region": "us-west-2", "namespace": "SourceVariables" } ``` ------ ### Beispiel für das vollständige Clone-Ausgabeartefaktformat ------ #### [ YAML ] ``` name: Source actionTypeId: category: Source owner: AWS provider: CodeCommit version: '1' runOrder: 1 configuration: BranchName: main OutputArtifactFormat: CODEBUILD_CLONE_REF PollForSourceChanges: 'false' RepositoryName: MyWebsite outputArtifacts: - name: SourceArtifact inputArtifacts: [] region: us-west-2 namespace: SourceVariables ``` ------ #### [ JSON ] ``` { "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "provider": "CodeCommit", "version": "1" }, "runOrder": 1, "configuration": { "BranchName": "main", "OutputArtifactFormat": "CODEBUILD_CLONE_REF", "PollForSourceChanges": "false", "RepositoryName": "MyWebsite" }, "outputArtifacts": [ { "name": "SourceArtifact" } ], "inputArtifacts": [], "region": "us-west-2", "namespace": "SourceVariables" } ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion. + [Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommit Repository)](tutorials-simple-codecommit.md)— Dieses Tutorial enthält ein Beispiel für eine App-Spezifikationsdatei sowie eine CodeDeploy Beispielanwendung und eine Bereitstellungsgruppe. Verwenden Sie dieses Tutorial, um eine Pipeline mit einer CodeCommit Quelle zu erstellen, die auf Amazon EC2 EC2-Instances bereitgestellt wird.