Crea una connessione a gestione GitLab automatica

È possibile creare connessioni per GitLab Enterprise Edition o GitLab Community Edition con un'installazione gestita automaticamente.

È possibile utilizzare AWS Management Console o il AWS Command Line Interface (AWS CLI) per creare una connessione e un host per la gestione GitLab automatica.

Nota

Autorizzando questa applicazione di connessione in modalità GitLab autogestita, concedi al nostro servizio le autorizzazioni per elaborare i tuoi dati e puoi revocare le autorizzazioni in qualsiasi momento disinstallando l'applicazione.

Prima di creare una connessione a GitLab gestione automatica, è necessario creare un host da utilizzare per la connessione, come descritto in questi passaggi. 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.

Facoltativamente, puoi configurare il tuo host con un. VPC Per ulteriori informazioni sulla rete e sulla VPC configurazione della risorsa host, consulta i VPC prerequisiti in (Facoltativo) Prerequisiti: VPC configurazione di rete o Amazon per la connessione e. Risoluzione dei problemi VPC di configurazione per l'host

Prima di iniziare:

• È necessario aver già creato un account con GitLab GitLab Enterprise Edition o GitLab Community Edition con installazione autogestita. Per ulteriori informazioni, consulta https://docs.gitlab.com/ee/subscriptions/self_managed/.

  Nota

  Le connessioni forniscono l'accesso solo all'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 risorse come. GitLab CodePipeline Per i repository nei gruppi, non è necessario essere il proprietario del gruppo.

• È necessario aver già creato un token di accesso GitLab personale (PAT) con solo la seguente autorizzazione limitata: api. Per ulteriori informazioni, vedete user/profile/personal_access_tokens.html. https://docs.gitlab.com/ee/ È necessario essere un amministratore per creare e utilizzare ilPAT.

  Nota

  Il tuo PAT viene utilizzato per autorizzare l'host e non viene altrimenti archiviato o utilizzato dalle connessioni. Per configurare un host, è possibile creare un host temporaneo PAT e quindi, dopo aver configurato l'host, è possibile eliminare ilPAT.

Crea una connessione a una rete GitLab autogestita (console)

Utilizza questi passaggi per creare un host e una connessione per la GitLab gestione automatica nella console. Per considerazioni sulla configurazione di un host in aVPC, vedi. (Facoltativo) Prerequisiti: VPC configurazione di rete o Amazon per la connessione

Nota

A partire dal 1° luglio 2024, la console crea connessioni codeconnections all'interno della risorsa. ARN Le risorse con entrambi i prefissi di servizio continueranno a essere visualizzate nella console.

Nota

È possibile creare un host per una singola installazione GitLab autogestita, quindi gestire una o più connessioni GitLab autogestite a tale host.

Fase 1: Creazione dell'host

1. Accedi a AWS Management Console, quindi apri la console AWS Developer Tools all'indirizzo. https://console.aws.amazon.com/codesuite/settings/connections

2. Sulla scheda Host (Host), sceglie Create host (Crea host).

3. In Host name (Nome host), immetti il nome da utilizzare per l'host.

4. In Seleziona un provider, scegli GitLabGestione automatica.

5. In URL, inserisci l'endpoint per l'infrastruttura in cui è installato il tuo provider.

6. Se il tuo server è configurato all'interno di un Amazon VPC e desideri connetterti con il tuoVPC, scegli Usa un VPC. Altrimenti, scegli NoVPC.

7. (Facoltativo) Se hai avviato il tuo host su Amazon VPC e desideri connetterti con il tuoVPC, scegli Usa a VPC e completa quanto segue.

   1. In VPCID, scegli il tuo VPC ID. Assicurati di scegliere l'opzione VPC per l'infrastruttura in cui è installato l'host o una VPC con accesso all'istanza tramite VPN Direct Connect.

   2. Se hai una VPC configurazione privata e hai configurato l'host per eseguire la TLS convalida utilizzando un'autorità di certificazione non pubblica, nel TLScertificato inserisci l'ID del certificato. Il valore del TLS certificato è la chiave pubblica del certificato.

8. Scegli Create host (Crea host).

9. Dopo la visualizzazione della pagina dei dettagli dell'host, lo stato dell'host quando l'host viene creato.

   Nota

   Se la configurazione dell'host include una VPC configurazione, attendi alcuni minuti per il provisioning dei componenti della rete host.

   Attendi che il tuo host raggiunga uno stato Pending (In attesa) e completa l'installazione. Per ulteriori informazioni, consulta Impostare un host in attesa.

   

Fase 2: Configurazione dell'host in attesa

1. Scegli Configura host.

2. A) Configurazione host_nameviene visualizzata la pagina. In Fornisci un token di accesso personale, fornisci GitLab PAT solo le seguenti autorizzazioni ridotte:. api

   Nota

   Solo un amministratore può creare e utilizzare il. PAT

   

3. Dopo che l'host è stato registrato correttamente, viene visualizzata la pagina dei dettagli dell'host che mostra che lo stato dell'host è Available (Disponibile).

   

Fase 3: Creazione della connessione

