Aggiungere un archivio GitHub privato in Cloud Manager private-repositories

Configurando Cloud Manager per l’integrazione con l’archivio GitHub privato ospitato su github.com, puoi convalidare il codice direttamente in GitHub utilizzando Cloud Manager. Questa pagina si applica a qualsiasi archivio ospitato su github.com, indipendentemente dal piano GitHub (Free, Pro, Team o Enterprise Cloud). Questa configurazione elimina la necessità di sincronizzare regolarmente il codice con l’archivio Adobe.

IMPORTANT
Cloud Manager convalida la proprietà dell’archivio GitHub in uno dei due modi seguenti, a seconda di dove è ospitato l’archivio:
  • Questa pagina si applica a qualsiasi archivio ospitato su github.com, indipendentemente dal piano GitHub (Free, Pro, Team o Enterprise Cloud). Questi archivi utilizzano l’app GitHub Adobe per convalidare la proprietà. Non è richiesta alcuna configurazione del webhook, perché Cloud Manager si integra direttamente tramite l’app.

  • Per aggiungere uno dei seguenti tipi di repository, vedere Aggiungere repository esterni in Cloud Manager. Questi archivi utilizzano un PAT (Personal Access Token) e un webhook configurato manualmente per convalidare la proprietà.

    • Archivi GitHub Enterprise Server (versione con hosting autonomo di GitHub).
    • Archivi GitLab (sia gitlab.com che la versione con hosting autonomo di GitLab).
    • Archivi bitbucket (solo bitbucket.org, versione cloud). La versione self-hosted di Bitbucket è stata rimossa a partire dal 15 febbraio 2024.
    • Archivi Azure DevOps (dev.azure.com).

Configurazione configuration

La configurazione di un archivio GitHub privato in Cloud Manager consiste di due passaggi:

Aggiungere un archivio GitHub privato a un programma add-repo

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.

  2. Nella console Programmi personali selezionare il programma a cui si desidera collegare un archivio Git privato.

  3. Nel menu laterale, in Servizi, seleziona l’ icona della cartella Archivi.

    Pagina Archivi

  4. Nell’angolo superiore a destra della pagina Archivi fai clic su Aggiungi archivio.

  5. Nella finestra di dialogo Aggiungi archivio, seleziona Archivio privato come tipo di archivio.

    Aggiungi un archivio personale

  6. 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 L’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.
  7. Seleziona Salva.
    Ora puoi convalidare la proprietà dell’archivio privato.

TIP
Per informazioni dettagliate sulla gestione degli archivi in Cloud Manager, consulta Archivi di Cloud Manager.

Convalidare la proprietà di un archivio GitHub privato validate-ownership

Cloud Manager è ora configurato con l’archivio GitHub, ma richiede ancora l’autorizzazione per accedere all’archivio. 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:

  1. Dopo aver aggiunto l’archivio, seguire i passaggi rimanenti nella finestra di dialogo Convalida proprietà archivio privato.

    Convalida delle proprietà dell’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 in modo sicuro con l’archivio privato.
    · 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 informazioni dettagliate sull’installazione e sulla concessione dell’accesso, vedere la documentazione di GitHub.
    Passaggio 2: file segreto Per migliorare la sicurezza, devi creare un file segreto nel ramo predefinito del tuo archivio.
    · Fai clic su Genera, quindi fai clic su Conferma. Cloud Manager genera il contenuto del file privato nel campo di testo Contenuto file segreto.
    · Fare clic sull’icona Copia 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.
  2. Crea un nuovo file nel ramo predefinito dell’archivio GitHub con il nome

    .well-known/adobe/cloud-manager-challenge

  3. Incolla il contenuto del file segreto nel nuovo file e salva.

    Una volta installata l’app e che il file segreto esiste nell’archivio, continua con i passaggi.

  4. 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 entrambi gli ordini. Tuttavia, entrambi i passaggi devono essere completati prima di poter eseguire la convalida.

Fino alla convalida, l’archivio viene elencato con un’icona rossa, a indicare che non è ancora stato convalidato e non è disponibile per l’uso.

Archivio non convalidato

La colonna Tipo nella tabella della pagina Archivi identifica gli archivi forniti da Adobe (Adobe) e i tuoi archivi privati (GitHub).

Per accedere all’archivio in un secondo momento e completare la convalida, nella pagina Archivi fai clic sull’icona Altro nella riga che rappresenta l’archivio GitHub 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 GitHub privati con Cloud Manager:

  1. Quando crei una richiesta pull, viene avviata automaticamente una verifica GitHub.

    Verifiche GitHub

  2. 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.

  3. 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.

    Controlli di qualità del codice GitHub

Quando la richiesta di pull viene unita o chiusa, la pipeline di qualità del codice full stack creata viene eliminata automaticamente.

TIP
Consulta Annotazioni di controllo GitHub per informazioni dettagliate sulle informazioni fornite tramite GitHub quando vengono eseguiti i controlli delle richieste pull.
TIP
Puoi controllare le pipeline create automaticamente per convalidare ogni richiesta pull in un archivio privato. Consulta la sezione Configurazione verifica GitHub per archivi privati per ulteriori informazioni.

Associare archivi GitHub privati alle pipeline pipelines

Gli archivi privati convalidati possono essere associati a pipeline full-stack e front-end.

Limitazioni limitations

Le seguenti limitazioni si applicano quando si utilizzano archivi privati con Cloud Manager.

  • Quando si utilizzano archivi privati su pipeline di produzione full stack, non viene creato e né inviato alcun tag Git.
  • Se l’app GitHub Adobe viene rimossa dall’organizzazione GitHub, rimuove la funzione di convalida delle richieste pull per tutti gli archivi.
  • Le pipeline che utilizzano archivi GitHub privati e il trigger di build “on-commit” non vengono avviati automaticamente quando un nuovo commit viene inviato al 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 sempre di convalidare le richieste pull create per tale archivio.
  • Se l’organizzazione GitHub applica restrizioni IP, apri un caso di supporto per ottenere l’elenco degli indirizzi IP che devono essere consentiti.
recommendation-more-help
experience-manager-cloud-service-help-main-toc