Utilizza le distribuzioni GitHub su WordPress.com

GitHub Deployments integra i tuoi repository GitHub direttamente con il tuo sito WordPress.com, offrendoti un flusso di lavoro automatizzato e controllato per distribuire plugin, temi o modifiche complete al sito. Questa guida descrive il processo di configurazione e mostra come gestire i repository connessi.

Questa funzionalità è disponibile sui siti con i piani WordPress.com Business e Commerce. Se disponi di un piano Business, assicurati di attivarlo. Per i siti gratuiti e quelli con piano Personal e Premium, aggiorna il tuo piano per accedere a questa funzione.

Questo video è in inglese.
YouTube offre funzioni di traduzione automatica per permetterti di guardarlo nella tua lingua:

Per visualizzare i sottotitoli tradotti automaticamente:

1. Riproduci il video.
2. Fai clic su ⚙️ Impostazioni (in basso a destra nel video).
3. Seleziona Sottotitoli/CC.
4. Scegli Traduzione automatica.
5. Seleziona la lingua che preferisci.

Per ascoltare il doppiaggio automatico (sperimentale):

1. Fai clic su ⚙️ Impostazioni.
2. Seleziona Traccia audio.
3. Scegli la lingua in cui vuoi ascoltare il video.

ℹ️ Le traduzioni e i doppiaggi sono generati automaticamente da Google, potrebbero non essere perfetti e il doppiaggio automatico è ancora in fase di test, quindi potrebbe non essere disponibile per tutte le lingue.

Prima di poter distribuire un repository GitHub sul tuo sito WordPress.com, devi configurare la connessione tra i due seguendo questi passaggi:

1. Visita la tua pagina Siti: https://wordpress.com/sites/
2. Fai clic sul nome del tuo sito per visualizzare la panoramica del sito.
3. Fai clic sulla scheda Distribuzioni .
4. Fai clic sul pulsante “Connetti“. Quindi, se vedi i repository elencati, hai già connesso il tuo account GitHub. Passa al punto 11.
5. Fai clic sul pulsante “Installa l’app WordPress.com“.
6. Si aprirà una nuova finestra e ti verrà chiesto di accedere al tuo account GitHub se non l’hai già fatto. Quindi vedrai questa schermata:

7. Fai clic sul pulsante “Autorizza WordPress.com per sviluppatori“.
8. Seleziona l’organizzazione o l’account GitHub in cui si trova il tuo repository.
9. Seleziona quale/quali repository desideri connettere:
   • Tutti i repository: selezionando questa opzione si garantirà a WordPress.com l’accesso a tutti i repository attuali e future possedute dall’account GitHub selezionato. Sono inclusi i repository pubblici di sola lettura.
   • Seleziona solo repository: selezionando questa opzione potrai scegliere a quali repository WordPress.com può accedere sull’account GitHub selezionato. 
10. Dopo aver selezionato un’opzione, fai clic sul pulsante Installa .
11. La nuova finestra si chiuderà e tornerai su WordPress.com. Il/i repository selezionate dovrebbero essere elencati insieme all’account GitHub associato a tale repository:

12. Fai clic su Seleziona accanto al repository da connettere.

A questo punto, dovresti vedere WordPress.com per sviluppatori sotto le tue App GitHub autorizzate e le App GitHub installate.

Dopo aver selezionato un repository, dovrai modificare le impostazioni di distribuzione:

• Ramo di distribuzione: ha come valore predefinito il ramo predefinito del repository (in genere principale), ma può essere modificato nel ramo che vuoi utilizzare.
• Directory di destinazione: la cartella del server in cui vuoi distribuire i file. Per i plugin, sarà /wp-content/plugins/my-plugin-name. Per i temi, sarà /wp-content/themes/my-theme-name. Per una distribuzione parziale del sito (ad esempio, più plugin o temi), puoi usare /wp-content. I contenuti di un repository verranno accorpati con i contenuti esistenti del sito WordPress nella directory specificata.
• Distribuzioni automatiche: ci sono due modi per effettuare le distribuzioni su WordPress.com:
  • Automatico: una volta eseguito il commit, il codice verrà distribuito sul sito WordPress.com. Le distribuzioni automatiche sono consigliate per i siti di staging.
  • Manuale: il codice verrà distribuito una volta richiesta la distribuzione. Le distribuzioni manuali sono consigliate per i siti di produzione.
