CodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite - AWS CodePipeline
Tipo di operazioneParametri di configurazione Input artifact (Artefatti di input)Artefatti di outputVariabili di outputDichiarazione dell'operazioneInstallazione dell'app di installazione e creazione di una connessioneConsulta anche

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

CodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite

Le azioni di origine per le connessioni sono supportate da. AWS CodeConnections CodeConnections consente di creare e gestire connessioni tra AWS risorse e repository di terze parti come GitHub. Avvia una pipeline quando viene effettuato un nuovo commit su un repository di codice sorgente di terze parti. L'azione source recupera le modifiche al codice quando una pipeline viene eseguita manualmente o quando un evento webhook viene inviato dal provider di origine.

Puoi configurare le azioni nella tua pipeline per utilizzare una configurazione Git che ti consenta di avviare la pipeline con i trigger. Per configurare la configurazione dei trigger della pipeline per filtrare con i trigger, vedi maggiori dettagli in. Filtra i trigger nelle richieste push o pull di codice

Nota

Questa funzionalità non è disponibile nelle regioni Asia Pacifico (Hong Kong), Asia Pacifico (Hyderabad), Asia Pacifico (Giacarta), Asia Pacifico (Melbourne), Asia Pacifico (Osaka), Africa (Città del Capo), Medio Oriente (Bahrain), Medio Oriente (Emirati Arabi Uniti), Europa (Spagna), Europa (Zurigo), Israele (Tel Aviv) o AWS GovCloud (Stati Uniti occidentali). Per fare riferimento ad altre azioni disponibili, consulta. Integrazioni di prodotti e servizi con CodePipeline Per considerazioni su questa azione nella regione Europa (Milano), si veda la nota inCodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite.

