Obiettivo

Nel panorama digitale di oggi, le società sono sempre più dinamiche e innovative. La capacità di gestire e implementare efficacemente il codice del proprio sito Web è fondamentale per mantenere la competitività e la sostenibilità del marchio. Il Git, il sistema di controllo delle versioni più utilizzato al mondo, permette di archiviare il codice del sito Web su piattaforme come GitHub, permettendo una migliore tracciabilità delle modifiche, una più rapida automazione e deploy. I clienti OVHcloud dispongono di un'infrastruttura solida per ospitare il proprio sito Web e allo stesso tempo possono usufruire dei numerosi vantaggi di Git e GitHub per lo sviluppo e l'evoluzione del proprio sito Web.

Questa guida ti mostra come configurare e utilizzare Git su un hosting Web dallo Spazio Cliente OVHcloud.

Prerequisiti

• Disporre di una soluzione di hosting Web OVHcloud.
• Disporre di un account GitHub ed essere connesso.

---

Accesso allo Spazio Cliente OVHcloud

• Link diretto: Hosting
• Percorso di navigazione: Web Cloud > Hosting > Seleziona il tuo hosting web

---

Procedura

Associa una directory a Git

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Definisci il repository GitHub

Inserisci l'indirizzo del tuo repository GitHub. Se non disponi ancora di un repository GitHub per il tuo progetto, creane uno.

Per creare un nuovo deposito:

• Accedi al tuo account GitHub.
• Clicca sull'immagine del profilo in alto a destra e poi su Your repositories.
• Clicca sul pulsante New a destra.

Definisci un nome per il tuo deposito e inserisci le informazioni richieste.

Infine clicca su Create Repository.

Copia l'indirizzo del tuo repository GitHub. La forma deve essere:

• https://github.com/<username>/<repository_name>.git per un deposito pubblico.
• git@github.com:<username>/<repository_name>.git per un deposito privato.

Tornare al modulo di associazione di Git e incollare l'indirizzo del repository GitHub nel campo Repository. Se il formato dell'indirizzo non è corretto, viene visualizzato il seguente messaggio di errore:

Definisci il ramo del tuo repository GitHub. Il ramo predefinito è main, ma se vuoi utilizzare un altro ramo, creane uno su GitHub seguendo i passaggi seguenti:

• Accedi al tuo account GitHub.
• Clicca sull'immagine del profilo in alto a destra e poi su Your repositories.
• Clicca sul repository GitHub corrispondente.
• Clicca su Main e poi su View all branche, oppure clicca direttamente sulla scheda x Branch.
• A destra dello schermo visualizzato, clicca su New branch.
• Inserisci il nome del nuovo ramo e conferma cliccando su Create new branch.

Tornando al modulo di associazione Git disponibile nello Spazio Cliente OVHcloud, è possibile inserire il nome del nuovo ramo appena creato.

Se inserisci l'indirizzo di un repository GitHub privato (di tipo git@github.com:<username>/<repository_name>.git), sotto il campo Branch apparirà un campo SSH key (chiave SSH).

Per configurare la chiave SSH, consulta lo step "Associare una chiave SSH a GitHub (solo per i repository GitHub privati)" qui sotto.

Associare una chiave SSH a GitHub (solo per i repository GitHub privati)

Copia la chiave SSH cliccando sul pulsante a destra.

Registra la chiave SSH sul tuo account GitHub:

• Accedi al tuo account GitHub.
• Clicca sull'immagine del profilo in alto a destra e poi su Settings.
• Nella nuova pagina, clicca su SSH and GPG keys nella colonna di sinistra.
• Seleziona New SSH key o Add SSH key.

Viene visualizzato il modulo per l'aggiunta di una nuova chiave SSH:

• Title: aggiungi una descrizione per la tua chiave SSH. Ad esempio, questa chiave può essere denominata "OVHcloud".
• Type of key: lascia il valore predefinito authentication key
• Key: incolla la chiave SSH.

Per confermare le informazioni, clicca su Add SSH key. Se richiesto, conferma l'accesso al tuo account in GitHub.

Configura il deploy automatico

Nella parte inferiore del modulo di associazione di Git, viene visualizzata la sezione Configurare il deploy automatico, accompagnata dall'URL del webhook. Configurare un webhook permette al repository GitHub di notificare automaticamente al proprio hosting Web OVHcloud gli eventi che si verificano sul repository GitHub (nuova distribuzione, modifica del codice, ecc...). Questa funzionalità è particolarmente utile se lavorate in gruppo sullo stesso progetto e desiderate rimanere aggiornati su tutte le modifiche apportate al repository GitHub. Per maggiori informazioni, scopri come configurare un webhook su GitHub.

Confermare l'associazione di Git

Prima di convalidare il modulo di associazione di Git, assicurarsi che:

• La chiave SSH è stata registrata correttamente nel tuo account GitHub.
• L'indirizzo del tuo repository GitHub è corretto. Il formato deve essere https://github.com/<username>/<repository_name>.git.
• Il nome del ramo del repository GitHub è corretto.
• La directory di installazione è vuota.

Per confermare le informazioni del modulo di associazione di Git, clicca su Applicare la configurazione.

Attivazione dell'associazione di Git

Associazione di Git riuscita

