Messa in produzione sito di staging

In questa guida illustreremo come effettuare la messa in produzione di un sito di staging presente sul nostro hosting.

La guida è rivolta verso gli hosting che hanno il dominio registrato, la gestione DNS ed ovviamente lo spazio hosting presso Artera.

Attività preliminari

Prima di iniziare è necessario fare delle verifiche preliminari:

controllare la versione di PHP utilizzata dal sito, poiché non è possibile mantenere due versioni differenti sullo stesso hosting;
controllare lo spazio disponibile sull'hosting, per evitare di consumare tutta la risorsa e generare il blocco del sito di produzione attuale.

1. Preparazione ambiente di produzione

Esistono due casi:

1. Ambiente di produzione vuoto

L'ambiente di produzione è vuoto quindi procediamo con la creazione di un database da utilizzare per la copia del sito di staging nell'ambiente di produzione. Per farlo è possibile seguire i passaggi riportati nella seguente guida: https://kb.artera.net/books/cpanel---database/page/attivare-un-nuovo-database

Consigliamo di salvare da qualche parte i dati del nuovo database (nome database, username e password) creato per l'ambiente di produzione, in quanto saranno necessari per il corretto completamento della messa in produzione.

2. Ambiente di produzione già presente

L'ambiente di produzione è già presente e vi è la necessità di mantenerlo, in questo caso procediamo con la creazione di un sottodominio, ad esempio, old.dominio.TLD seguendo questa guida: https://kb.artera.net/books/cpanel---domini/page/creazione-sottodominio , è necessario rendere il sottodominio raggiungibile, configurando il record DNS di tipo A con l'indirizzo IP del server (è possibile recuperarlo accedendo al proprio cPanel, nel riepilogo delle "informazioni generali"); se il dominio utilizza i nostri nameserver è possibile consultare la seguente guida per configurare correttamente il record DNS: https://kb.artera.net/books/area-riservata-c81/page/come-modificare-i-dns

Una volta creato spostiamo il contenuto della cartella public_html all'interno della cartella del sottodominio.

E' possibile farlo in tre modi:

1. SSH

Collegarsi allo spazio hosting con il comando:

ssh nomeutente@dominio

Dove "nomeutente" è l'utente cPanel e "dominio" è il nome dominio associato a cPanel.
Copiamo quindi il contenuto della cartella del sito di produzione attuale all'interno della cartella old.dominio.TLD, utilizzando i seguenti comandi:

