Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

GitHub Connessioni alle app per GitHub GitHub Enterprise Server

Modalità Focus
GitHub Connessioni alle app per GitHub GitHub Enterprise Server - AWS CodeBuild

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

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

Puoi usare l' GitHub app per connetterti con CodeBuild. GitHub Le connessioni alle app sono supportate tramite AWS CodeConnections.

L'accesso al provider di origine consente di attivare una build CreateWebhooksottoscrivendo o GitHub eventi webhook utilizzando Tutorial: configura un GitHub Actions CodeBuild runner ospitato in CodeBuild.

Nota

CodeConnections è disponibile in un numero di regioni inferiore a. CodeBuild È possibile utilizzare connessioni interregionali in CodeBuild. Le connessioni create nelle regioni opzionali non possono essere utilizzate in altre regioni. Per ulteriori informazioni, consulta Endpoint e quote per AWS CodeConnections.

Passaggio 1: creare una connessione all' GitHub app (console)

Segui questi passaggi per utilizzare la CodeBuild console in cui aggiungere una connessione per il tuo progetto GitHub.

Per creare una connessione a GitHub

Fase 2: Concedi l'accesso al IAM ruolo del CodeBuild progetto per utilizzare la connessione

Puoi concedere l'accesso al IAM ruolo di CodeBuild progetto per utilizzare GitHub i token forniti dalla tua connessione.

Per concedere l'accesso ai ruoli CodeBuild del progetto IAM
  1. Crea un IAM ruolo per il tuo CodeBuild progetto seguendo le istruzioni Consentono CodeBuild di interagire con altri AWS servizi per il tuo CodeBuild progetto.

  2. Seguendo le istruzioni, aggiungi la seguente IAM politica al ruolo CodeBuild del tuo progetto per concedere l'accesso alla connessione.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "codeconnections:GetConnectionToken", "codeconnections:GetConnection" ], "Resource": [ <connection-arn> ] } ] }

Fase 3: Configurazione CodeBuild per l'utilizzo della nuova connessione

È possibile configurare una connessione come credenziale a livello di account e utilizzarla in un progetto.

AWS Management Console
Per configurare una connessione come credenziale a livello di account in AWS Management Console
  1. Per Provider di origine, scegli GitHub.

  2. Per Credential, effettuate una delle seguenti operazioni:

    • Scegli Credenziale di origine predefinita per utilizzare la credenziale di origine predefinita del tuo account da applicare a tutti i progetti.

      1. Se non sei connesso a GitHub, scegli Gestisci credenziali di origine predefinite.

      2. Per il tipo di credenziale, scegli GitHub App.

      3. In Connessione, scegli di utilizzare una connessione esistente o crearne una nuova.

    • Scegli Credenziale di origine personalizzata per utilizzare una credenziale di origine personalizzata per sostituire le impostazioni predefinite del tuo account.

      1. Per Tipo di credenziale, scegli App. GitHub

      2. In Connessione, scegli di utilizzare una connessione esistente o crearne una nuova.

AWS CLI
Per configurare una connessione come credenziale a livello di account in AWS CLI
  • Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Utilizzate il AWS CLI per eseguire il import-source-credentials comando, specificando il --auth-type--server-type, e --token per la connessione.

    Utilizza il seguente comando:

    aws codebuild import-source-credentials --auth-type CODECONNECTIONS --server-type GITHUB --token <connection-arn>
Per configurare una connessione come credenziale a livello di account in AWS Management Console
  1. Per Provider di origine, scegli GitHub.

  2. Per Credential, effettuate una delle seguenti operazioni:

    • Scegli Credenziale di origine predefinita per utilizzare la credenziale di origine predefinita del tuo account da applicare a tutti i progetti.

      1. Se non sei connesso a GitHub, scegli Gestisci credenziali di origine predefinite.

      2. Per il tipo di credenziale, scegli GitHub App.

      3. In Connessione, scegli di utilizzare una connessione esistente o crearne una nuova.

    • Scegli Credenziale di origine personalizzata per utilizzare una credenziale di origine personalizzata per sostituire le impostazioni predefinite del tuo account.

      1. Per Tipo di credenziale, scegli App. GitHub

      2. In Connessione, scegli di utilizzare una connessione esistente o crearne una nuova.

Puoi anche impostare più token per i tuoi CodeBuild progetti. Per ulteriori informazioni, consulta Configura più token come credenziali a livello di origine.

Risoluzione dei problemi con l'app GitHub

Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni relativi all' GitHub App.

Installa il AWS Connector per GitHub l'app in una regione indesiderata

Problema: hai installato il AWS Connector for GitHub dal GitHub Marketplace, ma la connessione è stata creata in un'area indesiderata. Se tenti di riconfigurare l'app sul GitHub sito Web, non funzionerà perché l'app è già installata sul tuo GitHub account.

