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 regola CodeCommit CloudWatch Events che avvia la pipeline quando si verifica una modifica nel repository.

È necessario aver già creato un CodeCommit repository prima di connettere la pipeline tramite un'azione. CodeCommit

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 ZIP file con una copia superficiale del commit.

• Clone completo: configura l'azione di origine per inviare un URL riferimento Git al repository per le azioni successive.

  Attualmente, il URL riferimento Git può essere utilizzato solo dalle CodeBuild azioni a valle per clonare il repository e i metadati Git associati. Il tentativo di passare un URL riferimento Git a non CodeBuild azioni genera un errore.

Tipo di operazione

• Categoria: Source

• Proprietario: AWS

• Provider: CodeCommit

• Versione: 1

Parametri di configurazione

RepositoryName

Campo obbligatorio: sì

Il nome del repository in cui devono essere rilevate le modifiche di origine.

BranchName

Campo obbligatorio: sì

Il nome del ramo in cui devono essere rilevate le modifiche di origine.

PollForSourceChanges

Campo obbligatorio: no

PollForSourceChangescontrolla 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 Migra le pipeline di polling (source) () CodeCommit CLI oMigra le pipeline di polling (CodeCommit source) (modello)AWS CloudFormation.

Importante

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 omettePollForSourceChanges, 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

Campo 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.

Importante

L'CODEBUILD_CLONE_REFopzione può essere utilizzata solo dalle azioni a CodeBuild valle.

Se scegli questa opzione, devi aggiungere l'codecommit:GitPullautorizzazione al tuo ruolo di CodeBuild servizio, come mostrato inAggiungi CodeBuild GitClone le autorizzazioni per le azioni CodeCommit di origine. È inoltre necessario aggiungere l'codecommit:GetRepositoryautorizzazione al proprio ruolo CodePipeline di servizio, come mostrato inAggiunta delle autorizzazioni dal ruolo di servizio CodePipeline. Per un tutorial che mostra come usare l'opzione Full clone, vediTutorial: usa il clone completo con una sorgente di CodeCommit pipeline.

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'elemento di output di questa azione è un ZIP file che contiene il contenuto del repository e del ramo configurati al commit specificato come revisione del codice sorgente 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.

CommitId

L'ID di CodeCommit commit che ha attivato l'esecuzione della pipeline. IDsI commit sono i dati completi SHA 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.

Esempio di configurazione dell'operazione

Esempio di formato predefinito degli artefatti di output

YAML

Actions:
  - OutputArtifacts:
      - Name: Artifact_MyWebsiteStack
    InputArtifacts: []
    Name: source
    Configuration:
      RepositoryName: MyWebsite
      BranchName: main
      PollForSourceChanges: 'false'
    RunOrder: 1
    ActionTypeId:
      Version: '1'
      Provider: CodeCommit
      Category: Source
      Owner: AWS
  Name: Source

JSON

{
    "Actions": [
        {
            "OutputArtifacts": [
                {
                    "Name": "Artifact_MyWebsiteStack"
                }
            ],
            "InputArtifacts": [],
            "Name": "source",
            "Configuration": {
                "RepositoryName": "MyWebsite",
                "BranchName": "main",
                "PollForSourceChanges": "false"
            },
            "RunOrder": 1,
            "ActionTypeId": {
                "Version": "1",
                "Provider": "CodeCommit",
                "Category": "Source",
                "Owner": "AWS"
            }
        }
    ],
    "Name": "Source"
},

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 (CodeCommitrepository)— 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 AmazonEC2.