Dopo aver validato il modulo di associazione Git, sei reindirizzato alla pagina dell'etichetta I miei siti.

Un'intestazione verde indica che Git è in corso di attivazione. Segui l'attivazione di Git cliccando sul link Operazioni in corso.

Lo stato In corso indica che l'associazione di Git è in corso. Il processo potrebbe richiedere alcuni minuti. Al termine dell'operazione, viene visualizzato lo stato Attivato.

Puoi anche seguire l'evoluzione dell'attivazione di Git dall'etichetta I miei siti. Nella colonna Git del tavolo, la dicitura In corso presente sulla riga del sito web desiderato ti indica che Git è in corso di attivazione.

Quando l'associazione di Git è completata, lo stato Attivato appare nella colonna Git per il sito web desiderato.

Errori dell'associazione di Git

Nel tavolo dell'etichetta I miei siti, identifica le righe corrispondenti al directory del sito web che desideri associare a Git. Nella colonna Git, se la dicitura Errore appare, ciò significa che almeno uno dei seguenti errori è avvenuto:

• La chiave SSH non è stata registrata nel tuo account GitHub.
• La directory di installazione non è vuota.
• L'indirizzo del repository GitHub non esiste o è errato.
• Il ramo del repository GitHub non esiste o il nome è errato.

Per conoscere la causa esatta dell'errore, consulta le informazioni dell'ultimo deployment. Nel tavolo, clicca sul pulsante ⁝ a destra del sito web desiderato, quindi su Informazioni dell'ultimo deploy.

Una volta identificato(i) l'(i) errore(i), associa Git nuovamente. Ripeti l'operazione cliccando sul pulsante ⁝ a destra del sito web desiderato, quindi su Associa Git.

Avviare il repository GitHub sull'hosting Web OVHcloud

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Modificare un dominio

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Scollega un dominio

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Configura Git

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Informazioni dell'ultimo deploy

Dopo aver implementato il repository GitHub sul tuo hosting Web, puoi consultare le informazioni relative all'ultimo implementazione, come errori, test o qualsiasi informazione utile.

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 3 passi.

Elimina l'associazione di Git

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Configura un webhook su GitHub

Recupera l'URL del webhook

Clicca sulle schede qui sotto per visualizzare in sequenza ciascuno dei 4 passi.

Configura il webhook

Accedi al tuo account GitHub e accedi al repository su cui vuoi configurare il webhook. Clicca sulla scheda Settings e, nel menu laterale delle impostazioni, clicca su Webhooks. Clicca sul pulsante Add webhook per accedere al modulo:

• Payload URL: immettere l'URL fornito nel modulo di associazione di Git (URL del webhook).
• Content type: scegli application/json come tipo di contenuto per i dati inviati.
• Secret: il segreto è facoltativo. GitHub lo utilizzerà per firmare i messaggi inviati dal webhook, migliorando così la sicurezza.
• SSL verification: se il tuo sito Web supporta l'HTTPS, lascia questa opzione attiva per una maggiore sicurezza.
• Which events would you like to trigger this webhook?: seleziona gli eventi che attiveranno l'invio del webhook. Per un deploy automatico, Just the push event (Solo l'evento push) è spesso sufficiente, ma è possibile scegliere Send me everything per ricevere notifiche per tutti gli eventi.
• Active: assicurati che la casella sia selezionata per attivare il webhook.

Clicca su Add webhook per registrare e attivare il nuovo webhook.

Testare il tuo webhook

Dopo aver creato il tuo webhook in GitHub, vai nella lista dei tuoi webhook e seleziona quello che hai creato o clicca su Edit.

Clicca sulla scheda Recent Deliveries. Per inviare un evento di prova specifico, GitHub invia in genere un evento ping durante la creazione del webhook, ed è possibile utilizzare il pulsante Redeliver accanto a questo evento per testarlo.

Se il test ha funzionato correttamente, la scheda Response restituisce un codice 200. Se viene restituito un codice di errore (generalmente 500 o 400), significa che il tuo webhook è stato configurato male. Tornate al modulo di aggiunta di un webhook e verificate le informazioni, in particolare l'URL del webhook fornito da OVHcloud.

Utilizza il webhook

Una volta configurato il tuo webhook, il codice del tuo sito Web verrà aggiornato automaticamente ogni volta che si verificano modifiche sul repository GitHub. Ad esempio, se un collega apporta modifiche al repository GitHub, il codice del sito Web viene aggiornato localmente (sull'hosting OVHcloud).

Conclusione

Hai appena associato il codice del tuo sito Web a Git, tramite il tuo repository GitHub. A questo punto puoi distribuire le modifiche apportate sul repository GitHub verso il tuo hosting Web o distribuirle in modo automatico grazie al webhook, consultare i log dei deploy ed effettuare diverse azioni, tutto questo dal tuo Spazio Cliente, in pochi click.

Per saperne di più

Mettere online un sito Internet su un hosting Web

Per prestazioni specializzate (referenziamento, sviluppo, ecc...), contatta i partner OVHcloud.

Per usufruire di un supporto per l'utilizzo e la configurazione delle soluzioni OVHcloud, è possibile consultare le nostre offerte di supporto.

Contatta la nostra Community di utenti.