Possibile causa: l'app è già installata nel tuo GitHub account, quindi puoi solo riconfigurare le autorizzazioni dell'app.

Soluzione consigliata: è possibile creare una nuova connessione con l'ID di installazione nella regione desiderata.

  1. Apri la CodeConnections console in https://console.aws.amazon.com/codesuite/impostazioni/connessioni e accedi alla regione desiderata utilizzando il selettore di regione nella barra di navigazione della AWS console.

  2. Segui le istruzioni nella Guida per l'utente degli strumenti per sviluppatori per creare una connessione a. GitHub

    Nota

    Poiché hai già installato l' GitHub app AWS Connector for, puoi sceglierlo invece di installare una nuova app.

La connessione all' GitHub app non ha accesso agli archivi

Problema: un AWS servizio che utilizza la connessione, ad esempio CodeBuild o CodePipeline, segnala di non avere accesso al repository o che il repository non esiste. Alcuni possibili messaggi di errore includono:

  • Authentication required for primary source.

  • Unable to create webhook at this time. Please try again later.

  • Failed to create webhook. GitHub API limit reached. Please try again later.

Possibile causa: potresti aver utilizzato l' GitHub app e non aver concesso l'ambito di autorizzazione del webhook.

Soluzione consigliata: per concedere l'ambito di autorizzazione richiesto, segui le istruzioni in Navigazione verso l' GitHub app che desideri esaminare o modificare per configurare l'app installata. Nella sezione Autorizzazioni, vedrai che l'app non dispone dell'autorizzazione per i webhook e che c'è un'opzione per rivedere le nuove autorizzazioni richieste. Rivedi e accetta le nuove autorizzazioni. Per ulteriori informazioni, consulta Approvazione delle autorizzazioni aggiornate per un'app. GitHub

Possibile causa: la connessione funzionava come previsto, ma all'improvviso non ha accesso ai repository.

Soluzione possibile: inizia esaminando le autorizzazioni e le installazioni, quindi verifica che l' GitHub App sia autorizzata e installata. Se l'installazione dell' GitHub App è sospesa, è necessario annullarla. Se l' GitHub App non è autorizzata per una connessione UAT(User Access Token) o non è installata per una connessione IAT(Installation Access Token), la connessione esistente non è più utilizzabile e sarà necessario creare una nuova connessione. Tieni presente che la reinstallazione GitHub dell'app non ripristinerà la connessione precedente associata alla vecchia installazione.

Soluzione possibile: se la connessione è una UAT connessione, assicurati che la connessione non venga utilizzata contemporaneamente, ad esempio in più esecuzioni CodeBuild simultanee di build. Questo perché invalida GitHub immediatamente un token emesso in precedenza UAT se un token in scadenza viene aggiornato dalla connessione. Se è necessario utilizzare la UAT connessione per più CodeBuild build simultanee, è possibile creare più connessioni e utilizzare ciascuna connessione in modo indipendente.

Soluzione possibile: se la UAT connessione non è stata utilizzata negli ultimi 6 mesi, verrà invalidata da. GitHub Per risolvere questo problema, crea una nuova connessione.

Possibile causa: potresti aver utilizzato una UAT connessione senza installare l'app.

Soluzione consigliata: sebbene la creazione di una UAT connessione non richieda l'associazione della connessione a un'installazione dell' GitHub app, è necessaria un'installazione per rendere accessibile l'archivio. Segui le istruzioni per rivedere le installazioni e assicurarti che l' GitHub app sia installata. Se non è installata, vai alla pagina dell'GitHub app per installarla. Per ulteriori informazioni sull'UATaccesso, consulta Informazioni sui token di accesso degli utenti.

Al IAM ruolo del AWS servizio mancano le IAM autorizzazioni necessarie.

Problema: viene visualizzato uno dei seguenti messaggi di errore:

  • Access denied to connection <connection-arn>

  • Failed to get access token from <connection-arn>

Soluzione consigliata: in genere si utilizza una connessione con un AWS servizio, ad esempio CodePipeline o CodeBuild. Quando si assegna un IAM ruolo al AWS servizio, il AWS servizio può utilizzare l'autorizzazione del ruolo per agire per conto dell'utente. Assicurati che il IAM ruolo disponga delle autorizzazioni necessarie. Per ulteriori informazioni sull'IAMautorizzazione necessaria, consulta Concedere l'accesso al IAM ruolo CodeBuild del progetto per utilizzare la connessione e Gestione delle identità e degli accessi per AWS CodeStar le notifiche e CodeConnections nella Guida per l'utente della console Developer Tools.

PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.