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, GitHub Enterprise Server e GitLab azioni GitLab.com 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, ad esempio 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 pipeline per utilizzare una configurazione Git che ti consenta di avviare la pipeline con trigger. Per configurare la configurazione dei trigger della pipeline per filtrare con i trigger, vedi maggiori dettagli in. Aggiungi trigger con tipi di eventi push o pull request di codice
Nota
Questa funzionalità non è disponibile nelle regioni Asia Pacifico (Hong Kong), Asia Pacifico (Hyderabad), Asia Pacifico (Jakarta), Asia Pacifico (Melbourne), Asia Pacifico (Osaka), Africa (Città del Capo), Medio Oriente (Bahrain), Medio Oriente (Emirati Arabi Uniti), Europa (Spagna), Europa (Zurigo), Africa (Città del Capo), Israele (Tel Aviv) o AWS GovCloud (US-West). Per fare riferimento ad altre azioni disponibili, consulta. Integrazioni di prodotti e servizi con CodePipeline Per considerazioni su questa azione nella Regione Europa (Milano), vedere la nota inCodeStarSourceConnection per Bitbucket Cloud GitHub, GitHub Enterprise Server e GitLab azioni GitLab.com autogestite.
Le connessioni possono associare AWS le tue risorse ai seguenti repository di terze parti:
-
Bitbucket Cloud (tramite l'opzione Bitbucket provider nella CodePipeline console o il provider nella CLI
Bitbucket)Nota
È possibile creare connessioni a un repository Bitbucket Cloud. I tipi di provider Bitbucket installati, ad esempio Bitbucket Server, non sono supportati.
-
Nota
Se stai usando uno spazio di lavoro Bitbucket, devi avere l'accesso come amministratore per creare la connessione.
-
GitHub ed GitHub Enterprise Cloud (tramite l'opzione del provider GitHub (tramite GitHub App) nella CodePipeline console o il
GitHubprovider nella CLI)Nota
Se il tuo repository si trova in un' GitHub organizzazione, devi essere il proprietario dell'organizzazione per creare la connessione. Se si utilizza un repository che non si trova in un'organizzazione, è necessario esserne il proprietario.
-
GitHub Enterprise Server (tramite l'opzione GitHub Enterprise Server provider nella CodePipeline console o il
GitHub Enterprise Serverprovider nella CLI) -
GitLab.com (tramite l'opzione GitLab provider nella CodePipeline console o il
GitLabprovider nella CLI)Nota
È possibile creare connessioni a un repository in cui si ha il ruolo di Proprietario GitLab, quindi la connessione può essere utilizzata con il repository con risorse come. CodePipeline Per i repository nei gruppi, non è necessario essere il proprietario del gruppo.
-
Self-managed installazione per GitLab (Enterprise Edition o Community Edition) (tramite l'opzione del provider GitLab autogestito nella CodePipeline console o il
GitLabSelfManagedprovider nella CLI)
Nota
Ogni connessione supporta tutti i repository di cui disponi con quel provider. È sufficiente 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 di terze parti. Ad esempio, i webhook vengono utilizzati per iscriversi a tipi di GitHub eventi e possono essere installati su un'organizzazione, un repository o un'app. GitHub La tua connessione installa un webhook di repository sulla tua GitHub app che si iscrive agli eventi di tipo push. GitHub
Una volta rilevata una modifica del codice, sono disponibili le seguenti opzioni per passare il codice alle operazioni successive:
-
Impostazione predefinita: come altre azioni CodePipeline sorgente esistenti,
CodeStarSourceConnectionpuò generare un file ZIP con una copia superficiale del commit. -
Clone completo:
CodeStarSourceConnectionpuò anche essere configurato per generare 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 delle CodeBuild non-azioni genera un errore.
CodePipeline ti chiede di aggiungere l'app di installazione di AWS Connector al tuo account di terze parti quando crei una connessione. È necessario aver già creato l'account e il repository del provider di terze parti prima di potersi 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 l’argomento Aggiungi le autorizzazioni al ruolo del servizio CodePipeline.
Nota
Per utilizzare le connessioni in Europa (Milano) Regione AWS, devi:
-
Installa un' Region-specific app
-
Abilitare la regione
Questa Region-specific app supporta le connessioni 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 fornitori di terze parti possono comunque condividere i tuoi dati con il nostro servizio se l' Region-specific app rimane installata, quindi assicurati di disinstallare l'app dopo aver disabilitato la Regione. Per ulteriori informazioni, consulta Abilitare una regione.
Argomenti
Tipo di operazione
-
Categoria:
Source -
Proprietario:
AWS -
Provider:
CodeStarSourceConnection -
Versione:
1
Parametri di configurazione
- ConnectionArn
-
Obbligatorio: sì
L'ARN della connessione configurato e autenticato per il provider di origine.
- FullRepositoryId
-
Obbligatorio: sì
Il proprietario e il nome del repository in cui devono essere rilevate le modifiche di origine.
Ad esempio:
some-user/my-repoImportante
È necessario utilizzare le maiuscole e minuscole per il FullRepositoryId valore. Ad esempio, se il nome utente è
some-usere il nome del repository èMy-Repo, il valore consigliato FullRepositoryId èsome-user/My-Repo. - BranchName
-
Obbligatorio: sì
Il nome del ramo in cui devono essere rilevate le modifiche di origine.
- OutputArtifactFormat
-
Obbligatorio: no
Specifica il formato dell'artefatto di output. Può essere
CODEBUILD_CLONE_REFoCODE_ZIP. Se non altrimenti specificato, l'impostazione predefinita èCODE_ZIP.Importante
L'opzione
CODEBUILD_CLONE_REFpuò essere utilizzata solo da operazioni downstream di CodeBuild.Se scegli questa opzione, dovrai aggiornare le autorizzazioni per il tuo ruolo di servizio di CodeBuild progetto, come mostrato in. CodeBuild GitClone Aggiungi le GitHub autorizzazioni GitHub per le connessioni a Bitbucket, Enterprise Server o GitLab.com Per un tutorial che mostra come utilizzare l'opzione Full clone, consulta. Tutorial: Usa un clone completo con una fonte di GitHub pipeline
- DetectChanges
-
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 è
truee il campo non viene visualizzato per impostazione predefinita. I valori validi per questo parametro sono:-
true: avvia CodePipeline automaticamente la pipeline in caso di nuovi commit. -
false: CodePipeline non avvia la pipeline su 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 di origine 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 servizio di CodeBuild progetto, come mostrato in. Risoluzione dei problemi CodePipeline Per un tutorial che mostra come utilizzare l'opzione Full clone, consulta. Tutorial: Usa un clone completo con una fonte 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 Riferimento alle variabili.
- 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.
Autorizzazioni relative ai ruoli di servizio: azione CodeConnections
Perché CodeConnections, è necessaria la seguente autorizzazione per creare pipeline con una fonte che utilizza una connessione, come Bitbucket Cloud.
{ "Effect": "Allow", "Action": [ "codeconnections:UseConnection", "codestar-connections:UseConnection" ], "Resource": "resource_ARN" },
Nota
Entrambe le azioni sono obbligatorie. Operazioni richiamate tramite chiamatacodestar-connections:UseConnection, mentre operazioni richiamate al di fuori della chiamata. codeconnections:UseConnection La concessione di entrambe le azioni garantisce che il ruolo funzioni per entrambi i percorsi di codice, indipendentemente dal fatto che l'ARN della risorsa della connessione utilizzi il prefisso del codeconnections servizio or. codestar-connections
Per ulteriori informazioni sulle autorizzazioni IAM per le connessioni, vedi Riferimento alle autorizzazioni di Connections.
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
Installazione dell'app di installazione e creazione di una connessione
La prima volta che utilizzi 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 un CloudFormation modello AWS CLI o, è necessario fornire l'ARN di connessione di una connessione che ha già superato l'handshake di installazione. In caso contrario, la pipeline non viene attivata.
Nota
Per un'azione CodeStarSourceConnection sorgente, non è necessario impostare un webhook o utilizzare di default il polling. L'azione connections gestisce automaticamente il rilevamento delle modifiche all'origine.
Consulta anche
Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.
-
AWS::CodeStarConnections: :Connection — Il riferimento al CloudFormation modello per la risorsa AWS CodeStar Connections fornisce parametri ed esempi per le connessioni nei CloudFormation modelli.
-
AWS CodeStarConnections API Reference: il AWS CodeStar Connections API Reference fornisce informazioni di riferimento per le azioni di connessione disponibili.
-
Per visualizzare i passaggi per creare una pipeline con le azioni di origine supportate dalle connessioni, vedete quanto segue:
-
Per Bitbucket Cloud, usa l'opzione Bitbucket nella console o l'azione nella CLI
CodestarSourceConnection. Consulta Connessioni Bitbucket Cloud. -
Per Enterprise Cloud GitHub e GitHub Enterprise Cloud, usa l'opzione GitHub provider nella console o l'azione nella CLI
CodestarSourceConnection. Consulta GitHub connessioni. -
Per GitHub Enterprise Server, usa l'opzione del provider GitHub Enterprise Server nella console o l'
CodestarSourceConnectionazione nella CLI. Consulta GitHub Connessioni Enterprise Server. -
Per GitLab.com, usa l'opzione GitLab provider nella console o l'
CodestarSourceConnectionazione con ilGitLabprovider nella CLI. Consulta GitLab.com connessioni.
-
-
Per visualizzare un tutorial introduttivo che crea una pipeline con un codice sorgente Bitbucket e un' CodeBuild azione, vedi Guida introduttiva alle connessioni.
-
Per un tutorial che ti mostra come connetterti a un GitHub repository e utilizzare l'opzione Full clone con un'azione downstream, vedi. CodeBuild Tutorial: Usa un clone completo con una fonte di GitHub pipeline