Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CodeCommit référence d'action source Démarre le pipeline lorsqu'un nouveau commit est effectué sur le CodeCommit référentiel et la branche configurés. Si vous utilisez la console pour créer ou modifier le pipeline, CodePipeline crée une EventBridge règle qui démarre votre pipeline lorsqu'une modification intervient dans le référentiel. **Note** Pour Amazon ECR, Amazon S3 ou les CodeCommit sources, vous pouvez également créer une substitution de source en utilisant l'entrée input transform pour utiliser l'événement `revisionValue` in EventBridge pour votre pipeline, dérivé de la `revisionValue` variable d'événement source pour votre clé d'objet, votre commit ou votre identifiant d'image. Pour plus d'informations, consultez l'étape facultative de saisie de la transformation d'entrée incluse dans les procédures [Actions et ressources relatives aux sources Amazon ECR EventBridge](create-cwe-ecr-source.md) décrites sous[Connexion aux actions source Amazon S3 avec une source activée pour les événements](create-S3-source-events.md), ou[CodeCommit actions à la source et EventBridge](triggering.md). Vous devez déjà avoir créé un CodeCommit référentiel avant de connecter le pipeline par le biais d'une CodeCommit action. Une fois qu'une modification de code est détectée, vous disposez des options suivantes pour transmettre le code aux actions suivantes : + **Par défaut** : configure l'action CodeCommit source pour générer un fichier ZIP contenant une copie superficielle de votre commit. + **Clonage complet** : configure l'action source pour générer une référence d'URL Git vers le référentiel pour les actions suivantes. Actuellement, la référence d'URL Git ne peut être utilisée que par des CodeBuild actions en aval pour cloner le dépôt et les métadonnées Git associées. Toute tentative de transmission d'une référence d'URL Git à CodeBuild des non-actions entraîne une erreur. **Topics** + [ ## Type d'action ](#action-reference-CodeCommit-type) + [ ## Paramètres de configuration ](#action-reference-CodeCommit-config) + [ ## Artefacts d'entrée ](#action-reference-CodeCommit-input) + [ ## Artefacts de sortie ](#action-reference-CodeCommit-output) + [ ## Variables de sortie ](#action-reference-CodeCommit-variables) + [ ## Autorisations relatives aux rôles de service : CodeCommit action ](#edit-role-codecommit) + [ ## Exemple de configuration d'action ](#action-reference-CodeCommit-example) + [ ## Consultez aussi ](#action-reference-CodeCommit-links) ## Type d'action + Catégorie : `Source` + Propriétaire : `AWS` + Fournisseur : `CodeCommit` + Version : `1` ## Paramètres de configuration **RepositoryName** Obligatoire : oui Nom du référentiel où les modifications de la source doivent être détectées. **BranchName** Obligatoire : oui Nom de la branche où les modifications de la source doivent être détectées. **PollForSourceChanges** Obligatoire : non `PollForSourceChanges`contrôle si le CodePipeline CodeCommit référentiel est interrogé pour connaître les modifications de source. Nous vous recommandons plutôt d'utiliser CloudWatch les événements pour détecter les modifications de source. Pour plus d'informations sur la configuration CloudWatch des événements, consultez [Migrer les pipelines de sondage (CodeCommit source) (CLI)](update-change-detection.md#update-change-detection-cli-codecommit) ou[Migrer les pipelines de sondage (CodeCommit source) (CloudFormation modèle)](update-change-detection.md#update-change-detection-cfn-codecommit). Si vous avez l'intention de configurer une règle d' CloudWatch événements, vous devez la définir `PollForSourceChanges` pour `false` éviter les exécutions de pipeline dupliquées. Valeurs valides pour ce paramètre : + `true`: si cette option est définie, CodePipeline interroge votre dépôt pour connaître les modifications de source. **Note** Si vous omettez`PollForSourceChanges`, CodePipeline par défaut, votre dépôt est interrogé pour vérifier les modifications de source. Ce comportement est le même que si `PollForSourceChanges` est inclus et défini sur `true`. + `false`: si cette option est définie, CodePipeline elle n'interroge pas votre dépôt pour connaître les modifications de source. Utilisez ce paramètre si vous avez l'intention de configurer une règle d' CloudWatch événements pour détecter les modifications de source. ****OutputArtifactFormat**** Obligatoire : non Le format de l'artefact de sortie. Les valeurs peuvent être `CODEBUILD_CLONE_REF` soit`CODE_ZIP`. Si aucune valeur n'est spécifiée, la valeur par défaut est `CODE_ZIP`. L'option `CODEBUILD_CLONE_REF` ne peut être utilisée que par des actions CodeBuild en aval. Si vous choisissez cette option, vous devez ajouter l'`codecommit:GitPull`autorisation à votre rôle de CodeBuild service, comme indiqué dans[Ajouter CodeBuild GitClone des autorisations pour les actions CodeCommit source](troubleshooting.md#codebuild-role-codecommitclone). Vous devez également ajouter l'`codecommit:GetRepository`autorisation à votre rôle CodePipeline de service, comme indiqué dans[Ajouter des autorisations au rôle CodePipeline de service](how-to-custom-role.md#how-to-update-role-new-services). Pour consulter un didacticiel expliquant comment utiliser l'option de **clonage complet**, voir[Tutoriel : Utiliser un clone complet avec une source de CodeCommit pipeline](tutorials-codecommit-gitclone.md). ## Artefacts d'entrée + **Nombre d'objets :** `0` + **Description :** Les artefacts d'entrée ne s'appliquent pas à ce type d'action. ## Artefacts de sortie + **Nombre d'objets :** `1` + **Description :** l'artefact de sortie de cette action est un fichier ZIP qui regroupe le contenu du référentiel et de la branche configurés au moment de la validation spécifiée comme révision source pour l'exécution du pipeline. Les artefacts générés à partir du référentiel sont les artefacts de sortie de l' CodeCommit action. L'ID de validation du code source est affiché en CodePipeline tant que révision source pour l'exécution du pipeline déclenchée. ## Variables de sortie Lorsque cette action est configurée, elle produit des variables qui peuvent être référencées par la configuration d'action d'une action en aval dans le pipeline. Cette action produit des variables qui peuvent être visualisées en tant que variables de sortie, même si l'action n'a pas d'espace de noms. Vous configurez une action avec un espace de noms pour rendre ces variables disponibles pour la configuration des actions en aval. Pour de plus amples informations, veuillez consulter [Référence aux variables](reference-variables.md). **CommitId** L'ID de CodeCommit validation qui a déclenché l'exécution du pipeline. IDs Les validations correspondent au SHA complet de la validation. **CommitMessage** Message de description, le cas échéant, associé à la validation ayant déclenché l'exécution du pipeline. **RepositoryName** Nom du CodeCommit référentiel dans lequel le commit qui a déclenché le pipeline a été effectué. **BranchName** Nom de la branche du CodeCommit référentiel dans lequel la modification de source a été effectuée. **AuthorDate** Date à laquelle la validation a été créée, au format horodatage. **CommitterDate** Date à laquelle la validation a été validée, au format horodatage. ## Autorisations relatives aux rôles de service : CodeCommit action Lors de l' CodePipeline exécution de l'action, la politique de rôle de CodePipeline service nécessite les autorisations suivantes, correctement limitées à l'ARN de la ressource du pipeline afin de maintenir l'accès avec le moins de privilèges. Par exemple, ajoutez ce qui suit à votre déclaration de politique : ------ #### [ 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]]" ] } ] } ``` ------ ## Exemple de configuration d'action ### Exemple de format d'artefact de sortie par défaut ------ #### [ 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" } ``` ------ ### Exemple de format d'artefact de sortie d'un clone complet ------ #### [ 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" } ``` ------ ## Consultez aussi Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action. + [Tutoriel : Création d'un pipeline simple (CodeCommit référentiel)](tutorials-simple-codecommit.md)— Ce didacticiel fournit un exemple de fichier de spécifications d'application, un exemple d' CodeDeploy application et un groupe de déploiement. Utilisez ce didacticiel pour créer un pipeline avec une CodeCommit source qui se déploie sur des instances Amazon EC2.