Integrazione con CodeDeploy GitHub

CodeDeploy supporta GitHub, un servizio di hosting e condivisione di codice basato sul Web. CodeDeploy può distribuire le revisioni delle applicazioni archiviate in GitHub repository o bucket Amazon S3 sulle istanze. CodeDeploy supporta solo le implementazioni EC2/on-premise. GitHub

Distribuzione delle revisioni da CodeDeploy GitHub

Per distribuire una revisione dell'applicazione da un GitHub repository alle istanze:

1. Crea una revisione compatibile con CodeDeploy il tipo di istanza Amazon EC2 su cui effettuerai la distribuzione.

   Per creare una revisione compatibile, seguire le istruzioni in Pianifica una revisione per CodeDeploy e Aggiungere un file di specifiche dell'applicazione a una revisione per CodeDeploy.

2. Usa un GitHub account per aggiungere la revisione a un repository. GitHub

   Per creare un GitHub account, vedi Join. GitHub Per creare un GitHub repository, consulta Creare un repository.

3. Utilizza la pagina Crea distribuzione nella CodeDeploy console o il AWS CLI create-deployment comando per distribuire la revisione dal GitHub repository alle istanze di destinazione configurate per l'uso nelle distribuzioni. CodeDeploy

   Se desideri chiamare il create-deployment comando, devi prima utilizzare la pagina Crea distribuzione della console per CodeDeploy autorizzare l'interazione con GitHub l'account preferito GitHub per l'applicazione specificata. Dovrai eseguire questa operazione una sola volta per ogni applicazione.

   Per informazioni su come utilizzare la pagina Crea distribuzione per la distribuzione da un GitHub repository, consulta. Crea una distribuzione con CodeDeploy

   Per informazioni su come chiamare il create-deployment comando per la distribuzione da un GitHub repository, consulta. Crea un'implementazione della piattaforma di elaborazione (CLI) EC2/on-premise

   Per informazioni su come preparare le istanze da utilizzare nelle CodeDeploy distribuzioni, consulta. Utilizzo delle istanze per CodeDeploy

Per ulteriori informazioni, consulta Tutorial: utilizzare CodeDeploy per distribuire un'applicazione da GitHub.

GitHub comportamenti con CodeDeploy

Argomenti

• GitHub autenticazione con applicazioni in CodeDeploy
• CodeDeploy interazione con archivi privati e pubblici GitHub
• CodeDeploy interazione con gli archivi gestiti dall'organizzazione GitHub
• Implementa automaticamente da CodePipeline con CodeDeploy

GitHub autenticazione con applicazioni in CodeDeploy

Dopo aver concesso CodeDeploy l'autorizzazione all'interazione GitHub, l'associazione tra l' GitHub account e l'applicazione viene archiviata in CodeDeploy. È possibile collegare l'applicazione a un altro GitHub account. Puoi anche revocare l'autorizzazione CodeDeploy all'interazione con. GitHub

Per collegare un GitHub account a un'applicazione in CodeDeploy

1. Accedi AWS Management Console e apri la CodeDeploy console all'indirizzo https://console.aws.amazon.com/codedeploy.

   Nota

   Accedi con lo stesso utente che hai configuratoGuida introduttiva con CodeDeploy.

2. Nel riquadro di navigazione, espandi Distribuisci, quindi scegli Applicazioni.

3. Scegli l'applicazione che desideri collegare a un altro GitHub account.

4. Se l'applicazione non dispone di un gruppo di distribuzione, scegli Crea gruppo di distribuzione per crearne uno. Per ulteriori informazioni, consulta Crea un gruppo di distribuzione con CodeDeploy. Un gruppo di distribuzione deve scegliere Create deployment (Crea distribuzione) nella fase successiva.

5. Da Deployments (Distribuzioni), scegli Create deployment (Crea distribuzione).

   Nota

   Non è necessario creare una nuova distribuzione. Questo è attualmente l'unico modo per collegare un GitHub account diverso a un'applicazione.

6. Nelle impostazioni di distribuzione, per Tipo di revisione, scegli La mia applicazione è archiviata in GitHub.

