View a markdown version of this page

GitHub Connessioni Enterprise Server - AWS CodePipeline
Creare una connessione a GitHub Enterprise Server (console)Crea un host e connettiti a GitHub Enterprise Server (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à.

GitHub Connessioni Enterprise Server

Le connessioni consentono di autorizzare e stabilire configurazioni che associano il provider di terze parti alle AWS risorse. Per associare il tuo repository di terze parti come fonte per la tua pipeline, usi una connessione.

Nota

Invece di creare o utilizzare una connessione esistente nel tuo account, puoi utilizzare una connessione condivisa tra altre. Account AWS 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 (Jakarta), Asia Pacifico (Melbourne), Asia Pacifico (Osaka), Africa (Città del Capo), Medio Oriente (Bahrain), Medio Oriente (Emirati Arabi Uniti), Europa (Spagna), Europa (Zurigo), Africa (Città del Capo), 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), vedere la nota inCodeStarSourceConnection per Bitbucket Cloud GitHub, GitHub Enterprise Server e GitLab azioni GitLab.com autogestite.

Per aggiungere un'azione sorgente di GitHub Enterprise Server in CodePipeline, puoi scegliere di:

Nota

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

Prima di iniziare:

  • È necessario aver creato un account con GitHub Enterprise Server e installato l'istanza di GitHub Enterprise Server sulla propria infrastruttura.

    Nota

    Ogni VPC può essere associato a un solo host (istanza di GitHub Enterprise Server) alla volta.

  • È necessario aver già creato un repository di codice con GitHub Enterprise Server.

Creare una connessione a GitHub Enterprise Server (console)

Usa questi passaggi per usare la CodePipeline console per aggiungere un'azione di connessione per il tuo repository GitHub Enterprise Server.

Nota

GitHub Le connessioni Enterprise Server forniscono solo l'accesso ai repository di proprietà dell'account GitHub Enterprise Server utilizzato per creare la connessione.

Prima di iniziare:

Per una connessione host a GitHub Enterprise Server, è necessario aver completato i passaggi per creare una risorsa host per la connessione. Vedi Gestire gli host per le connessioni.

Passaggio 1: crea o modifica la pipeline

Per creare o modificare la pipeline

  1. Accedi alla CodePipeline console.

  2. Scegliere una delle seguenti opzioni.

    • Scegli di creare una pipeline. Segui i passaggi descritti in Create a Pipeline per completare la prima schermata e scegliere Avanti. Nella pagina Source, in Source provider, scegli GitHub Enterprise Server.

    • Scegliete di modificare una pipeline esistente. Scegli Modifica, quindi scegli 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 GitHub Enterprise Server.

  3. Esegui una delle seguenti operazioni:

    • In Connessione, se non hai già creato una connessione con il tuo provider, scegli Connetti a GitHub Enterprise Server. Procedi al passaggio 2: creare una connessione a GitHub Enterprise Server.

    • In Connessione, se hai già creato una connessione con il tuo provider, scegli la connessione. Procedi al passaggio 3: salva l'azione sorgente per la tua connessione.

Creare una connessione a GitHub Enterprise Server

Dopo aver scelto di creare la connessione, viene visualizzata la pagina Connetti a GitHub Enterprise Server.

Importante

AWS CodeConnections non supporta la versione 2.22.0 di GitHub Enterprise Server a causa di un problema noto nella versione. Per connetterti, esegui l'aggiornamento alla versione 2.22.1 o all'ultima versione disponibile.