• Modalità di distribuzione: esistono due tipi di distribuzione:
  • Semplice: questa modalità copierà tutti i file da una sezione del repository al sito e li distribuirà senza post-elaborazione.
  • Avanzate: con questa modalità, è possibile utilizzare uno script di flusso di lavoro, che consente di personalizzare le fasi di compilazione, come l’installazione delle dipendenze Composer, l’esecuzione di test del codice prima della distribuzione e il controllo della distribuzione dei file. Ideale per i repository che necessitano di software Composer o Node. Per ulteriori informazioni, vedi Distribuzione avanzata di seguito.

Una volta configurate tutte le impostazioni, fai clic sul pulsante Connetti . Il tuo repository verrà aggiunto:

È necessario attivare la prima distribuzione, automaticamente o manualmente.È quindi possibile connettere un altro repository in qualsiasi momento facendo clic sul pulsante “Connetti repository“.

Con la distribuzione avanzata è possibile fornire uno script del flusso di lavoro per elaborare i file nel repository prima della distribuzione. Questo apre molte possibilità, come controllare il codice per assicurarsi che soddisfi gli standard di codifica del team, eseguire test unitari, escludere file dalla distribuzione, installare dipendenze e molto altro ancora. Per iniziare, dai un’occhiata alle nostre ricette per flussi di lavoro.

Per impostare la distribuzione avanzata:

1. Verrà visualizzato un modulo in cui è possibile configurare la distribuzione.
2. Fai clic sul nome del repository per gestire la connessione.
3. Sul lato destro, in “Scegli la tua modalità di distribuzione“, scegli Avanzata.

4. Se il repository contiene già un file del flusso di lavoro, puoi selezionarlo qui. Il sistema controllerà il file per eventuali errori. Se non vengono trovati errori, vai al passaggio 7.
5. È inoltre possibile selezionare l’opzione “Crea nuovo flusso di lavoro” per aggiungere un file di flusso di lavoro preconfigurato. Se scegli questa opzione, il file del flusso di lavoro wpcom.yml verrà sovrascritto se già esistente nel repository.
6. Fai clic sul pulsante “Installa flusso di lavoro per me” per eseguire il commit del file del flusso di lavoro nel repository.
7. Una volta aggiunto e verificato un flusso di lavoro, fai clic su Aggiorna. Il tuo repository ora utilizzerà la distribuzione avanzata.

Dopo aver connesso il repository GitHub a un sito, il passaggio successivo è quello di distribuire il codice. Sono disponibili due metodi di distribuzione: Automatico e Manuale.

Le distribuzioni automatiche non sono raccomandate per i siti di produzione live, poiché qualsiasi modifica del codice nel repository viene distribuita automaticamente da GitHub al sito live. Una volta pronto, puoi configurare la distribuzione automatica su un sito di staging e sincronizzarla con il sito di produzione.

Le distribuzioni manuali ti danno più controllo su quando le modifiche del codice vengono inviate in tempo reale, poiché dovrai attivare manualmente ogni distribuzione. Se non vuoi utilizzare un sito di staging, ti consigliamo di eseguire le distribuzioni manuali.

Per avviare manualmente una distribuzione:

1. Visita la tua pagina Siti: https://wordpress.com/sites/
2. Fai clic sul nome del tuo sito per visualizzare la panoramica del sito.
3. Fai clic sulla scheda Distribuzioni .
4. Fai clic sul menu con i tre puntini (⋮) nel repository che vuoi distribuire.
5. Scegli “Avvia distribuzione manuale“. Dovresti vedere un banner di notifica che dice “Esecuzione della distribuzione creata” e lo stato della distribuzione cambierà in “In coda”.
6. Attendi il completamento della distribuzione (lo stato cambierà in “Distribuito”).

7. Fai di nuovo clic sul menu con i tre puntini (⋮) e scegli “Visualizza esecuzioni di distribuzione“. 
8. Nel log di esecuzione della distribuzione vengono visualizzati l’autore e il commit distribuito. Se fai clic sulla voce di esecuzione della distribuzione, puoi visualizzare ulteriori informazioni.

Per gestire le connessioni esistenti al repository GitHub:

1. Visita la tua pagina Siti: https://wordpress.com/sites/
2. Fai clic sul nome del tuo sito per visualizzare la panoramica del sito.
3. Fai clic sulla scheda Distribuzioni .
4. Dovresti quindi vedere l’elenco delle connessioni. 

L’elenco delle connessioni viene mostrato se esiste almeno una connessione tra un repository GitHub e il tuo sito. L’elenco include le informazioni rilevanti per ogni connessione, come il nome del repository e il ramo, l’ultimo commit distribuito su un sito, la data in cui è avvenuto, il luogo in cui è stato posizionato il codice, la durata della distribuzione e il relativo stato.