7. Esegui una di queste operazioni:

   • Per creare una connessione per AWS CodeDeploy le applicazioni a un GitHub account, esci da una scheda separata del browser web. GitHub In Nome GitHub token, digita un nome per identificare la connessione, quindi scegli Connetti a GitHub. La pagina Web richiede l'autorizzazione CodeDeploy all'interazione con GitHub l'applicazione. Continuare con la fase 10.

   • Per utilizzare una connessione già creata, in Nome GitHub token, selezionane il nome, quindi scegli Connetti a GitHub. Continuare con la fase 8.

   • Per creare una connessione a un altro GitHub account, esci da una scheda separata del browser web. GitHub In Nome GitHub token, digita un nome per identificare la connessione, quindi scegli Connetti a GitHub. La pagina Web richiede l'autorizzazione CodeDeploy all'interazione con GitHub l'applicazione. Continuare con la fase 10.

8. Se non hai già effettuato l'accesso GitHub, segui le istruzioni nella pagina di accesso per accedere con l' GitHub account a cui desideri collegare l'applicazione.

9. Scegli Autorizza applicazione. GitHub dà CodeDeploy il permesso di interagire con GitHub l' GitHub account con cui è stato effettuato l'accesso all'applicazione selezionata.

10. Se non si desidera creare una distribuzione, scegliere Cancel (Annulla).

Per revocare l'autorizzazione all'interazione con CodeDeploy GitHub

1. Accedi GitHub utilizzando le credenziali per l' GitHub account in cui desideri revocare l'autorizzazione. AWS CodeDeploy

2. Apri la pagina GitHub Applicazioni, CodeDeployindividua nell'elenco delle applicazioni autorizzate, quindi segui la GitHub procedura per revocare l'autorizzazione per un'applicazione.

CodeDeploy interazione con archivi privati e pubblici GitHub

CodeDeploy supporta la distribuzione di applicazioni da GitHub archivi privati e pubblici. Quando CodeDeploy autorizzi l'accesso per tuo GitHub conto, CodeDeploy avrai accesso in lettura e scrittura a tutti gli GitHub archivi privati a cui ha accesso il tuo GitHub account. Tuttavia, legge CodeDeploy solo dai repository. GitHub Non scriverà su nessuno dei tuoi repository privati GitHub .

CodeDeploy interazione con gli archivi gestiti dall'organizzazione GitHub

Per impostazione predefinita, gli GitHub archivi gestiti da un'organizzazione (a differenza degli archivi privati o pubblici dell'account) non concedono l'accesso ad applicazioni di terze parti, tra cui. CodeDeploy La distribuzione avrà esito negativo se le restrizioni relative alle applicazioni di terze parti di un'organizzazione sono abilitate GitHub e si tenta di distribuire codice dal relativo repository. GitHub Ci sono due modi per risolvere questo problema.

• In qualità di membro dell'organizzazione, puoi chiedere al proprietario dell'organizzazione di approvare l'accesso a. CodeDeploy I passaggi per richiedere questo accesso dipendono dal fatto che tu abbia già autorizzato CodeDeploy il tuo account individuale:

  • Se disponi dell'accesso autorizzato a CodeDeploy nel tuo account, vedi Richiesta dell'approvazione dell'organizzazione per le applicazioni autorizzate.

  • Se non hai ancora autorizzato l'accesso al CodeDeploy tuo account, vedi Richiesta dell'approvazione dell'organizzazione per le applicazioni di terze parti.

• Il proprietario dell'organizzazione può disabilitare tutte le restrizioni delle applicazioni di terze parti per l'organizzazione. Per informazioni, consulta Disattivazione delle restrizioni relative alle applicazioni di terze parti per l'organizzazione.

Per ulteriori informazioni, consulta Informazioni sulle restrizioni delle applicazioni di terze parti.

Implementa automaticamente da CodePipeline con CodeDeploy

È possibile attivare una distribuzione da un CodePipeline ogni volta che il codice sorgente cambia. Per ulteriori informazioni, consulta CodePipeline.