Per connettersi a Enterprise Server GitHub

  1. In Connection Name (Nome connessione), immetti un nome per la connessione.

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

    Nota

    Se l'URL fornito è già stato utilizzato per configurare un GitHub Enterprise Server per una connessione, verrà richiesto di scegliere l'ARN della risorsa host creata in precedenza per quell'endpoint.

  3. 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 è installata l'istanza di GitHub Enterprise Server o un VPC con accesso all'istanza di GitHub Enterprise Server 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 è installata l'istanza GitHub Enterprise Server o una sottorete con accesso all'istanza GitHub Enterprise Server installata 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 è installata l'istanza GitHub Enterprise Server o un gruppo di sicurezza con accesso all'istanza GitHub Enterprise Server installata tramite VPN o Direct Connect.

    4. Se hai configurato un VPC privato e hai configurato l'istanza di GitHub Enterprise Server per eseguire la convalida TLS utilizzando un'autorità di certificazione non pubblica, in Certificato TLS, inserisci l'ID del tuo certificato. Il valore del Certificato TLS deve essere la chiave pubblica del certificato.

      Screenshot della console che mostra la pagina di creazione di una connessione a GitHub Enterprise Server per le opzioni VPC.

  4. Scegli Connetti a GitHub Enterprise Server. 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.

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

  6. Se richiesto, nella pagina di accesso GitHub Enterprise, accedi con le tue credenziali GitHub Enterprise.

  7. Nella pagina Crea GitHub app, scegli un nome per la tua app.

  8. <app-name>Nella pagina di GitHub autorizzazione, scegli Autorizza.

  9. Nella pagina di installazione dell'app, un messaggio indica che l'app Connector è pronta per essere installata. Se disponi di più organizzazioni, potrebbe essere richiesto di scegliere l'organizzazione in cui si desidera installare l'app.

    Scegli le impostazioni del repository in cui desideri installare l'app. Scegli Installa.

  10. La pagina di connessione mostra la connessione creata in uno stato Available (Disponibile).

Passaggio 3: salva l'azione sorgente di GitHub Enterprise Server

Usa questi passaggi nella procedura guidata o nella pagina Modifica azione per salvare l'azione sorgente 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.

  2. 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 push o pull request di codice

  3. In Output artifact format (Formato artefatto di output), occorre scegliere il formato degli artefatti.

    • Per memorizzare gli artefatti di output dell'azione GitHub Enterprise Server utilizzando il metodo predefinito, scegliete default. CodePipeline L'azione accede ai file dal repository di GitHub Enterprise Server e archivia gli artefatti in un file ZIP nell'archivio degli artifact della pipeline.

    • 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 dalle azioni a valle. CodeBuild

  4. Scegli Avanti nella procedura guidata o Salva nella pagina delle azioni Modifica.

Crea un host e connettiti a GitHub Enterprise Server (CLI)

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

Per farlo, utilizzare il comando create-connection.

Importante

Una connessione creata tramite AWS CLI o AWS CloudFormation è attiva PENDING per impostazione predefinita. Dopo aver creato una connessione con la CLI o CloudFormation, usa la console per modificare la connessione e impostarne lo statoAVAILABLE.

È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare un host per le connessioni installate.

Nota

È possibile creare un host solo una volta per account GitHub Enterprise Server. Tutte le connessioni a un account GitHub Enterprise Server specifico utilizzeranno lo stesso host.

È possibile utilizzare un host per rappresentare l'endpoint per l'infrastruttura in cui è installato il provider di terze parti. Dopo aver completato la creazione dell'host con la CLI, lo stato dell'host è in sospeso. Quindi si configura o si registra l'host per portarlo allo stato Disponibile. Quando l'host sarà disponibile, completa i passaggi per creare una connessione.

Per farlo, utilizzare il comando create-host.

Importante

Per impostazione predefinita, un host creato tramite Pending lo stato AWS CLI è attivo. Dopo aver creato un host con la CLI, utilizzate la console o la CLI per configurare l'host in modo da definirne lo stato. Available

Come creare un host

  1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il 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 è GitHubEnterpriseServer e l'endpoint è my-instance.dev.

    aws codestar-connections create-host --name MyHost --provider-type GitHubEnterpriseServer --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:codestar-connections:us-west-2:account_id:host/My-Host-28aef605"
}

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

  2. Utilizza la console per completare la configurazione dell'host e sposta l'host nello stato Available.

Per creare una connessione a GitHub Enterprise Server

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

    aws codestar-connections create-connection --host-arn arn:aws:codestar-connections: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:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}

  2. Utilizzare la console per configurare la connessione in attesa.

  3. Per impostazione predefinita, la pipeline rileva le modifiche al codice inviato al repository dei sorgenti della connessione. Per configurare la configurazione del trigger della pipeline per il rilascio manuale o per i tag Git, effettuate una delle seguenti operazioni:

    • Per configurare la configurazione del trigger della pipeline in modo che inizi solo con una versione manuale, aggiungi la riga seguente alla configurazione: 

      "DetectChanges": "false",

    • Per configurare la configurazione dei trigger della pipeline per filtrare con i trigger, vedi maggiori dettagli in. Aggiungi trigger con tipi di eventi push o pull request di codice Ad esempio, quanto segue aggiunge al livello di pipeline la definizione JSON della pipeline. In questo esempio, release-v0 e release-v1 sono i tag Git da includere ed release-v2 è il tag Git da escludere.

      "triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]