Aggiungere un archivio GitHub privato in Cloud Manager private-repositories
Configurando Cloud Manager per l’integrazione con gli archivi GitHub privati, puoi convalidare il codice direttamente all’interno di GitHub utilizzando Cloud Manager. Questa configurazione elimina la necessità di sincronizzare regolarmente il codice con l’archivio di Adobi.
Configurazione configuration
La configurazione di un archivio GitHub privato in Cloud Manager consiste di due passaggi:
- Aggiungere un archivio GitHub privato a un programma selezionato.
- Quindi, convalida la proprietà dell'archivio GitHub privato.
Aggiungere un archivio GitHub privato a un programma add-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 archivio Git privato.
-
Nel menu laterale, in Servizi, seleziona Archivi.
-
Nell'angolo superiore destro della pagina Archivi fare clic su Aggiungi archivio.
-
Nella finestra di dialogo Aggiungi archivio, seleziona Archivio privato come tipo di archivio.
-
In ciascun campo, fornisci i seguenti dettagli sull’archivio:
table 0-row-2 1-row-2 2-row-2 3-row-2 Campo Descrizione Nome archivio Un nome espressivo per il nuovo archivio. URL archivio URL dell'archivio privato, che deve terminare in .git
.
Ad esempio,https://github.com/org-name/repo-name.git
(il percorso URL è solo a scopo illustrativo).Descrizione (facoltativo) Descrizione dettagliata dell’archivio. -
Seleziona Salva.
Ora puoi convalidare la proprietà dell'archivio privato.
Convalidare la proprietà di un archivio GitHub 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.
Per convalidare la proprietà di un archivio GitHub privato:
-
Dopo aver aggiunto il tuo archivio, segui i passaggi rimanenti nella finestra di dialogo Convalida proprietà archivio privato.
table 0-row-2 1-row-2 2-row-2 Descrizione Passaggio 1: app GitHub Cloud Manager utilizza un’app GitHub per interagire con l’archivio privato in modo sicuro.
· Un proprietario dell'organizzazione GitHub deve installare l'app che si trova inhttps://github.com/apps/cloud-manager-for-aem
e concedere l'accesso all'archivio.
· Per informazioni dettagliate sull'installazione e sulla concessione dell'accesso, vedere la documentazione di GitHub.Passaggio 2: file segreto Per migliorare la protezione, è necessario creare un file segreto nel ramo predefinito dell’archivio.
· Fare clic su Genera, quindi su Conferma. Cloud Manager genera il contenuto del file privato nel campo di testo Contenuto file segreto.
· Fare clic sull'icona per copiare il contenuto da tale campo. Il contenuto del file segreto verrà visualizzato una sola volta. Se non copiate il contenuto prima di chiudere questa finestra di dialogo, rigenerate il segreto. -
Crea un nuovo file nel ramo predefinito dell’archivio GitHub denominato:
.well-known/adobe/cloud-manager-challenge
-
Incolla il contenuto del file segreto nel nuovo file appena creato e salvalo.
Una volta installata l’app e che il file segreto esiste nell’archivio, continua il passaggio.
-
Nella finestra di dialogo Convalida proprietà repository privato, fare clic su Convalida.
L’app può essere installata e un file segreto può essere creato 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.
La colonna Tipo nella tabella della pagina Archivi identifica gli archivi forniti da Adobe (Adobe) e i tuoi archivi privati (GitHub).
Se in un secondo momento dovrai tornare all'archivio per completare la convalida, nella pagina Archivi fai clic sull'icona nella riga che rappresenta l'archivio GitHub appena aggiunto. Nell'elenco a discesa selezionare Convalida proprietà.
Utilizzare archivi GitHub privati con Cloud Manager using
Dopo la convalida dell’archivio GitHub in Cloud Manager, l’integrazione è completa. Puoi utilizzare l’archivio con Cloud Manager.
Per utilizzare 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.
-
Il controllo GitHub rimane in esecuzione fino al completamento del controllo di qualità del codice. I risultati di qualità del codice sono propagati quindi alla verifica GitHub.
Quando la richiesta di pull viene unita o chiusa, 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, rimuove la funzione di convalida delle richieste pull 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 è possibile sospendere la convalida della richiesta di pull utilizzando il controllo GitHub di Cloud Manager.
Se l’archivio GitHub viene convalidato in Cloud Manager, Cloud Manager tenta sempre di convalidare le richieste pull create per tale archivio.