mv public_html/* old.dominio.TLD

mv public_html/.* old.dominio.TLD

Il comando dev'essere eseguito nella cartella principale (home), fuori dalle cartelle public_html e del sottodominio old.dominio.TLD

2. File Manager

La seguente guida illustra come utilizzare questo strumento: https://kb.artera.net/books/cpanel---file/page/file-manager-gestione-file

Come prima cosa è necessario abilitare la visualizzazione dei file nascosti dai settings in alto a destra abilitando il flag della voce: Show Hidden Files (dotfiles).

Successivamente si potrà copiare il contenuto della cartella di produzione attuale all'interno della cartella old.dominio.TLD

3. FTP

La seguente guida illustra come configurare correttamente il client FTP: https://kb.artera.net/books/ftp/page/configurazione-client-ftp-filezilla

Successivamente recuperiamo le informazioni del database contenente il sito di produzione attuale all'interno del file di configurazione del CMS utilizzato e salviamo una copia del database di produzione attuale, è possibile farlo in due modi:

1. SSH

Collegarsi allo spazio hosting con il comando:

ssh nomeutente@dominio

Dove "nomeutente" è l'utente cPanel e "dominio" è il nome dominio associato a cPanel.
Esportiamo quindi il database in un file .sql con il comando:

mysqldump --no-tablespaces -u NOME_UTENTE_PRODUZIONE -p NOME_DB_PRODUZIONE > dumpDATA.sql

Dove "NOME_UTENTE_PRODUZIONE" è l'utente associato al database, "NOME_DB_PRODUZIONE" è il nome del database utilizzato nell'ambiente di produzione attuale e dumpDATA.sql il nome del file .sql che vorrete generare per salvare il database esportato.

Una volta inserita la password dell'utente associato al database il sistema genererà il file .sql.

Il file .sql viene creato nella directory dove si esegue il comando, consigliamo quindi di spostarsi nella cartella old.dominio.TLD prima di lanciarlo.

2. phpMyAdmin

Per procedere con l'esportazione del database da phpMyAdmin consigliamo di consultare la seguente guida: https://kb.artera.net/books/phpmyadmin/page/esportare-un-database-con-phpmyadmin

2. Esportazione Database da ambiente di staging

E' possibile effettuare questa operazione in due modi (tramite accesso SSH o utilizzando phpMyAdmin), in entrambi i casi è necessario recuperare le informazioni sul database che contiene il sito di staging all'interno del file di configurazione del CMS utilizzato, visualizzandolo con un editor di testo.

1. SSH

Collegarsi allo spazio hosting con il comando:

ssh nomeutente@dominio

Dove "nomeutente" è l'utente cPanel e "dominio" è il nome dominio associato a cPanel.
Esportiamo quindi il database in un file .sql con il comando:

mysqldump --no-tablespaces -u NOME_UTENTE_STAGING -p NOME_DB_STAGING > dumpDATA.sql

Dove "NOME_UTENTE_STAGING" è l'utente associato al database, "NOME_DB_STAGING" e il nome del database utilizzato per il sito di staging e dumpDATA.sql il nome del file .sql che vorrete generare per salvare il database esportato.

Una volta inserita la password dell'utente associato al database il sistema genererà il file .sql.

Il file .sql viene creato nella directory dove si esegue il comando, consigliamo quindi di spostarsi nella cartella associata all'ambiente di staging prima di lanciarlo.

2. phpMyAdmin

Per procedere con l'esportazione del database da phpMyAdmin consigliamo di consultare la seguente guida: https://kb.artera.net/books/phpmyadmin/page/esportare-un-database-con-phpmyadmin

3. Copia ambiente di staging su ambiente di produzione

E' possibile effettuare questa operazione in tre modi: tramite accesso SSH, utilizzando il file manager di cPanel oppure con client FTP.

1. SSH

Collegarsi allo spazio hosting con il comando:

ssh nomeutente@DOMINIO

Dove "nomeutente" è l'utente cPanel e "dominio" è il nome dominio associato a cPanel.
Copiamo quindi il contenuto della cartella del sito di staging all'interno della cartella public_html, utilizzando i seguenti comandi:

cp -a cartella_staging/* public_html

cp -a cartella_staging/.* public_html

Dove "cartella_staging" è il nome della cartella relativa all'ambiente di staging.

Il comando dev'essere eseguito nella cartella principale, fuori dalle cartelle public_html e da quella dell'ambiente di staging. Inoltre la cartella public_html deve essere vuota, se è necessario mantenerne il contenuto consigliamo di spostarlo in un altra cartella o di esportarlo dal server come indicato in precedenza.

2. File Manager

La seguente guida illustra come utilizzare questo strumento: https://kb.artera.net/books/cpanel---file/page/file-manager-gestione-file

Come prima cosa è necessario abilitare la visualizzazione dei file nascosti dai settings in alto a destra abilitando il flag della voce: Show Hidden Files (dotfiles).

Successivamente si potrà copiare il contenuto della cartella di staging all'interno della cartella public_html.

Come indicato anche prima la cartella public_html deve essere liberata del suo contenuto attuale.

3. FTP

La seguente guida illustra come configurare correttamente il client FTP: https://kb.artera.net/books/ftp/page/configurazione-client-ftp-filezilla

4. Importazione Database su ambiente di produzione

E' possibile effettuare questa operazione in due modi, tramite accesso SSH o utilizzando phpMyadmin.

1. SSH

Collegarsi allo spazio hosting con il comando:

ssh nomeutente@dominio

Dove "nomeutente" è l'utente cPanel e "dominio" è il nome dominio associato a cPanel.

Importiamo quindi il Database con il comando:

mysql -u DB_USER_PRODUZIONE -p DB_NAME_PRODUZIONE < dumpDATA.sql

Dove "DB_USER_PRODUZIONE" e "DB_NAME_PRODUZIONE" sono l'utente del database creato in precedenza per il nuovo ambiente di produzione.
Il sistema chiederà di inserire la password dell'utente e l'importazione verrà eseguita una volta fornito il dato richiesto.

Per motivi di sicurezza consigliamo di eliminare il file dumpDATA.sql una volta conclusa l'importazione dei dati.

2. phpMyAdmin

Per procedere con l'esportazione del database da phpMyAdmin consigliamo di consultare la seguente guida: https://kb.artera.net/books/phpmyadmin/page/importare-un-database-con-phpmyadmin