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à. # CodeCommit riferimento all'azione di origine Avvia la pipeline quando viene effettuato un nuovo commit sul CodeCommit repository e sul ramo configurati. Se utilizzi la console per creare o modificare la pipeline, CodePipeline crea una EventBridge regola che avvia la pipeline quando si verifica una modifica nel repository. **Nota** Per Amazon ECR, Amazon S3 CodeCommit o sorgenti, puoi anche creare un'override di origine utilizzando input transform entry per utilizzare l' EventBridge in per `revisionValue` il tuo evento pipeline, dove è derivato dalla variabile `revisionValue` dell'evento source per la chiave oggetto, il commit o l'ID immagine. Per ulteriori informazioni, consulta il passaggio facoltativo per l'immissione della trasformazione di input incluso nelle procedure riportate in, o. [Azioni e risorse relative ai sorgenti di Amazon ECR EventBridge](create-cwe-ecr-source.md) [Connessione alle azioni di origine di Amazon S3 con una fonte abilitata per gli eventi](create-S3-source-events.md) [CodeCommit azioni di origine e EventBridge](triggering.md) È necessario aver già creato un CodeCommit repository prima di connettere la pipeline tramite un' CodeCommit azione. Una volta rilevata una modifica del codice, sono disponibili le seguenti opzioni per passare il codice alle operazioni successive: + **Predefinito**: configura l'azione di CodeCommit origine per generare un file ZIP con una copia superficiale del commit. + **Clone completo**: configura l'azione di origine per inviare un riferimento URL Git al repository per le azioni successive. Attualmente, il riferimento all'URL Git può essere utilizzato solo dalle CodeBuild azioni a valle per clonare il repository e i metadati Git associati. Il tentativo di passare un riferimento URL Git a non CodeBuild azioni genera un errore. **Topics** + [Tipo di operazione](#action-reference-CodeCommit-type) + [Parametri di configurazione](#action-reference-CodeCommit-config) + [Input artifact (Artefatti di input)](#action-reference-CodeCommit-input) + [Artefatti di output](#action-reference-CodeCommit-output) + [Variabili di output](#action-reference-CodeCommit-variables) + [Autorizzazioni per i ruoli di servizio: azione CodeCommit](#edit-role-codecommit) + [Esempio di configurazione dell'operazione](#action-reference-CodeCommit-example) + [Consulta anche](#action-reference-CodeCommit-links) ## Tipo di operazione + Categoria: `Source` + Proprietario: `AWS` + Provider: `CodeCommit` + Versione: `1` ## Parametri di configurazione **RepositoryName** Obbligatorio: sì Il nome del repository in cui devono essere rilevate le modifiche di origine. **BranchName** Obbligatorio: sì Il nome del ramo in cui devono essere rilevate le modifiche di origine. **PollForSourceChanges** Obbligatorio: no `PollForSourceChanges`controlla se interroga CodePipeline il CodeCommit repository per verificare la presenza di modifiche all'origine. Ti consigliamo invece di utilizzare CloudWatch Events per rilevare le modifiche all'origine. Per ulteriori informazioni sulla configurazione CloudWatch degli eventi, consulta [Migrazione delle pipeline di polling (CodeCommit origine) (CLI)](update-change-detection.md#update-change-detection-cli-codecommit) o[Migra le pipeline di polling (CodeCommit source) (modello)CloudFormation](update-change-detection.md#update-change-detection-cfn-codecommit). Se intendi configurare una regola CloudWatch Events, devi impostarla su `PollForSourceChanges` per `false` evitare esecuzioni duplicate della pipeline. I valori validi per questo parametro sono: + `true`: Se impostata, analizza il repository per CodePipeline verificare se sono state apportate modifiche all'origine. **Nota** Se si omette`PollForSourceChanges`, per CodePipeline impostazione predefinita esegue il polling del repository per verificare la presenza di modifiche all'origine. Questo comportamento è lo stesso se `PollForSourceChanges` è incluso e impostato su `true`. + `false`: se impostata, CodePipeline non esegue il polling del repository per verificare la presenza di modifiche all'origine. Utilizzate questa impostazione se intendete configurare una regola CloudWatch Events per rilevare le modifiche all'origine. ****OutputArtifactFormat**** Obbligatorio: no Il formato dell'artefatto di output. I valori possono essere uno o due. `CODEBUILD_CLONE_REF` `CODE_ZIP` Se non altrimenti specificato, l'impostazione predefinita è `CODE_ZIP`. L'opzione `CODEBUILD_CLONE_REF` può essere utilizzata solo da operazioni downstream di CodeBuild. Se scegli questa opzione, devi aggiungere l'`codecommit:GitPull`autorizzazione al tuo ruolo di CodeBuild servizio, come mostrato in[Aggiungi le CodeBuild GitClone autorizzazioni per le azioni di origine CodeCommit](troubleshooting.md#codebuild-role-codecommitclone). È inoltre necessario aggiungere l'`codecommit:GetRepository`autorizzazione al proprio ruolo CodePipeline di servizio, come mostrato in[Aggiungi le autorizzazioni al ruolo di servizio CodePipeline](how-to-custom-role.md#how-to-update-role-new-services). Per un tutorial che mostra come usare l'opzione **Full clone**, vedi[Tutorial: usa il clone completo con una sorgente di CodeCommit pipeline](tutorials-codecommit-gitclone.md). ## Input artifact (Artefatti di input) + **Numero di artefatti:** `0` + **Descrizione:** gli artefatti di input non si applicano a questo tipo di azione. ## Artefatti di output + **Numero di artefatti:** `1` + **Descrizione:** l'artefatto di output di questa azione è un file ZIP che contiene il contenuto del repository configurato e del ramo al commit specificato come revisione di origine per l'esecuzione della pipeline. Gli artefatti generati dal repository sono gli artefatti di output dell'azione. CodeCommit L'ID di commit del codice sorgente viene visualizzato CodePipeline come revisione del codice sorgente per l'esecuzione della pipeline attivata. ## Variabili di output Quando è configurata, questa azione produce variabili che possono essere referenziate dalla configurazione dell'azione di un'azione downstream nella pipeline. Questa azione produce variabili che possono essere viste come variabili di output, anche se l'azione non ha uno spazio dei nomi. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream. Per ulteriori informazioni, consulta [Riferimento alle variabili](reference-variables.md). **CommitId** L'ID di CodeCommit commit che ha attivato l'esecuzione della pipeline. IDs I commit sono gli SHA completi del commit. **CommitMessage** Il messaggio di descrizione, se presente, associato al commit che ha attivato l'esecuzione della pipeline. **RepositoryName** Il nome del CodeCommit repository in cui è stato effettuato il commit che ha attivato la pipeline. **BranchName** Il nome del ramo del CodeCommit repository in cui è stata apportata la modifica all'origine. **AuthorDate** La data in cui il commit è stato creato, in formato timestamp. **CommitterDate** La data in cui è stato eseguito il commit, in formato timestamp. ## Autorizzazioni per i ruoli di servizio: azione CodeCommit Quando CodePipeline viene eseguita l'azione, la policy del ruolo di CodePipeline servizio richiede le seguenti autorizzazioni, assegnate in modo appropriato all'ARN della risorsa della pipeline per mantenere l'accesso con il minimo privilegio. Ad esempio, aggiungi quanto segue alla tua dichiarazione politica: ------ #### [ 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]]" ] } ] } ``` ------ ## Esempio di configurazione dell'operazione ### Esempio di formato predefinito degli artefatti di output ------ #### [ 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" } ``` ------ ### Esempio di formato degli artefatti di output del clone completo ------ #### [ 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" } ``` ------ ## Consulta anche Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione. + [Tutorial: crea una pipeline semplice (CodeCommit repository)](tutorials-simple-codecommit.md)— Questo tutorial fornisce un esempio di file di specifiche dell'app e un esempio di CodeDeploy applicazione e gruppo di distribuzione. Usa questo tutorial per creare una pipeline con un CodeCommit sorgente da distribuire su istanze Amazon EC2.