1. Accedi a AWS Management Console, quindi apri la console AWS Developer Tools all'indirizzohttps://console.aws.amazon.com/codesuite/settings/connections.

2. Scegli Impostazioni, quindi seleziona Connessioni. Scegli Crea connessione.

3. Per creare una connessione a un GitLab repository, in Seleziona un provider, scegli Gestione GitLab automatica. In Connection name (Nome connessione), immetti il nome della connessione che desideri creare.

   

4. In URL, inserisci l'endpoint del tuo server.

5. Se hai avviato il tuo server su Amazon VPC e desideri connetterti con il tuoVPC, scegli Usa a VPC e completa quanto segue.

   1. In VPCID, scegli il tuo VPC ID. Assicurati di scegliere VPC l'infrastruttura in cui è installato l'host o una VPC con accesso all'host tramite VPN Direct Connect.

   2. In Subnet ID (ID sottorete), scegliere Add (Aggiungi). Nel campo, selezionare l'ID della sottorete che si desidera utilizzare per l'host. È possibile scegliere fino a 10 sottoreti.

      Assicurati di scegliere la sottorete per l'infrastruttura in cui è installato l'host o una sottorete con accesso all'host installato tramite VPN Direct Connect.

   3. Nel gruppo di sicurezza IDs, scegli Aggiungi. Nel campo, selezionare il gruppo di sicurezza che si desidera utilizzare per l'host. È possibile creare fino a 10 gruppi di sicurezza.

      Assicurati di scegliere il gruppo di sicurezza per l'infrastruttura in cui è installato l'host o un gruppo di sicurezza con accesso all'host installato tramite VPN Direct Connect.

   4. Se hai una VPC configurazione privata e hai configurato il tuo host per eseguire la TLS convalida utilizzando un'autorità di certificazione non pubblica, nel TLScertificato inserisci l'ID del certificato. Il valore del TLS certificato deve essere la chiave pubblica del certificato.

6. Scegli Connect to GitLab self-managed. La connessione creata viene mostrata con uno stato Pending (In attesa). Viene creata una risorsa host per la connessione con le informazioni sul server fornite. Per il nome host, URL viene utilizzato il.

7. Scegli Update pending connection (Aggiornare la connessione in attesa).

8. Quando viene GitLab visualizzata la pagina di accesso, accedi con le tue credenziali, quindi scegli Accedi.

9. Viene visualizzata una pagina di autorizzazione con un messaggio che richiede l'autorizzazione per la connessione per accedere al tuo account. GitLab

   Seleziona Authorize (Autorizza).

10. Il browser torna alla pagina della console delle connessioni. In Crea GitLab connessione, la nuova connessione viene mostrata in Nome connessione.

11. Scegli Connect to GitLab self-managed.

    Dopo che la connessione è stata creata correttamente, viene visualizzato un banner di operazione riuscita. I dettagli della connessione vengono visualizzato nella pagina Impostazioni di connessione.

Crea una connessione a una rete GitLab autogestita () CLI

Puoi usare il AWS Command Line Interface (AWS CLI) per creare un host e una connessione per la gestione GitLab automatica.

Per farlo, utilizza i comandi create-host e create-connection.

Importante

Per impostazione predefinita, una connessione creata tramite AWS CLI o AWS CloudFormation è in PENDING stato. Dopo aver creato una connessione con CLI o AWS CloudFormation, utilizza la console per modificare la connessione e definirne lo statoAVAILABLE.

Passaggio 1: creare un host per la GitLab gestione automatica () CLI

1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Utilizzate il AWS CLI per eseguire il create-host comando, specificando il --name--provider-type, e --provider-endpoint per la connessione. In questo esempio, il nome del provider di terze parti è GitLabSelfManaged e l'endpoint è my-instance.dev.

   aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"

   In caso di successo, questo comando restituisce le informazioni sull'host Amazon Resource Name (ARN) simili alle seguenti.

   {
       "HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
   }

   Dopo questo passaggio, l'host è nello stato PENDING.

2. Usa la console per completare la configurazione dell'host e sposta l'host nello stato Available nella seguente fase.

Fase 2: Configurazione di un host in attesa nella console

1. Accedi AWS Management Console e apri la console Developer Tools all'indirizzohttps://console.aws.amazon.com/codesuite/settings/connections.

2. Utilizza la console per completare la configurazione dell'host e sposta l'host nello stato Available. Per informazioni, consulta Impostare un host in attesa.

Passaggio 3: Per creare una connessione per la GitLab gestione automatica () CLI

1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Utilizzate il AWS CLI per eseguire il create-connection comando, specificando l'--host-arne --connection-name per la connessione.

   aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection

   In caso di successo, questo comando restituisce le ARN informazioni di connessione simili alle seguenti.

   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
   }

2. Usa la console per configurare la connessione in attesa nella seguente fase.

Passaggio 4: Per completare una connessione per la GitLab gestione automatica nella console

1. Accedi AWS Management Console e apri la console Developer Tools all'indirizzohttps://console.aws.amazon.com/codesuite/settings/connections.

2. Usa la console per configurare la connessione in sospeso e passarla in uno stato Available. Per ulteriori informazioni, consulta Aggiornare una connessione in attesa.