View a markdown version of this page

Crea una connessione a una rete autogestita GitLab - Console Strumenti di sviluppo
Crea una connessione a una rete GitLab autogestita (console)Crea una connessione a una rete GitLab autogestita (CLI)

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

Crea una connessione a una rete autogestita GitLab

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

È possibile utilizzare Console di gestione AWS o 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 modalità GitLab autogestita, è necessario creare un host da utilizzare per la connessione, come descritto in dettaglio 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 l'host con un VPC. Per ulteriori informazioni sulla configurazione di rete e del VPC per la risorsa host consulta i prerequisiti VPC in (Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione e Risoluzione dei problemi di configurazione VPC per l'host.

Prima di iniziare:

  • È necessario aver già creato un account con GitLab GitLab Enterprise Edition o GitLab Community Edition con un'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 ha il ruolo di Proprietario GitLab, e quindi la connessione può essere utilizzata con risorse come. 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 l'apiambito. Se la modalità amministratore è abilitata sulla tua GitLab istanza, il PAT deve includere anche l'admin_modeambito. Per ulteriori informazioni, consulta Token di accesso personali e Ambiti dei token di accesso sul sito Web. GitLab Devi essere un amministratore per creare e utilizzare il PAT.

    Nota

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

Nota

Per le organizzazioni in GitHub Enterprise Server o GitLab autogestite, non è necessario passare un host disponibile. Crei un nuovo host per ogni connessione dell'organizzazione e devi assicurarti di inserire le stesse informazioni nei campi di rete (ID VPC, ID di sottorete e ID del gruppo di sicurezza) per l'host. Per ulteriori informazioni, consulta Configurazione della connessione e dell'host per i provider installati che supportano le organizzazioni.

Crea una connessione a una rete GitLab autogestita (console)

Usa questi passaggi per creare un host e una connessione GitLab autogestita nella console. Per le considerazioni relative alla configurazione di un host in un VPC, consulta (Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione.

Nota

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

Nota

Si crea un host per una singola installazione GitLab autogestita e quindi è possibile gestire una o più connessioni GitLab autogestite a tale host.

Fase 1: Creazione dell'host

  1. Accedi a Console di gestione AWS, 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 fornitore, scegli GitLab Gestione automatica.

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

  6. Se il tuo server è configurato all'interno di un VPC Amazon e vuoi connetterti al tuo VPC, scegli Use a VPC (Utilizza un VPC). In caso contrario, scegliere No VPC (Nessun VPC).

  7. (Facoltativo) Se hai lanciato l'host in un Amazon VPC e vuoi connetterti con il VPC, scegli Utilizza un VPC e completa quanto segue.

    Nota

    Per le organizzazioni in GitHub Enterprise Server o GitLab autogestite, non si supera un host disponibile. Crei un nuovo host per ogni connessione dell'organizzazione e devi assicurarti di inserire le stesse informazioni nei campi di rete (ID VPC, ID di sottorete e ID del gruppo di sicurezza) per l'host. Per ulteriori informazioni, consulta Configurazione della connessione e dell'host per i provider installati che supportano le organizzazioni.

    1. In VPC ID (ID VPC), seleziona l'ID VPC. Assicurati di scegliere il VPC per l'infrastruttura in cui è installato l'host o un VPC con accesso all'istanza tramite VPN o Direct Connect.

    2. Se disponi di un VPC privato configurato, e l'host è stato configurato per eseguire la convalida TLS utilizzando un'autorità di certificazione non pubblica, inserisci l'ID del certificato in Certificato TLS. Il valore del Certificato TLS è 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 configurazione VPC, 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.

    Schermata della console che mostra i dettagli dell'host GitLab autogestito con l'host in stato In sospeso.
Fase 2: Configurazione dell'host in attesa

  1. Scegli Configura host.

  2. Viene visualizzata una host_name pagina di configurazione. In Fornisci un token di accesso personale, fornisci GitLab al tuo PAT l'apiambito. Se la modalità amministratore è abilitata sulla tua GitLab istanza, il PAT deve includere anche l'admin_modeambito. Per ulteriori informazioni, consulta Ambiti dei token di accesso sul GitLab sito Web.

    Nota

    Solo un amministratore può creare e utilizzare il PAT.

    Screenshot della console che mostra l'immissione del token di accesso GitLab personale per il nuovo host

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

    Schermata della console che mostra lo stato disponibile per il nuovo host
Fase 3: Creazione della connessione

  1. Accedi a Console di gestione AWS, 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.

    Screenshot della console che mostra l'opzione di connessione selezionata per la gestione automatica GitLab.

  4. In URL, immetti l'endpoint per il server.

  5. Se hai lanciato il tuo server in un VPC Amazon e vuoi connetterti con il tuo VPC, scegli Use a VPC (Utilizzo di un VPC) e completa quanto segue.

    1. In VPC ID (ID VPC), seleziona l'ID VPC. Assicurati di scegliere il VPC per l'infrastruttura in cui è installato l'host o un VPC con accesso all'host tramite VPN o 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 o Direct Connect.

    3. In Security group IDs (ID gruppo di sicurezza), scegliere Add (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 o Direct Connect.

    4. Se disponi di un VPC privato configurato, e l'host è stato configurato per eseguire la convalida TLS utilizzando un'autorità di certificazione non pubblica, inserisci l'ID del certificato in Certificato TLS. Il valore del Certificato TLS deve essere la chiave pubblica del certificato.

  6. Scegli Connetti a modalità GitLab autogestita. 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 dell'host, viene utilizzato l'URL.

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

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

  9. Viene visualizzata una pagina di autorizzazione con un messaggio che richiede l'autorizzazione alla 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 visualizzata in Nome connessione.

  11. Scegli Connetti a modalità GitLab autogestita.

    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)

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

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

Importante

Una connessione creata tramite AWS CLI o AWS CloudFormation è attiva per PENDING impostazione predefinita. Dopo aver creato una connessione con la CLI o CloudFormation, usa la console per modificare la connessione e impostarne 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). Usa il comando AWS CLI per eseguire il create-host comando, specificando --name--provider-type, e --provider-endpoint per la tua 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 esito positivo, questo comando restituisce informazioni dell'Amazon Resource Name (ARN) dell'host 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 Console di gestione AWS e apri la console degli Strumenti per sviluppatori 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. Consulta Impostare un host in attesa.

Passaggio 3: creare una connessione GitLab autogestita (CLI)

  1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il comando AWS CLI per eseguire il create-connection comando, specificando la --host-arn e --connection-name per la tua connessione.

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

    In caso di esito positivo, questo comando restituisce informazioni dell'ARN della 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: completare una connessione per la GitLab gestione automatica nella console

  1. Accedi Console di gestione AWS e apri la console degli Strumenti per sviluppatori 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.