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. [Aggiungi trigger con tipi di eventi code push o pull request](pipelines-filter.md)
**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 (Bahrein), Medio Oriente (Emirati Arabi Uniti), Europa (Spagna), Europa (Zurigo), Israele (Tel Aviv) o (Stati Uniti occidentali). AWS GovCloud Per fare riferimento ad altre azioni disponibili, consulta. [Integrazioni di prodotti e servizi con CodePipeline](integrations.md) Per considerazioni su questa azione nella regione Europa (Milano), si veda la nota in[CodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite](#action-reference-CodestarConnectionSource).
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 **GitHub (tramite l'opzione provider (tramite GitHub app)** 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 **GitLab**provider 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](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-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 [Aggiungi le autorizzazioni al ruolo di servizio CodePipeline](how-to-custom-role.md#how-to-update-role-new-services).
**Nota**
Per utilizzare le connessioni in Europa (Milano) Regione AWS, devi:
Installare un'app specifica per la regione
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](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) (Abilitare una regione).
**Topics**
+ [Tipo di operazione](#action-reference-CodestarConnectionSource-type)
+ [Parametri di configurazione](#action-reference-CodestarConnectionSource-config)
+ [Input artifact (Artefatti di input)](#action-reference-CodestarConnectionSource-input)
+ [Artefatti di output](#action-reference-CodestarConnectionSource-output)
+ [Variabili di output](#action-reference-CodestarConnectionSource-variables)
+ [Autorizzazioni per i ruoli di servizio: azione CodeConnections](#edit-role-connections)
+ [Dichiarazione dell'operazione](#action-reference-CodestarConnectionSource-example)
+ [Installazione dell'app di installazione e creazione di una connessione](#action-reference-CodestarConnectionSource-auth)
+ [Consulta anche](#action-reference-CodestarConnectionSource-links)
## 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-repo`
È necessario utilizzare le maiuscole e minuscole corrette per il **FullRepositoryId**valore. 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****
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_REF` o `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, 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](troubleshooting.md#codebuild-role-connections) Per un tutorial che mostra come usare l'opzione **Full clone**, consulta. [Tutorial: usa il clone completo con una sorgente di GitHub pipeline](tutorials-github-gitclone.md)
**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 è `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](troubleshooting.md) Per un tutorial che mostra come usare l'opzione **Full clone**, consulta. [Tutorial: usa il clone completo con una sorgente di GitHub pipeline](tutorials-github-gitclone.md)
## 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).
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 per i ruoli di servizio: azione CodeConnections
Infatti CodeConnections, è richiesta la seguente autorizzazione per creare pipeline con una fonte che utilizza una connessione, come Bitbucket Cloud.
```
{
"Effect": "Allow",
"Action": [
"codeconnections:UseConnection"
],
"Resource": "resource_ARN"
},
```
[Per ulteriori informazioni sulle autorizzazioni IAM per le connessioni, consulta Connections permissions reference.](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-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`
------
#### [ 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 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.
## Consulta anche
Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.
+ [AWS::CodeStarConnections::Connection](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestarconnections-connection.html)— Il riferimento al CloudFormation modello per la risorsa AWS CodeStar Connections fornisce parametri ed esempi per le connessioni nei CloudFormation modelli.
+ [AWS CodeStarRiferimento all'API AWS CodeStar Connections](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html)*: 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 CLI`CodestarSourceConnection`. Per informazioni, consulta [Connessioni Bitbucket Cloud](connections-bitbucket.md).
+ Per GitHub GitHub Enterprise Cloud, utilizza l'opzione **GitHub**provider nella console o l'`CodestarSourceConnection`azione nella CLI. Per informazioni, consulta [GitHub connessioni](connections-github.md).
+ Per GitHub Enterprise Server, utilizzate l'opzione provider **GitHub Enterprise Server** nella console o l'`CodestarSourceConnection`azione nella CLI. Per informazioni, consulta [GitHub Connessioni Enterprise Server](connections-ghes.md).
+ Per GitLab .com, utilizza l'opzione **GitLab**provider nella console o l'`CodestarSourceConnection`azione con il `GitLab` provider nella CLI. Per informazioni, consulta [GitLabconnessioni.com](connections-gitlab.md).
+ Per visualizzare un tutorial introduttivo che crea una pipeline con un'origine Bitbucket e un' CodeBuild azione, vedi [Guida introduttiva](https://docs.aws.amazon.com/dtconsole/latest/userguide/getting-started-connections.html) 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](tutorials-github-gitclone.md)