Le connessioni possono associare AWS le tue risorse ai seguenti repository di terze parti:

  • Bitbucket Cloud (tramite l'opzione provider Bitbucket nella CodePipeline console o il provider Bitbucket nella CLI)

    Nota

    È possibile creare connessioni a un repository Bitbucket Cloud. I tipi di provider Bitbucket installati, ad esempio Bitbucket Server, non sono supportati.

  • Nota

    Se utilizzi un'area di lavoro Bitbucket, devi disporre dell'accesso come amministratore per creare la connessione.

  • GitHub ed GitHub Enterprise Cloud (tramite l'opzione provider GitHub (versione 2) nella CodePipeline console o il GitHub provider nella CLI)

    Nota

    Se il repository si trova in un' GitHub organizzazione, devi essere il proprietario dell'organizzazione per creare la connessione. Se utilizzi un repository che non fa parte di un'organizzazione, devi essere il proprietario del repository.

  • GitHub Enterprise Server (tramite l'opzione provider GitHub Enterprise Server nella CodePipeline console o il GitHub Enterprise Server provider nella CLI)

  • GitLab.com (tramite l'opzione GitLabprovider nella CodePipeline console o il GitLab provider nella CLI)

    Nota

    È possibile creare connessioni a un repository in cui si ricopre il ruolo di proprietario e quindi la connessione può essere utilizzata con il repository con risorse come. GitLab CodePipeline Per i repository nei gruppi, non è necessario essere il proprietario del gruppo.

  • Installazione gestita automaticamente per GitLab (Enterprise Edition o Community Edition) (tramite l'opzione provider GitLab autogestita nella CodePipeline console o il GitLabSelfManaged provider nella CLI)

Nota

Ogni connessione supporta tutti gli archivi che hai con quel provider. Devi solo creare una nuova connessione per ogni tipo di provider.

Le connessioni consentono alla pipeline di rilevare le modifiche alla fonte tramite l'app di installazione del provider terzo. Ad esempio, i webhook vengono utilizzati per sottoscrivere tipi di GitHub eventi e possono essere installati su un'organizzazione, un repository o un'app. GitHub La tua connessione installa un webhook di archivio sull' GitHub app che si iscrive a eventi di tipo push. GitHub

Una volta rilevata una modifica del codice, sono disponibili le seguenti opzioni per passare il codice alle operazioni successive:

  • Predefinito: come altre azioni di CodePipeline origine esistenti, CodeStarSourceConnection può generare un file ZIP con una copia superficiale del commit.

  • Clone completo: CodeStarSourceConnection può anche essere configurato per inviare un riferimento URL 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.

CodePipeline ti chiede di aggiungere l'app di installazione AWS Connector al tuo account di terze parti quando crei una connessione. È necessario aver già creato l'account e l'archivio del provider di terze parti prima di poterti connettere tramite l'azione. CodeStarSourceConnection

Nota

Per creare o allegare una policy al tuo ruolo con le autorizzazioni necessarie per utilizzare le AWS CodeStar connessioni, vedi Riferimento alle autorizzazioni di Connections. A seconda di quando è stato creato il ruolo di CodePipeline servizio, potrebbe essere necessario aggiornarne le autorizzazioni per supportare le connessioni. AWS CodeStar Per istruzioni, consulta Aggiunta delle autorizzazioni dal ruolo di servizio CodePipeline.

Nota

Per utilizzare le connessioni in Europa (Milano) Regione AWS, devi:

  1. Installare un'app specifica per la regione

  2. Abilitare la regione

Questa app specifica per la regione supporta i collegamenti nella regione Europa (Milano). È pubblicata sul sito del provider di terze parti ed è separata dall'app esistente che supporta le connessioni per altre regioni. Installando questa app, autorizzi i provider di terze parti a condividere i tuoi dati con il servizio solo per questa regione e puoi revocare le autorizzazioni in qualsiasi momento disinstallando l'app.

Il servizio non elaborerà o memorizzerà i dati a meno che tu non abiliti la Regione. Abilitando questa regione, concedi al nostro servizio le autorizzazioni per elaborare e archiviare i dati.

Anche se la regione non è abilitata, i provider di terze parti possono comunque condividere i tuoi dati con il nostro servizio se l'app specifica per la regione rimane installata, quindi assicurati di disinstallarla dopo aver disabilitato la regione. Per ulteriori informazioni, consulta Enabling a Region (Abilitare una regione).

Tipo di operazione

  • Categoria: Source

  • Proprietario: AWS

  • Provider: CodeStarSourceConnection

  • Versione: 1

Parametri di configurazione

ConnectionArn

Campo obbligatorio: sì

L'ARN della connessione configurato e autenticato per il provider di origine.

FullRepositoryId

Campo obbligatorio: sì

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

Esempio: some-user/my-repo

Importante

È necessario utilizzare le maiuscole e minuscole corrette per il FullRepositoryIdvalore. Ad esempio, se il nome utente è some-user e il nome del repository èMy-Repo, il valore consigliato di FullRepositoryIdèsome-user/My-Repo.

BranchName

Campo obbligatorio: sì

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

OutputArtifactFormat

Campo obbligatorio: no

Specifica il formato dell'artefatto di output. Può essere CODEBUILD_CLONE_REF o 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, dovrai aggiornare le autorizzazioni per il tuo ruolo di CodeBuild Project Service come mostrato in. Aggiungi le autorizzazioni per le connessioni a Bitbucket, Enterprise Server o.com CodeBuild GitClone GitHub GitHub GitLab Per un tutorial che mostra come usare l'opzione Full clone, consulta. Tutorial: usa il clone completo con una sorgente di GitHub pipeline

DetectChanges

Campo obbligatorio: no

Controlla l'avvio automatico della pipeline quando viene effettuato un nuovo commit sul repository e sul ramo configurati. Se non specificato, il valore predefinito è true e il campo non viene visualizzato per impostazione predefinita. I valori validi per questo parametro sono:

  • true: avvia CodePipeline automaticamente la pipeline con nuovi commit.

  • false: CodePipeline non avvia la pipeline con nuovi commit.

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: gli artefatti generati dal repository sono gli artefatti di output per l'operazione CodeStarSourceConnection. L'ID di commit del codice sorgente viene visualizzato CodePipeline come revisione del codice sorgente per l'esecuzione della pipeline attivata. È possibile configurare l'artefatto di output di questa operazione:

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

    • Un file JSON che contiene un riferimento URL al repository in modo che le operazioni downstream possano eseguire direttamente comandi Git.

      Importante

      Questa opzione può essere utilizzata solo dalle CodeBuild azioni a valle.

      Se scegli questa opzione, dovrai aggiornare le autorizzazioni per il tuo ruolo di CodeBuild Project Service come mostrato in. Risoluzione dei problemi CodePipeline Per un tutorial che mostra come usare l'opzione Full clone, consulta. Tutorial: usa il clone completo con una sorgente di GitHub pipeline

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

AuthorDate

La data in cui il commit è stato creato, in formato timestamp.

BranchName

Il nome del ramo per il repository in cui è stata apportata la modifica dell’origine.

CommitId

L'ID di commit che ha attivato l'esecuzione della pipeline.

CommitMessage

Il messaggio di descrizione, se presente, associato al commit che ha attivato l'esecuzione della pipeline.

ConnectionArn

L'ARN della connessione configurato e autenticato per il provider di origine.

FullRepositoryName

Il nome del repository in cui è stato effettuato il commit che ha attivato la pipeline.

Dichiarazione dell'operazione

Nell'esempio seguente, l'elemento di output è impostato sul formato ZIP predefinito CODE_ZIP per la connessione con ARN. arn:aws:codestar-connections:region:account-id:connection/connection-id

YAML
Name: Source
Actions:
  - InputArtifacts: []
    ActionTypeId:
      Version: '1'
      Owner: AWS
      Category: Source
      Provider: CodeStarSourceConnection
    OutputArtifacts:
      - Name: SourceArtifact
    RunOrder: 1
    Configuration:
      ConnectionArn: "arn:aws:codestar-connections:region:account-id:connection/connection-id"
      FullRepositoryId: "some-user/my-repo"
      BranchName: "main"
      OutputArtifactFormat: "CODE_ZIP"
    Name: ApplicationSource
JSON
{
    "Name": "Source",
    "Actions": [
        {
            "InputArtifacts": [],
            "ActionTypeId": {
                "Version": "1",
                "Owner": "AWS",
                "Category": "Source",
                "Provider": "CodeStarSourceConnection"
            },
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "RunOrder": 1,
            "Configuration": {
                "ConnectionArn": "arn:aws:codestar-connections:region:account-id:connection/connection-id",
                "FullRepositoryId": "some-user/my-repo",
                "BranchName": "main",
                "OutputArtifactFormat": "CODE_ZIP"
            },
            "Name": "ApplicationSource"
        }
    ]
},

Installazione dell'app di installazione e creazione di una connessione

La prima volta che usi la console per aggiungere una nuova connessione a un repository di terze parti, devi autorizzare CodePipeline l'accesso ai tuoi repository. È possibile selezionare o creare un'app di installazione che permette di connettersi all'account in cui è stato creato il repository di codice di terze parti.

Quando si utilizza AWS CLI o un AWS CloudFormation modello, è necessario fornire l'ARN di connessione di una connessione che è già stata sottoposta all'handshake di installazione. In caso contrario, la pipeline non viene attivata.

Nota

Per un'azione di CodeStarSourceConnection origine, non è necessario impostare un webhook o impostare come impostazione predefinita il polling. L'azione connessioni gestisce automaticamente il rilevamento delle modifiche alla fonte.

Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.

  • AWS::CodeStarConnections::Connection— Il riferimento al AWS CloudFormation modello per la risorsa AWS CodeStar Connections fornisce parametri ed esempi per le connessioni nei AWS CloudFormation modelli.

  • AWS CodeStarRiferimento all'API AWS CodeStar Connections: il riferimento all'API Connections fornisce informazioni di riferimento per le azioni di connessione disponibili.

  • Per visualizzare i passaggi per la creazione di una pipeline con azioni di origine supportate dalle connessioni, consulta quanto segue:

    • Per Bitbucket Cloud, utilizza l'opzione Bitbucket nella console o l'azione nella CLICodestarSourceConnection. Per informazioni, consulta Connessioni Bitbucket Cloud.

    • Per GitHub GitHub Enterprise Cloud, utilizza l'opzione GitHubprovider nella console o l'CodestarSourceConnectionazione nella CLI. Per informazioni, consulta GitHub connessioni.

    • Per GitHub Enterprise Server, utilizzate l'opzione provider GitHub Enterprise Server nella console o l'CodestarSourceConnectionazione nella CLI. Per informazioni, consulta GitHub Connessioni Enterprise Server.

    • Per GitLab .com, utilizza l'opzione GitLabprovider nella console o l'CodestarSourceConnectionazione con il GitLab provider nella CLI. Per informazioni, consulta GitLabconnessioni.com.

  • Per visualizzare un tutorial introduttivo che crea una pipeline con un'origine Bitbucket e un' CodeBuild azione, vedi Guida introduttiva alle connessioni.

  • Per un tutorial che mostra come connettersi a un GitHub repository e utilizzare l'opzione Full clone con un'azione a valle, consulta. CodeBuild Tutorial: usa il clone completo con una sorgente di GitHub pipeline