Sono disponibili azioni aggiuntive dopo aver fatto clic sul menu con i tre puntini (⋮):

• Avvia distribuzione manuale: avvia un’esecuzione della distribuzione sull’ultimo commit del ramo configurato.
• Vedi esecuzioni della distribuzione: apre la visualizzazione log di esecuzione della distribuzione per il repository connesso.
• Configura connessione: apre la vista gestisci connessione per il repository.
• Disconnetti repository: rimuove la connessione tra repository e sito.

I log di esecuzione della distribuzione forniscono un record dettagliato e puntuale di ogni distribuzione, indipendentemente dal fatto che venga attivata automaticamente o manualmente. Questi log ti aiutano a tenere traccia delle modifiche, a monitorare lo stato della distribuzione e risolvere eventuali problemi. Con l’accesso ai log delle ultime 10 esecuzioni nell’arco di 30 giorni, puoi facilmente rivedere cosa è successo durante ogni distribuzione e assicurarti che tutto funzioni senza intoppi.

Per controllare i log di una distribuzione:

1. Visita la tua pagina Siti: https://wordpress.com/sites/
2. Fai clic sul nome del tuo sito per visualizzare la panoramica del sito.
3. Fai clic sulla scheda Distribuzioni .
4. Fai clic sul menu con i puntini di sospensione (⋮) accanto al repository per il quale vuoi visualizzare i log.
5. Seleziona “Visualizza esecuzioni della distribuzione“.
6. La vista elenco delle distribuzioni mostra i commit distribuiti sul sito, lo stato della distribuzione, la data e la durata.
7. Fai clic in un punto qualsiasi di una sequenza per espandere e visualizzare ulteriori informazioni sulla distribuzione.

I log forniscono un record di tutti i comandi eseguiti, dal recupero del codice da GitHub al suo posizionamento nella directory di destinazione. Puoi espandere le righe di log per visualizzare ulteriori informazioni facendo clic su “mostra di più“.

Quando disconnetti un repository GitHub dal tuo sito, qualsiasi modifica futura al repository non avrà più impatto sul tuo sito. Per impostazione predefinita, i file distribuiti rimangono sul tuo sito, ma hai la possibilità di rimuoverli durante il processo di disconnessione.

Per rimuovere un repository:

1. Visita la tua pagina Siti: https://wordpress.com/sites/
2. Fai clic sul nome del tuo sito per visualizzare la panoramica del sito.
3. Fai clic sulla scheda Distribuzioni .
4. Fai clic sul menu con i tre puntini (⋮) nel repository.
5. Seleziona “Disconnetti repository“.
6. Apparirà una finestra di dialogo. Fai clic sul pulsante per rimuovere i file associati dal sito.
7. Fai clic su “Disconnetti repository” per chiudere la finestra di dialogo e disconnettere il repository.

Nota che WordPress.com per sviluppatori verrà comunque visualizzato nelle tue app GitHub installate e nelle tue app GitHub autorizzate. Questo perché WordPress.com ha ancora accesso al repository, ma la connessione è stata eliminata.

Puoi anche decidere di revocare l’accesso di WordPress.com al tuo account GitHub. Puoi farlo in qualsiasi momento visitando le impostazioni delle tue applicazioni su GitHub. 

Per revocare l’accesso autorizzato dell’app al tuo account GitHub:

1. Vai alle app GitHub autorizzate.
2. Fai clic su Revoca accanto a WordPress.com per sviluppatori.
3. Fai clic sul pulsante “Ho capito, revoca l’accesso“.

Anche se revochi l’accesso autorizzato all’app, il codice può comunque essere distribuito perché l’app WordPress.com per sviluppatori rimane installata sugli account selezionati.

Per revocare l’accesso all’installazione di WordPress.com e disabilitare la possibilità di distribuire codice al tuo sito WordPress.com:

1. Vai su App GitHub installate.
2. Fai clic su Configura accanto a WordPress.com per sviluppatori.
3. Nell’area Zona di pericolo, fai clic su Disinstalla, quindi fai clic su OK quando richiesto.

La rimozione di WordPress.com dall’elenco delle app autorizzate non comporta la cancellazione o il blocco dei repository; questi ultimi continueranno a esistere su GitHub anche dopo la revoca dell’accesso a WordPress.com, ma WordPress.com non potrà più distribuire codice.