Aggiungere archivi esterni in Cloud Manager external-repositories
Scopri come aggiungere un archivio esterno in Cloud Manager. Cloud Manager supporta l’integrazione con gli archivi GitHub Enterprise, GitLab e Bitbucket.
È ora possibile anche integrare gli archivi Git di Azure DevOps in Cloud Manager, con il supporto per gli archivi moderni di Azure DevOps e gli archivi VSTS (Visual Studio Team Services) legacy.
- Per chi usa Edge Delivery Services, l’archivio di cui è stato eseguito l’onboarding può essere utilizzato per sincronizzare e distribuire il codice del sito.
- Per chi usa AEM as a Cloud Service e Adobe Managed Services (AMS), l’archivio può essere collegato sia a pipeline full stack che front-end.
Configurare un archivio esterno
La configurazione di un archivio esterno in Cloud Manager consiste nei seguenti passaggi:
- Aggiungere un repository esterno a un programma selezionato
- Collegare un archivio esterno convalidato a una pipeline
- Configurare un webhook in un repository esterno.
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 Programma, 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. Seleziona il tipo di archivio in uso. Se il percorso URL dell’archivio include il nome del fornitore Git, ad esempio GitLab o Bitbucket, il tipo di archivio è già preselezionato.:
- GitHub (GitHub Enterprise e versione self-hosted di GitHub)
- GitLab (sia
gitlab.com
che la versione con hosting autonomo di GitLab) - Bitbucket (solo
bitbucket.org
- versione cloud) supportato. La versione self-hosted di Bitbucket è stata rimossa a partire dal 15 febbraio 2024. - DevOps di Azure (
dev.azure.com
)
Descrizione Facoltativo. Descrizione dettagliata dell’archivio. -
Seleziona Salva per aggiungere l’archivio.
Ora, fornisci un token di accesso per convalidare la proprietà dell’archivio esterno.
-
Nella finestra di dialogo Convalida proprietà archivio privato, fornisci un token di accesso per convalidare la proprietà dell'archivio esterno in modo da potervi accedere, quindi fai clic su Convalida.
Selezione di un token di accesso esistente per un archivio Bitbucket (solo a scopo illustrativo).
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Opzione token di accesso | 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 |
|
Dopo la convalida, l’archivio esterno è pronto per essere utilizzato e collegato a una pipeline.
Vedi anche Gestione token di accesso.
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Opzione token di accesso | 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 |
|
Dopo la convalida, l’archivio esterno è pronto per essere utilizzato e collegato a una pipeline.
Vedi anche Gestione token di accesso.
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Opzione token di accesso | 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 |
|
Dopo la convalida, l’archivio esterno è pronto per essere utilizzato e collegato a una pipeline.
Vedi anche Gestione token di accesso.
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Opzione token di accesso | 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 |
|
Dopo la convalida, l’archivio esterno è pronto per essere utilizzato e collegato a una pipeline.
Vedi anche Gestione token di accesso.
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, ad esempio GitHub Enterprise, GitLab, Bitbucket e Azure DevOps, 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, Bitbucket o Azure DevOps).
Tutti i dettagli sulla configurazione del webhook e gli eventi necessari per ogni fornitore sono disponibili in Aggiungi un repository esterno. Nel passaggio 8, vedere la tabella a schede.
-
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_key
nell'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 richiesti da Cloud Manager. Utilizza la tabella seguente per determinare gli eventi corretti per il provider Git.
table 0-row-1 1-row-1 |
---|
Eventi webhook richiesti |
Questi eventi consentono a Cloud Manager di rispondere all’attività GitHub, ad esempio la convalida di richieste pull, trigger basati su push per le pipeline o la sincronizzazione del codice Edge Delivery Services.
|
table 0-row-1 1-row-1 |
---|
Eventi webhook richiesti |
Questi eventi webhook consentono a Cloud Manager di attivare le pipeline quando il codice viene inviato o viene inviata una richiesta di unione. Tiene inoltre traccia dei commenti relativi alla convalida delle richieste pull (tramite eventi nota).
|
table 0-row-1 1-row-1 |
---|
Eventi webhook richiesti |
Questi eventi garantiscono che Cloud Manager possa convalidare le richieste pull, rispondere ai push del codice e interagire con i commenti per il coordinamento della pipeline.
|
table 0-row-1 1-row-1 |
---|
Eventi webhook e autenticazione richiesti |
Questi eventi garantiscono che Cloud Manager possa convalidare le richieste pull, rispondere ai push del codice e interagire con i commenti per il coordinamento della pipeline.
Imposta autenticazione: |
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.
Il comportamento varia a seconda del provider Git utilizzato, come descritto di seguito.
Una volta creato, il controllo viene visualizzato come nella schermata seguente. La differenza chiave rispetto a GitHub.com
è che GitHub.com
utilizza un'esecuzione di controllo, mentre GitHub Enterprise (utilizzando token di accesso personali) genera uno stato di commit:
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:
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):
Azure DevOps tiene traccia della convalida delle richieste di pull tramite controlli dello stato. Quando Cloud Manager esegue la convalida della richiesta di pull, aggiunge controlli dello stato visualizzati nell'interfaccia della richiesta di pull di Azure DevOps.
Durante la convalida della qualità del codice, un controllo dello stato indica che il processo è in corso:
Al termine della convalida della qualità del codice, il controllo dello stato viene aggiornato in modo da riflettere i risultati:
Se la convalida non riesce, vengono fornite informazioni dettagliate sull’errore nei dettagli del controllo dello stato. Puoi fare clic sul controllo dello stato per visualizzare i risultati della convalida completa in Cloud Manager.
Per i commenti e i feedback delle richieste di pull, Cloud Manager aggiunge commenti direttamente alla richiesta di pull in Azure DevOps con i dettagli di convalida e tutte le azioni necessarie richieste.
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.