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à.
# Connessioni Bitbucket Cloud
Le connessioni ti consentono di autorizzare e stabilire configurazioni che associano il tuo provider di terze parti alle tue risorse. AWS Per associare il repository di terze parti come fonte per la pipeline, si utilizza una connessione.
**Nota**
Invece di creare o utilizzare una connessione esistente nel tuo account, puoi utilizzare una connessione condivisa tra un altro. Account AWS Per informazioni, consulta [Usa una connessione condivisa con un altro account](connections-shared.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.md).
Per aggiungere un'azione sorgente di Bitbucket Cloud in CodePipeline, puoi scegliere tra:
+ **Utilizza la procedura guidata di **creazione della pipeline** della CodePipeline console o la pagina **Modifica azione** per scegliere l'opzione del provider Bitbucket.** Vedi per aggiungere [Crea una connessione a Bitbucket Cloud (console)](#connections-bitbucket-console) l'azione. La console ti aiuta a creare una risorsa di connessioni.
**Nota**
È possibile creare connessioni a un repository Bitbucket Cloud. I tipi di provider Bitbucket installati, ad esempio Bitbucket Server, non sono supportati.
+ Utilizza la CLI per aggiungere la configurazione dell'azione per l'`CreateSourceConnection`azione con il `Bitbucket` provider come segue:
+ Per creare le tue risorse di connessione, consulta [Crea una connessione a Bitbucket Cloud (CLI)](#connections-bitbucket-cli) Creare una risorsa di connessione con la CLI.
+ Usa l'`CreateSourceConnection`esempio di configurazione dell'azione in [CodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite](action-reference-CodestarConnectionSource.md) per aggiungere la tua azione come mostrato in[Creazione di una pipeline (CLI)](pipelines-create.md#pipelines-create-cli).
**Nota**
Puoi anche creare una connessione utilizzando la console Developer Tools in **Impostazioni**. Vedi [Creare una connessione](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).
Prima di iniziare:
+ Devi aver creato un account con il provider del repository di terze parti, come Bitbucket Cloud.
+ Devi aver già creato un repository di codice di terze parti, ad esempio un repository Bitbucket Cloud.
**Nota**
Le connessioni Bitbucket Cloud forniscono l'accesso solo agli archivi di proprietà dell'account Bitbucket Cloud utilizzato per creare la connessione.
**Se l'applicazione viene installata in un'area di lavoro Bitbucket Cloud, sono necessarie le autorizzazioni di amministrazione dell'area di lavoro.** In caso contrario, l'opzione per installare l'app non verrà visualizzata.
**Topics**
+ [Crea una connessione a Bitbucket Cloud (console)](#connections-bitbucket-console)
+ [Crea una connessione a Bitbucket Cloud (CLI)](#connections-bitbucket-cli)
## Crea una connessione a Bitbucket Cloud (console)
Segui questi passaggi per utilizzare la CodePipeline console per aggiungere un'azione di connessione per il tuo repository Bitbucket.
**Nota**
È possibile creare connessioni a un repository Bitbucket Cloud. I tipi di provider Bitbucket installati, ad esempio Bitbucket Server, non sono supportati.
### Passaggio 1: crea o modifica la tua pipeline
**Per creare o modificare la tua pipeline**
1. Accedi alla CodePipeline console.
1. Scegliere una delle seguenti opzioni.
+ Scegli di creare una pipeline. **Segui i passaggi descritti in *Crea una pipeline* per completare la prima schermata e scegli Avanti.** Nella pagina **Source**, in **Source Provider**, scegli **Bitbucket**.
+ Scegli di modificare una pipeline esistente. Scegliete **Modifica**, quindi scegliete **Modifica fase**. Scegli di aggiungere o modificare l'azione sorgente. Nella pagina **Modifica azione**, in **Nome azione**, inserisci il nome dell'azione. Nel **provider Action**, scegli **Bitbucket**.
1. Esegui una delle seguenti operazioni:
+ In **Connessione**, se non hai già creato una connessione al tuo provider, scegli **Connetti a Bitbucket**. Procedi al passaggio 2: crea una connessione a Bitbucket.
+ In **Connessione**, se hai già creato una connessione al tuo provider, scegli la connessione. Procedi al passaggio 3: Salva l'azione di origine per la tua connessione.
### Passaggio 2: crea una connessione a Bitbucket Cloud
**Per creare una connessione a Bitbucket Cloud**
1. Nella pagina delle impostazioni **di Connect to Bitbucket**, inserisci il nome della connessione e scegli **Connetti a** Bitbucket.
Viene visualizzato il campo **App Bitbucket**.
1. In **Bitbucket apps (App Bitbucket)**, selezionare l'installazione di un'app o **Install a new app (Installa una nuova app)** per crearne una.
**Nota**
L'app viene installata una sola volta per ogni spazio di lavoro o account Bitbucket Cloud. Se hai già installato l'app Bitbucket, sceglila e vai al passaggio 4.
1. Se viene visualizzata la pagina di accesso per Bitbucket Cloud, accedi con le tue credenziali e scegli di continuare.
1. Nella pagina di installazione dell'app, un messaggio indica che l' AWS CodeStar app sta tentando di connettersi al tuo account Bitbucket.
Se si sta usando un workspace Bitbucket, modificare l'opzione **Authorize for** (Autorizza) per il workspace. Verranno visualizzati solo i workspace ai quali è possibile accedere come amministratore.
Selezionare **Grant access (Concedi accesso)**.
1. In **the connection ID for your new installation is displayed.** (App Bitbucket), viene visualizzato l'ID di connessione per la nuova installazione. Scegli **Connetti**. La connessione creata viene visualizzata nell'elenco delle connessioni.
### Passaggio 3: salva l'azione sorgente di Bitbucket Cloud
Utilizza questi passaggi nella procedura guidata o nella pagina **Modifica azione** per salvare l'azione di origine con le informazioni di connessione.
**Per completare e salvare l'azione sorgente con la connessione**
1. In **Repository name (Nome repository)**, scegliere il nome del repository di terze parti.
1. In **Trigger Pipeline** puoi aggiungere trigger se la tua azione è un'azione. CodeConnections Per configurare la configurazione dei trigger della pipeline e, facoltativamente, filtrare con i trigger, vedi maggiori dettagli in. [Aggiungi trigger con tipi di eventi code push o pull request](pipelines-filter.md)
1. In **Output artifact format (Formato artefatto di output)**, occorre scegliere il formato degli artefatti.
+ **Per memorizzare gli artefatti di output dall'azione Bitbucket Cloud utilizzando il metodo predefinito, scegli default. CodePipeline ** L'azione accede ai file dal repository Bitbucket Cloud e archivia gli artefatti in un file ZIP nel pipeline artifact store.
+ Per archiviare un file JSON contenente un riferimento URL al repository in modo che le operazioni downstream possano eseguire direttamente comandi Git, scegliere **Full clone (Clone completo)**. Questa opzione può essere utilizzata solo per azioni a valle. 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)
1. Scegli **Avanti** nella procedura guidata o **Salva** nella pagina **Modifica azione**.
## Crea una connessione a Bitbucket Cloud (CLI)
Puoi usare il AWS Command Line Interface (AWS CLI) per creare una connessione.
**Nota**
È possibile creare connessioni a un repository Bitbucket Cloud. I tipi di provider Bitbucket installati, ad esempio Bitbucket Server, non sono supportati.
Per farlo, utilizzare il comando **create-connection**.
**Importante**
Per impostazione predefinita, una connessione creata tramite AWS CLI o AWS CloudFormation è in `PENDING` stato. Dopo aver creato una connessione con la CLI o CloudFormation, utilizza la console per modificare la connessione e definirne lo stato. `AVAILABLE`
**Come creare una connessione**
1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il AWS CLI per eseguire il **create-connection** comando, specificando l'`--provider-type`e `--connection-name` per la tua connessione. In questo esempio, il nome del provider di terze parti è `Bitbucket` e il nome della connessione specificato è `MyConnection`.
```
aws codestar-connections create-connection --provider-type Bitbucket --connection-name MyConnection
```
In caso di esito positivo, questo comando restituisce informazioni dell'ARN della connessione simili alle seguenti.
```
{
"ConnectionArn": "arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. Utilizzare la console per completare la connessione. Per ulteriori informazioni, consulta [Aggiornare una connessione in sospeso.](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html)
1. Per impostazione predefinita, la pipeline rileva le modifiche al codice inviato al repository delle sorgenti di connessione. Per configurare la configurazione del trigger della pipeline per il rilascio manuale o per i tag Git, esegui una delle seguenti operazioni:
+ Per configurare la configurazione del trigger della pipeline in modo che inizi solo con una versione manuale, aggiungi la seguente riga alla configurazione:
```
"DetectChanges": "false",
```
+ Per configurare la configurazione del 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) Ad esempio, quanto segue aggiunge tag Git al livello di pipeline della definizione JSON della pipeline. In questo esempio, `release-v0` e `release-v1` sono i tag Git da includere e `release-v2` il tag Git da escludere.
```
"triggers": [
{
"providerType": "CodeStarSourceConnection",
"gitConfiguration": {
"sourceActionName": "Source",
"push": [
{
"tags": {
"includes": [
"release-v0", "release-v1"
],
"excludes": [
"release-v2"
]
}
}
]
}
}
]
```