Crea una connessione a (console) GitLab.com Creare una connessione a GitLab.com (CLI)

GitLab.com connessioni

Le connessioni consentono di autorizzare e stabilire configurazioni che associano il provider di terze parti alle 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.

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 (). 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), si veda la nota inCodeStarSourceConnection per Bitbucket Cloud GitHub, GitHub Enterprise Server e GitLab azioni GitLab.com autogestite.

Per aggiungere un'azione GitLab.com sorgente in CodePipeline, puoi scegliere tra:

Utilizza la procedura guidata Crea pipeline della CodePipeline console o la pagina Modifica azione per scegliere l'opzione del GitLabprovider. Vedi Crea una connessione a (console) GitLab.com per aggiungere l'azione. La console ti aiuta a creare una risorsa di connessioni.
Utilizza la CLI per aggiungere la configurazione dell'azione per l'CreateSourceConnectionazione con il GitLab provider come segue:
- Per creare le tue risorse di connessione, consulta Creare una connessione a GitLab.com (CLI) Creare una risorsa di connessione con la CLI.
- Usa l'CreateSourceConnectionesempio di configurazione dell'azione in CodeStarSourceConnection per Bitbucket Cloud GitHub, GitHub Enterprise Server e GitLab azioni GitLab.com autogestite per aggiungere la tua azione come mostrato inCreazione di una pipeline (CLI).

Nota

Puoi anche creare una connessione utilizzando la console Developer Tools in Impostazioni. Vedi Creare una connessione.

Nota

Autorizzando l'installazione di questa connessione in GitLab.com, concedi al nostro servizio le autorizzazioni per elaborare i tuoi dati accedendo al tuo account e puoi revocare le autorizzazioni in qualsiasi momento disinstallando l'applicazione.

Prima di iniziare:

Devi aver già creato un account con. GitLab.com

Nota
Le connessioni forniscono l'accesso solo ai repository di proprietà dell'account utilizzato per creare e autorizzare la connessione.

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.
Per specificare una fonte per la tua pipeline, devi aver già creato un repository su gitlab.com.

Argomenti

Crea una connessione a (console) GitLab.com
Creare una connessione a GitLab.com (CLI)

Crea una connessione a (console) GitLab.com

Usa questi passaggi per utilizzare la CodePipeline console e aggiungere un'azione di connessione per il tuo progetto (repository) in GitLab.

Per creare o modificare la tua pipeline

Accedi alla CodePipeline console.
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 Sorgente, in Source Provider, scegli GitLab.
- Scegliete 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. In Action provider, scegli GitLab.
Esegui una delle seguenti operazioni:
- In Connessione, se non hai già creato una connessione con il tuo provider, scegli Connetti a GitLab. Procedi al passaggio 4 per creare la connessione.
- In Connessione, se hai già creato una connessione con il tuo provider, scegli la connessione. Procedi al passaggio 9.
Nota
Se si chiude la finestra pop-up prima di creare una GitLab.com connessione, è necessario aggiornare la pagina.
Per creare una connessione a un GitLab.com repository, in Seleziona un provider, scegli. GitLab In Connection name (Nome connessione), immetti il nome della connessione che desideri creare. Scegli Connect a GitLab.
Quando viene GitLab.com visualizzata la pagina di accesso, accedi con le tue credenziali, quindi scegli Accedi.
Se è la prima volta che autorizzi la connessione, viene visualizzata una pagina di autorizzazione con un messaggio che richiede l'autorizzazione per la connessione per accedere al tuo account. GitLab.com

Seleziona Authorize (Autorizza).
Il browser torna alla pagina della console delle connessioni. In Crea GitLab connessione, la nuova connessione viene mostrata in Nome connessione.
Scegli Connect a GitLab.

Verrai reindirizzato alla CodePipeline console.

Nota
Dopo aver creato correttamente una GitLab.com connessione, nella finestra principale verrà visualizzato un banner di successo.
Se non hai precedentemente effettuato l'accesso GitLab al computer corrente, dovrai chiudere manualmente la finestra pop-up.
In Repository name, scegli il nome del tuo progetto in GitLab specificando il percorso del progetto con lo spazio dei nomi. Ad esempio, per un repository a livello di gruppo, inserisci il nome del repository nel seguente formato:. group-name/repository-name Per ulteriori informazioni sul percorso e sullo spazio dei nomi, consulta il campo in #get -single-project. path_with_namespace https://docs.gitlab.com/ee/api/projects.html Per ulteriori informazioni sullo spazio dei nomi in, vedere. GitLab https://docs.gitlab.com/ee/user/namespace/

Nota
Per i gruppi in GitLab, è necessario specificare manualmente il percorso del progetto con lo spazio dei nomi. Ad esempio, per un repository denominato myrepo in un gruppomygroup, inserisci quanto segue:. mygroup/myrepo Puoi trovare il percorso del progetto con lo spazio dei nomi nell'URL in. GitLab
In Pipeline triggers 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
In Branch name (Nome ramo), scegliere il ramo in cui si desidera che la pipeline rilevi le modifiche dell'origine.

Nota
Se il nome del ramo non viene compilato automaticamente, non hai accesso come proprietario al repository. Il nome del progetto non è valido oppure la connessione utilizzata non ha accesso a. project/repository
In Output artifact format (Formato artefatto di output), occorre scegliere il formato degli artefatti.
- Per memorizzare gli elementi di output dell' GitLab.com azione utilizzando il metodo predefinito, scegliete CodePipeline default. L'azione accede ai file dal GitLab.com repository 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 da operazioni downstream di CodeBuild .
  
  Se scegli questa opzione, dovrai aggiornare le autorizzazioni per il tuo ruolo di project service come mostrato in. CodeBuild 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
Scegliete di salvare l'azione sorgente e continuate.

Creare una connessione a GitLab.com (CLI)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare una connessione.

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

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-typee --connection-name per la tua connessione. In questo esempio, il nome del provider di terze parti è GitLab e il nome della connessione specificato è MyConnection.
```
aws codestar-connections create-connection --provider-type GitLab --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"
}
```
Utilizzare la console per completare la connessione. Per ulteriori informazioni, consulta Aggiornare una connessione in sospeso.

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 Ad esempio, quanto segue si aggiunge 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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]

Convenzioni dei documenti

GitHub Connessioni Enterprise Server

Connessioni per la gestione automatica GitLab