Aggiungere archivi esterni in Cloud Manager - Versione beta limitata external-repositories
Scopri come aggiungere un archivio esterno in Cloud Manager. Cloud Manager supporta l’integrazione con gli archivi GitHub, GitLab e Bitbucket.
Configurare un archivio esterno
La configurazione di un archivio esterno in Cloud Manager avviene in tre passaggi:
- Aggiungere un archivio esterno a un programma selezionato.
- Fornire un token di accesso all’archivio esterno.
- Convalida la proprietà dell’archivio GitHub privato.
Aggiungere un archivio esterno add-ext-repo
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
-
Nella console Programmi personali selezionare il programma a cui si desidera collegare un repository esterno.
-
Nel menu laterale, in Servizi, fare clic su
-
Nell’angolo superiore a destra della pagina Archivi fai clic su Aggiungi archivio.
-
Nella finestra di dialogo Aggiungi archivio, seleziona Archivio privato per collegare un archivio Git esterno al programma in uso.
-
In ciascun campo, fornisci i seguenti dettagli sull’archivio:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Campo Descrizione Nome dell’archivio Obbligatorio. Un nome espressivo per il nuovo archivio. URL dell’archivio Obbligatorio. L’URL dell’archivio.
Se utilizzi un archivio ospitato da GitHub, il percorso deve terminare in.git.
Ad esempio,https://github.com/org-name/repo-name.git(il percorso URL è solo a scopo illustrativo).
Per gli archivi esterni, è necessario utilizzare il seguente formato di percorso URL:https://git-vendor-name.com/org-name/repo-name.git
ohttps://self-hosted-domain/org-name/repo-name.git
e il fornitore Git corrispondente.Seleziona il tipo di archivio Obbligatorio. Selezionare il tipo di repository in uso:
- GitHub (GitHub Enterprise Server e versione self-hosted di GitHub)
- GitLab (sia
gitlab.comche la versione con hosting autonomo di GitLab) - Bitbucket (sia
bitbucket.orgche Bitbucket Server e la versione con hosting autonomo di Bitbucket)
Se il percorso URL dell’archivio precedente include il nome del fornitore Git, ad esempio GitLab o Bitbucket, il tipo di archivio è già preselezionato.
Descrizione Facoltativo. Descrizione dettagliata dell’archivio. -
Seleziona Salva per aggiungere l’archivio.
-
Nella finestra di dialogo Convalida della proprietà dell’archivio privato, fornisci un token di accesso per convalidare la proprietà dell’archivio esterno in modo da potervi accedere.
Selezione di un token di accesso esistente per un archivio Bitbucket.table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Tipo di token Descrizione Usa token di accesso esistente Se hai già fornito un token di accesso all’archivio per la tua organizzazione e hai accesso a più archivi, puoi selezionare un token esistente. Utilizza l’elenco a discesa Nome token per scegliere il token da applicare all’archivio. In caso contrario, aggiungi un nuovo token di accesso. Aggiungere un nuovo token di accesso Tipo di archivio: GitHub
• Nel campo di testo Nome token, digita il nome da assegnare al token di accesso che vuoi creare.
• Crea un token di accesso personale seguendo le istruzioni riportate nella documentazione GitHub.
· Per le autorizzazioni richieste, vedere Creare un nuovo PAT per GitHub.
• Incolla il token appena creato nel campo Token di accesso.Tipo di archivio: GitLab
• Nel campo di testo Nome token, digita il nome da assegnare al token di accesso che vuoi creare.
• Crea un token di accesso personale seguendo le istruzioni riportate nella documentazione GitLab.
· Per le autorizzazioni richieste, vedere Creare un nuovo PAT per GitLab.
• Incolla il token appena creato nel campo Token di accesso.Tipo di archivio: Bitbucket
• Nel campo di testo Nome token, digita il nome da assegnare al token di accesso che vuoi creare.
• Crea un token di accesso all'archivio utilizzando la documentazione Bitbucket.
· Per le autorizzazioni richieste, vedere Creare un nuovo PAT per Bitbucket.note note NOTE La funzionalità Aggiungi nuovo token di accesso è attualmente in fase di adozione anticipata. Ulteriori funzionalità sono in fase di pianificazione. Di conseguenza, le autorizzazioni necessarie per i token di accesso potrebbero cambiare. Inoltre, è possibile che l’interfaccia utente per la gestione dei token venga aggiornata, includendo eventuali funzionalità quali le date di scadenza dei token. Inoltre, potrebbero essere aggiunti controlli automatici per garantire che i token collegati agli archivi rimangano validi. -
Fai clic su Convalida.
Dopo la convalida, l’archivio esterno è pronto per essere utilizzato e collegato a una pipeline.
Collegare un archivio esterno convalidato a una pipeline validate-ext-repo
-
Aggiungi o modifica una pipeline:
- Aggiungere una pipeline di produzione
- Aggiungere una pipeline non di produzione
- Modificare una pipeline
Finestra di dialogo Aggiungi pipeline non di produzione con l’archivio selezionato e il ramo Git. -
Quando aggiungi o modifichi una pipeline, per specificare il percorso Codice sorgente per la pipeline nuova o esistente, scegli l‘archivio esterno che desideri utilizzare dall‘elenco a discesa Archivio.
-
Nell’elenco a discesa Ramo Git seleziona il ramo di origine della pipeline.
-
Fai clic su Salva.
Configurare un webhook per un archivio esterno configure-webhook
Cloud Manager consente di configurare i webhook per gli archivi Git esterni aggiunti. Vedi Aggiungere un archivio esterno. Questi webhook consentono a Cloud Manager di ricevere eventi correlati a diverse azioni all’interno della soluzione del fornitore Git.
I webhook consentono ad esempio a Cloud Manager di attivare azioni basate su eventi quali i seguenti:
- Creazione richiesta di pull (PR): avvia la funzionalità di convalida PR.
- Eventi push: avvia le pipeline quando il trigger "On Git Commit" è attivato (abilitato).
- Azioni future basate su commenti: consente flussi di lavoro, come l’implementazione diretta da un PR a un ambiente di sviluppo rapido (RDE).
La configurazione del webhook non è necessaria per gli archivi ospitati su GitHub.com perché Cloud Manager si integra direttamente tramite l'app GitHub.
Per tutti gli altri archivi esterni per i quali è stato eseguito l’onboarding con un token di accesso, come GitHub Enterprise Server, GitLab e Bitbucket, la configurazione del webhook è disponibile e deve essere impostata manualmente.
Per configurare un webhook per un repository esterno:
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
-
Nella console Programmi personali selezionare il programma in cui si desidera configurare un webhook per un archivio Git esterno.
-
Nell’angolo in alto a sinistra della pagina, fai clic sull’
-
Nel menu a sinistra, sotto l'intestazione Programma, fare clic su
-
Nella pagina Archivi, utilizzando la colonna Tipo per guidarti nella selezione, individua l'archivio desiderato, quindi fai clic sull'icona
-
Dal menu a discesa, fare clic su Webhook di configurazione.
-
Nella finestra di dialogo Webhook di configurazione eseguire le operazioni seguenti:
- Accanto al campo URL webhook, fare clic sull'icona
Incolla l’URL in un file di testo normale. L’URL copiato è necessario per le impostazioni del webhook del fornitore Git. - Accanto al campo token/chiave Segreto webhook, fai clic su Genera, quindi fai clic sull'icona
Incolla il segreto in un file di testo normale. Il segreto copiato è necessario per le impostazioni del webhook del fornitore Git.
- Accanto al campo URL webhook, fare clic sull'icona
-
Fai clic su Chiudi.
-
Passa alla soluzione del fornitore Git (GitHub Enterprise, GitLab o Bitbucket).
-
Individua la sezione Impostazioni webhook della soluzione.
-
Incolla l’URL del webhook copiato in precedenza nel campo di testo dell’URL.
-
Sostituisci il parametro di query
api_keynell'URL del webhook con la tua vera chiave API.Per generare una chiave API, devi creare un progetto di integrazione in Adobe Developer Console. Per informazioni dettagliate, consulta Creazione di un progetto di integrazione API.
-
-
Incolla il segreto del webhook copiato in precedenza nel campo di testo Segreto (o Chiave segreta, o Token segreto).
-
Configura il webhook per inviare gli eventi appropriati previsti da Cloud Manager.
Tutti i dettagli sulla configurazione del webhook e gli eventi richiesti per ciascun fornitore sono disponibili al seguente indirizzo:
Convalida delle richieste pull con webhook
Una volta configurati correttamente i webhook, Cloud Manager attiva automaticamente le esecuzioni della pipeline o i controlli di convalida PR per l’archivio.
Si applicano i seguenti comportamenti:
-
Server GitHub Enterprise
Una volta creato, il controllo viene visualizzato come nella schermata seguente. La differenza chiave rispetto a
GitHub.comè cheGitHub.comutilizza un'esecuzione di controllo, mentre GitHub Enterprise Server (che utilizza token di accesso personali) genera uno stato di commit:
-
Bitbucket
Quando la convalida della qualità del codice è in esecuzione:
Utilizza lo stato del commit per tenere traccia dell'avanzamento della convalida PR. Nel caso seguente, la schermata mostra cosa accade quando una convalida della qualità del codice non riesce a causa di un problema del cliente. Viene aggiunto un commento con informazioni dettagliate sull’errore e viene creato un controllo del commit che mostra l’errore (visibile a destra):
-
GitLab
Le interazioni GitLab si basano esclusivamente sui commenti. Quando inizia la convalida, viene aggiunto un commento. Al termine della convalida (riuscita o non riuscita), il commento iniziale viene rimosso e sostituito con un nuovo commento contenente i risultati della convalida o i dettagli dell’errore.
Quando la convalida della qualità del codice è in esecuzione:
Al termine della convalida della qualità a freddo:
Quando la convalida della qualità del codice non riesce e viene restituito un errore:
Quando la convalida della qualità del codice non riesce a causa di problemi del cliente:
Risoluzione dei problemi del webhook
- Accertati che l’URL del webhook includa una chiave API valida.
- Controlla che gli eventi del webhook siano configurati correttamente nelle impostazioni del fornitore Git.
- Se la convalida PR o i trigger della pipeline non funzionano, verifica che il segreto webhook sia aggiornato sia in Cloud Manager che nel fornitore Git.
Limitazioni
- Gli archivi esterni non possono essere collegati alle pipeline di configurazione.
- Le pipeline con archivi esterni (non ospitati su GitHub) e il trigger "On Git Changes" (In caso di modifiche Git) non si avviano automaticamente. Possono essere avviati solo manualmente.