Aggiungere archivi privati in Cloud Manager private-repositories
Scopri come configurare Cloud Manager per l’utilizzo di archivi GitHub privati.
Panoramica overview
La configurazione di Cloud Manager con gli archivi GitHub privati consente di convalidare il codice direttamente in GitHub, eliminando la necessità di sincronizzarsi frequentemente con l’archivio Adobe.
Configurazione configuration
La configurazione consiste di due passaggi principali:
Aggiungere un archivio add-repo
-
In Cloud Manager, nella pagina Panoramica programma, fai clic sulla scheda Archivi per passare alla pagina Archivi e fai clic su Aggiungi archivio.
-
Nella finestra di dialogo Aggiungi archivio, seleziona Archivio privato come tipo di archivio.
-
Specifica i dettagli dell’archivio
- Nome archivio: un nome espressivo
- URL archivio: l’URL dell’archivio, che deve terminare con
.git
- Descrizione (facoltativa): una descrizione più lunga dell’archivio in base alle esigenze
-
Fai clic su Salva.
Convalidare la proprietà di un archivio privato validate-ownership
Cloud Manager ora è a conoscenza del tuo archivio GitHub, ma deve ancora accedervi. Per concedere l’accesso, devi installare l’app Adobe GitHub e verificare di essere il proprietario dell’archivio specificato.
-
Dopo aver aggiunto l’archivio personale, viene visualizzata la finestra di dialogo Convalida della proprietà dell’archivio privato.
-
Cloud Manager utilizza un’app GitHub per interagire in modo sicuro con l’archivio.
Un proprietario dell’organizzazione GitHub deve installare l’app che si trova in
https://github.com/apps/cloud-manager-for-aem
e concedere l’accesso all’archivio. Per ulteriori informazioni, consulta la documentazione GitHub. -
Per una maggiore sicurezza, crea un file segreto nel ramo predefinito dell’archivio. Fai clic su Genera.
-
Conferma la generazione del file segreto facendo clic su Conferma.
-
Nella finestra di dialogo Convalida della proprietà dell’archivio privato, Cloud Manager ha generato il contenuto nel campo Contenuto del file segreto. Copia il contenuto da quel campo.
Il contenuto del file segreto verrà visualizzato una sola volta. Se non copi il contenuto prima di chiudere questa finestra, dovrai rigenerare il file segreto.
-
Crea un nuovo file nel ramo predefinito dell’archivio GitHub denominato
.well-known/adobe/cloud-manager-challenge
e incolla il contenuto del file segreto in tale file e salvalo. -
Una volta installata l’app e il file segreto è presente nell’archivio, puoi fare clic su Convalida nella finestra di dialogo Convalida della proprietà dell’archivio privato.
L’app può essere installata e puoi generare un file segreto in qualsiasi ordine. Tuttavia, entrambi i passaggi devono essere completati prima di poter eseguire la convalida.
Fino alla convalida, l’archivio viene elencato con un’icona rossa, che indica che non è ancora stato convalidato e non può ancora essere utilizzato.
Tieni presente che la colonna Tipo identifica facilmente gli archivi forniti da Adobe (Adobe) e i tuoi archivi GitHub (GitHub).
Per tornare all’archivio in un secondo momento e completare la convalida, passa alla pagina Archivi. Fai clic sul pulsante con i puntini di sospensione accanto all’archivio GitHub aggiunto e seleziona Convalida proprietà dal menu a discesa.
Utilizzo di archivi privati con Cloud Manager using
Dopo la convalida dell’archivio GitHub in Cloud Manager, l’integrazione è completata e puoi utilizzare l’archivio con Cloud Manager.
Per utilizzare gli archivi privati con Cloud Manager:
-
Quando crei una richiesta pull, viene avviata automaticamente una verifica GitHub.
-
Per ogni richiesta pull, verrà creata automaticamente una pipeline di qualità del codice full stack. Tale pipeline viene avviata ogni volta che la richiesta pull viene aggiornata.
-
La verifica GitHub rimane in esecuzione fino al completamento dei controlli di qualità del codice. I risultati di qualità del codice sono propagati quindi alla verifica GitHub.
Quando la richiesta pull viene chiusa o unita, la pipeline di qualità del codice full-stack creata viene eliminata automaticamente.
Associazione di archivi privati alle pipeline pipelines
Gli archivi privati convalidati possono essere associati a pipeline full-stack e front-end.
Limitazioni limitations
Quando si utilizzano archivi privati con Cloud Manager si applicano determinate limitazioni.
- Le pipeline a livello web e di configurazione non sono supportate con gli archivi privati.
- Quando si utilizzano archivi privati su pipeline di produzione full stack, non viene creato e né inviato alcun tag Git.
- Se l’app GitHub di Adobe viene rimossa dall’organizzazione GitHub, la funzione di convalida delle richieste pull verrà rimossa per tutti gli archivi.
- Le pipeline che utilizzano archivi privati e il trigger di creazione su conferma non vengono avviate automaticamente quando viene eseguito il push di una nuova conferma nel ramo selezionato.
- La funzionalità di riutilizzo degli artefatti non si applica agli archivi privati.
- Non puoi mettere in pausa la convalida della richiesta pull tramite la verifica GitHub di Cloud Manager. Se l’archivio GitHub viene convalidato in Cloud Manager, Cloud Manager tenta di convalidare le richieste pull create per quell’archivio.