View a markdown version of this page

GitHub Connessioni alle app per GitHub GitHub Enterprise Server - AWS CodeBuild
Passaggio 1: creare una connessione all' GitHub app (console)Passaggio 2: concedere l'accesso al ruolo IAM del CodeBuild progetto per utilizzare la connessioneFase 3: CodeBuild Configurare per utilizzare la nuova connessioneRisoluzione dei problemi relativi all'app GitHub

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 alle app per GitHub GitHub Enterprise Server

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 ti consente di attivare una build abbonandoti a GitHub eventi webhook using CreateWebhook o to use Tutorial: configura un CodeBuild-hosted GitHub Actions runner in CodeBuild.

Nota

CodeConnections è disponibile in un numero inferiore di aree geografiche rispetto a. CodeBuild È possibile utilizzare connessioni interregionali in CodeBuild. Le connessioni create nelle regioni opt-in 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)

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

Per creare una connessione a GitHub
Nota

Invece di creare o utilizzare una connessione esistente nel tuo account, puoi utilizzare una connessione condivisa da un altro AWS account. Per ulteriori informazioni, consulta Condividere le connessioni con AWS gli account.

Passaggio 2: concedere l'accesso al ruolo IAM del CodeBuild progetto per utilizzare la connessione

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

Per concedere l'accesso al ruolo IAM CodeBuild del progetto

  1. Crea un ruolo IAM per il tuo CodeBuild progetto seguendo le istruzioni Permetti CodeBuild di interagire con altri AWS services per il tuo CodeBuild progetto.

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

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "codeconnections:GetConnectionToken",
                "codeconnections:GetConnection"
            ],
            "Resource": [
                "arn:aws:iam::*:role/Service*"
            ]
        }
    ]
}

Fase 3: CodeBuild Configurare per utilizzare la nuova connessione

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

Console di gestione AWS
Per configurare una connessione come credenziale a livello di account nel Console di gestione AWS

  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 GitHub, scegli Gestisci le credenziali di origine predefinite.

      2. Per Tipo di credenziale, scegli GitHub App.

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

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

      1. Per Tipo di credenziale, scegli App. GitHub

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

AWS CLI
Per configurare una connessione come credenziale a livello di account nel AWS CLI

  • Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il AWS CLI per eseguire il import-source-credentials comando, specificando il--auth-type,--server-type, e --token per la tua connessione.

    Utilizza il seguente comando:

    aws codebuild import-source-credentials --auth-type CODECONNECTIONS --server-type GITHUB --token <connection-arn>

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 con l'App. GitHub

Installa AWS Connettore per GitHub app in una regione indesiderata

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

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

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

  1. Apri la CodeConnections console all'indirizzo https://console.aws.amazon.com/codesuite/settings/connections e accedi alla regione desiderata utilizzando il selettore di regione nella barra di navigazione della AWS console.

  2. Segui le istruzioni nella Guida utente di Developer Tools per creare una connessione a GitHub.

    Nota

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

La connessione all' GitHub App non ha accesso ai repository

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.

Causa possibile: 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 rivedere o modificare per configurare l'app installata. Nella sezione delle autorizzazioni, vedrai che l'app non dispone dell'autorizzazione per i webhook e c'è un'opzione per rivedere le autorizzazioni appena richieste. Rivedi e accetta le nuove autorizzazioni. Per ulteriori informazioni, consulta Approvazione delle autorizzazioni aggiornate per un'app. GitHub

Causa possibile: la connessione funzionava come previsto, ma all'improvviso non è possibile accedere ai repository.

Possibile soluzione: inizia esaminando le tue autorizzazioni e le tue installazioni, quindi verifica che l' GitHub App sia autorizzata e installata. Se l'installazione GitHub dell'App è sospesa, devi riattivarla. 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 crearne una nuova. Tieni presente che la reinstallazione dell' GitHub App non ripristinerà la connessione precedente associata alla vecchia installazione.

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

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

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

Soluzione consigliata: sebbene la creazione di una connessione UAT non richieda l'associazione della connessione all'installazione di un' GitHub app, è necessaria un'installazione affinché il repository sia accessibile. Segui le istruzioni per esaminare le installazioni per assicurarti che l' GitHub App sia installata. Se non è installata, vai alla pagina dell'GitHub App per installarla. Per ulteriori informazioni sull'accesso di UAT, vedi Informazioni sui token di accesso degli utenti.

Il AWS al ruolo IAM del servizio mancano le autorizzazioni IAM 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 al AWS servizio un ruolo IAM, il AWS servizio può utilizzare l'autorizzazione del ruolo per agire per conto dell'utente. Assicurati che il ruolo IAM disponga delle autorizzazioni necessarie. Per ulteriori informazioni sull'autorizzazione IAM necessaria, consulta Concedere l'accesso al ruolo IAM CodeBuild del progetto per utilizzare la connessione e la gestione delle identità e degli accessi per AWS CodeStar le notifiche e CodeConnections nella Guida per l'utente della console Developer Tools.