Configurare e utilizzare Git con un hosting Web OVHcloud

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: Web hosting
• Percorso di navigazione: Web Cloud > Hosting > Seleziona il tuo hosting web

---

Procedura

Associa una directory a Git

Accedi allo Spazio Cliente OVHcloud ed effettua le seguenti operazioni:

• Accedi alla scheda Web Cloud.
• Seleziona il tuo hosting nella sezione Hosting a sinistra.
• Clicca sulla scheda Multisito.
• Nella tabella che appare, identifica la riga corrispondente alla directory che desideri associare a Git.
• Clicca sul pulsante ... e seleziona Associare Git.

Viene visualizzato il modulo di associazione Git. È necessario configurare più elementi:

• Chiave SSH
• Deposito GitHub
• Diramazione del repository GitHub
• Chiave SSH (per un repository GitHub privato)
• Webhook (opzionale)

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 convalidato il modulo di associazione di Git, verrai reindirizzato alla scheda Multisito.

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.

Per monitorare lo stato dell’attivazione di Git, accedi alla scheda Multisito. Nella tabella, identificare le righe corrispondenti alla directory che si desidera associare a Git. Per ciascuna delle linee interessate, nella colonna Git, la voce In corso indica che Git è in corso di attivazione.

Quando viene eseguita l’associazione di Git, lo stato Attivato appare nella colonna Git per le linee interessate.

Errori dell'associazione di Git

Nella tabella della scheda Multisito, identifica le righe corrispondenti alla directory che vuoi associare a Git. Nella colonna Git, se compare la dicitura Errore, significa che si è verificato almeno uno dei seguenti errori:

• 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 la causa esatta dell'errore, vedere le informazioni relative all'ultima distribuzione. Nella tabella, identifica la riga corrispondente al dominio di cui vuoi consultare i log dell’ultima distribuzione. A destra della linea, clicca sul pulsante ... e poi su Informazioni dell'ultimo deploy.

Una volta individuato il/i errore/i, associa di nuovo Git. Ripeti l’operazione cliccando sul pulsante ... della riga corrispondente e poi su Associare Git.

Avviare il repository GitHub sull’hosting Web OVHcloud

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente al dominio che vuoi sviluppare con Git. Assicurati che lo stato della colonna Git sia Attivato. Clicca sul pulsante ... e poi su Eseguire il deploy Git.

Verrà visualizzato un messaggio di conferma e una casella di controllo che indica che, in caso di conflitto durante la distribuzione, è possibile forzare le modifiche remote (del repository GitHub) sul repository locale. Seleziona la casella in base alla tua scelta e clicca su Confermare per confermare l’installazione.

La nuova versione del sito Web è stata implementata correttamente sugli hosting OVHcloud. Se altre persone lavorano sullo stesso progetto e apportano modifiche al repository GitHub, allora puoi configurare un webhook su GitHub perché le loro modifiche vengano distribuite automaticamente sul tuo hosting Web. Questo ti evita di installare Git manualmente e di mantenere sempre aggiornato il tuo hosting Web.

Modificare un dominio

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella nuova finestra, identifica la riga corrispondente al dominio che vuoi modificare. Clicca sul pulsante ... e poi su Modifica il dominio. Sono possibili due scenari:

Il dominio non è l'unico associato alla stessa directory

Viene visualizzata la seguente finestra:

Modifica le informazioni e clicca su Continua.

Verrà visualizzata una seconda finestra di conferma con il riepilogo delle modifiche.

Clicca su Confermare per confermare le modifiche del dominio.

Il dominio è l'unico associato alla directory

Viene visualizzata la seguente finestra:

Come indicato nel messaggio, eliminare l'associazione Git per prima cosa prima di modificare il dominio.

Scollega un dominio

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente al dominio che vuoi scollegare dal tuo hosting Web OVHcloud. Clicca sul pulsante ... e poi su Scollega il dominio. Sono possibili due scenari:

Il dominio non è l'unico associato alla stessa directory

Viene visualizzata la finestra successiva.

Clicca su Confermare per confermare lo scollegamento del dominio.

Il dominio è l'unico associato alla directory

Viene visualizzata la seguente finestra:

Come indicato nel messaggio, eliminare l'associazione Git in un primo momento, prima di scollegare il dominio.

Configura Git

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente alla directory che vuoi configurare con Git. Clicca sul pulsante ... e poi su Configurare Git.

Vengono visualizzate le seguenti informazioni:

• Chiave SSH: se non l'hai già fatto, registra la tua chiave SSH nel tuo account GitHub.
• Deposito: indirizzo del vostro deposito Git. Questo campo è disattivato perché non è possibile modificare l'indirizzo del repository Git. Per modificare l'URL del repository Git, è necessario rimuovere l'associazione Git dalla directory e di nuovo associare la directory a Git.
• Diramazione: nome della diramazione del deposito GitHub. È possibile modificare questo campo.
• URL del webhook : per ottimizzare i deploy su Git, configura il webhook su GitHub.

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.

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente al dominio di cui vuoi consultare i log dell’ultima distribuzione. A destra della linea, clicca sul pulsante ... e poi su Informazioni dell'ultimo deploy.

In questa schermata sono disponibili tutte le informazioni relative all’ultima distribuzione.

Elimina l'associazione di Git

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente alla directory dalla quale vuoi eliminare l’associazione con Git. Clicca sul pulsante ... e poi su Eliminare Git.

Viene visualizzata la seguente finestra:

Il messaggio ti informa che l'eliminazione verrà applicata a tutti i domini associati alla tua directory. Seleziona la casella Vuoi eliminare il contenuto della directory <your_directory>? se vuoi anche eliminare il contenuto (cartelle e file) dalla directory.

1. Se si seleziona la casella di controllo, viene visualizzata la seguente finestra:

Clicca su Confermare per confermare l’eliminazione dell’associazione Git dalla tua directory e il suo contenuto.

2. Se non si seleziona la casella di controllo, viene visualizzata la seguente finestra:

Clicca su Confermare per confermare l’eliminazione dell’associazione Git dalla directory.

Configura un webhook su GitHub

Recupera l'URL del webhook

Accedi allo Spazio Cliente OVHcloud, clicca su Hosting nella sezione Web Cloud e seleziona il nome dell’hosting interessato. Seleziona la scheda Multisito. Nella tabella che appare, identifica la riga corrispondente alla directory sulla quale vuoi configurare un webhook. Clicca sul pulsante ... e poi su Configurare Git.

In fondo al form che viene visualizzato, identifica l’indirizzo del campo URL del webhook e copialo. A questo punto è necessario salvare l’URL e configurare il webhook sul tuo account GitHub.

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 soluzioni offerte di supporto.

Contatta la nostra Community di utenti.