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

Che cosa sono le connessioni?

È possibile utilizzare la funzionalità di connessione nella console Developer Tools per connettere AWS risorse, ad esempio, AWS CodePipeline a repository di codice esterni. Questa funzionalità ha una sua caratteristicaAPI, quella di AWS CodeConnections APIriferimento. Ogni connessione è una risorsa che puoi fornire ai AWS servizi per connettersi a un repository di terze parti, ad esempio BitBucket. Ad esempio, puoi aggiungere la connessione in CodePipeline modo che attivi la pipeline quando viene apportata una modifica al codice nel tuo repository di codice di terze parti. Ogni connessione è denominata e associata a un Amazon Resource Name (ARN) univoco utilizzato per fare riferimento alla connessione.

Cosa posso fare con le connessioni?

È possibile utilizzare le connessioni per integrare le risorse di fornitori di terze parti con le risorse AWS negli strumenti per sviluppatori, tra cui:

Per quali fornitori di terze parti posso creare connessioni?

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

Per una panoramica del flusso di lavoro delle connessioni, consulta Flusso di lavoro per creare o aggiornare le connessioni.

I passaggi per creare connessioni per un tipo di provider cloud, ad esempio GitHub, sono diversi dai passaggi per un tipo di provider installato, come GitHub Enterprise Server. Per le fasi di alto livello per creare una connessione in base al tipo di provider, consulta Utilizzo delle connessioni.

Cosa si Servizi AWS integra con le connessioni?

È possibile utilizzare le connessioni per integrare il repository di terze parti con i seguenti servizi Servizi AWS. Per visualizzare le integrazioni dei servizi per le connessioni, consulta Integrazioni di prodotti e servizi con AWS CodeConnections.

Come funzionano le connessioni?

Prima di poter creare una connessione, è necessario prima installare o fornire l'accesso all'app di autenticazione AWS nell'account di terze parti. Una volta installata, una connessione può essere aggiornata per utilizzare l'installazione. Quando si crea una connessione, è possibile fornire l'accesso alla risorsa AWS nel proprio account di terze parti. Ciò consente la connessione per accedere ai contenuti, come gli archivi di origine, nell'account di terze parti, per conto delle AWS risorse dell'utente. È quindi possibile condividere tale connessione con altri Servizi AWS per fornire OAuth connessioni sicure tra le risorse.

Se si desidera creare una connessione a un tipo di provider installato, ad esempio GitHub Enterprise Server, è innanzitutto necessario creare una risorsa host utilizzando il AWS Management Console.

Le connessioni sono di proprietà di chi Account AWS le crea. Le connessioni sono identificate da un ID di connessione ARN contenente. L'ID di connessione è un ID UUID che non può essere modificato o rimappato. L'eliminazione e il ripristino di una connessione comportano un nuovo ID di connessione e quindi una nuova connessione. ARN Ciò significa che le connessioni non ARNs vengono mai riutilizzate.

Una connessione appena creata si trova in uno stato Pending. È necessario un processo di handshake (OAuthflow) di terze parti per completare la configurazione della connessione e per farla passare da uno stato Pending a uno Available stato. Una volta completata questa operazione, una connessione è Available e può essere utilizzata con AWS servizi come CodePipeline.

Un host appena creato si trova in uno stato Pending. È necessario un processo di registrazione di terze parti per completare la configurazione dell'host e spostarsi da Pending a uno stato Available. Al termine di questo, un host è Available e può essere utilizzato per le connessioni ai tipi di provider installati.

Per una panoramica del flusso di lavoro delle connessioni, consulta Flusso di lavoro per creare o aggiornare le connessioni. Per una panoramica del flusso di lavoro di creazione di un host per i provider installati, consulta Flusso di lavoro per la creazione o l'aggiornamento di un host. Per le fasi di alto livello per creare una connessione in base al tipo di provider, consulta Utilizzo delle connessioni.

Risorse globali in AWS CodeConnections

Le connessioni sono risorse globali, il che significa che la risorsa viene replicata in tutte le regioni Regioni AWS.

Sebbene il ARN formato di connessione rifletta il nome della regione in cui è stata creata, la risorsa non è vincolata a nessuna regione. La regione in cui è stata creata la risorsa di connessione è la regione in cui vengono controllati gli aggiornamenti dei dati delle risorse di connessione. Esempi di API operazioni che controllano gli aggiornamenti dei dati delle risorse di connessione includono la creazione di una connessione, l'aggiornamento di un'installazione, l'eliminazione di una connessione o l'aggiunta di tag a una connessione.

Le risorse host per le connessioni non sono risorse disponibili a livello globale. Le risorse host vengono utilizzate solo nella regione in cui sono state create.

Flusso di lavoro per la creazione o l'aggiornamento di un host

Quando crei una connessione per un provider installato, è innanzitutto necessario creare un host.

Gli host possono avere i seguenti stati:

Flusso di lavoro: creazione o aggiornamento di un host con CLISDK, o AWS CloudFormation

Si utilizza CreateHostAPIper creare un host utilizzando AWS Command Line Interface (AWS CLI)SDK, o AWS CloudFormation. Dopo che è stato creato, l'host si trova in uno stato pending. Puoi completare il processo utilizzando l'opzione Configura della console.

Flusso di lavoro: creazione o aggiornamento di un host con la console

Se state creando una connessione a un tipo di provider installato, ad esempio GitHub Enterprise Server o GitLab self-managed, dovete prima creare un host. Se ci si connette a un tipo di provider cloud, ad esempio Bitbucket, si ignora la creazione dell'host e si continua a creare una connessione.

Usa la console per configurare l'host e modificarne lo stato da pending a available.

Flusso di lavoro per creare o aggiornare le connessioni

Quando si crea una connessione, è anche possibile creare o utilizzare un'installazione esistente per l'handshake di autenticazione con il provider di terze parti.

Le connessioni possono avere i seguenti stati:

Flusso di lavoro: creazione o aggiornamento di una connessione con CLISDK, o AWS CloudFormation

Si utilizza CreateConnectionAPIper creare una connessione utilizzando AWS Command Line Interface (AWS CLI)SDK, o AWS CloudFormation. Dopo che è stata creata, la connessione si trova in uno stato pending. È possibile completare il processo utilizzando l'opzione della console Set up pending connection (Configurare una connessione in attesa). La console richiede di creare un'installazione o di utilizzare un'installazione esistente per la connessione. È quindi possibile utilizzare la console per completare l'handshake e spostare la connessione in uno stato available, scegliendo Complete connection (Completa connessione) sulla console.

Flusso di lavoro: creazione o aggiornamento di una connessione con la console

Se si crea una connessione a un tipo di provider installato, ad esempio GitHub Enterprise Server, si crea innanzitutto un host. Se ci si connette a un tipo di provider cloud, ad esempio Bitbucket, si ignora la creazione dell'host e si continua a creare una connessione.

Per creare o aggiornare una connessione utilizzando la console, si utilizza la pagina di CodePipeline modifica delle azioni sulla console per scegliere il provider di terze parti. La console richiede di creare un'installazione o di utilizzare un'installazione esistente per la connessione, e quindi utilizzare la console per creare la connessione. La console completa l'handshake e sposta la connessione da pending a uno stato available automaticamente.

Come posso iniziare a usare le connessioni?

Per iniziare, ecco alcuni argomenti utili da esaminare: