Ospitare WordPress nell'ambiente flessibile di App Engine

Questo tutorial mostra come eseguire il deployment di un piccolo sito WordPress nell'ambiente flessibile di App Engine.

Obiettivi

• Crea un'istanza Cloud SQL di seconda generazione.
• Configurare un sito WordPress di esempio.
• Esegui il deployment del sito WordPress di esempio nell'ambiente flessibile di App Engine.

Costi

Importante:In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• App Engine
• Cloud SQL

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

I nuovi utenti di Google Cloud potrebbero avere diritto a una prova senza costi.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the required APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the required APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

1. Crea le credenziali seguendo questi passaggi:

   • Nella console Google Cloud , vai alla pagina Credenziali.

     Apri la pagina Credenziali API

   • Fai clic su Crea credenziali e seleziona Chiave service account.
   • Seleziona Service account > Service account predefinito di App Engine.
   • Fai clic su Crea.
   • Salva la chiave scaricata in un luogo sicuro.
2. Installa PHP e Composer.
3. Scarica il proxy Cloud SQL e rendilo eseguibile. Aggiungi anche la posizione del file eseguibile del proxy Cloud SQL alla variabile di ambiente PATH.
4. Installa un client MySQL e verifica che la posizione del file eseguibile mysql si trovi nella variabile di ambiente PATH.

Creazione e configurazione di un'istanza Cloud SQL di seconda generazione

1. Crea un'istanza Cloud SQL di seconda generazione:

   gcloud sql instances create tutorial-sql-instance \
       --activation-policy=ALWAYS \
       --tier=db-n1-standard-1 \
       --region=us-central1
   

2. Imposta una password radice per l'istanza:

   gcloud sql users set-password root --instance tutorial-sql-instance \
       --password [YOUR_SQL_ROOT_PASSWORD] \
       --host %
   

   dove [YOUR_SQL_ROOT_PASSWORD] è una password sicura scelta da te.

3. Scarica ed esegui il proxy Cloud SQL:

   ./cloud-sql-proxy \
       -dir /tmp/cloudsql \
       -instances=[YOUR_PROJECT_ID]:us-central1:tutorial-sql-instance \
       -credential_file=[PATH_TO_YOUR_SERVICE_ACCOUNT_JSON]

   dove

   • [YOUR_PROJECT_ID] è l'ID progetto Google Cloud .

   • [PATH_TO_YOUR_SERVICE_ACCOUNT_JSON] è il percorso del file JSON dell'account di servizio scaricato precedentemente.

   Il seguente output indica che il proxy è pronto per nuove connessioni:

   Listening on 127.0.0.1:3306 for [YOUR_PROJECT_ID]:us-central1:tutorial-sql-instance
   Ready for new connections
   

4. In un'altra finestra del terminale crea un nuovo database e un utente:

   mysql -h 127.0.0.1 -u root --password=[YOUR_SQL_ROOT_PASSWORD]
   mysql> create database tutorialdb;
   mysql> create user 'tutorial-user'@'%' identified by '[YOUR_DATABASE_PASSWORD]';
   mysql> grant all on tutorialdb.* to 'tutorial-user'@'%';
   mysql> exit

   dove:

   • [YOUR_SQL_ROOT_PASSWORD] è la password root per la tua istanza Cloud SQL.
   • [YOUR_DATABASE_PASSWORD] è una password sicura scelta da te.

Configurazione del progetto WordPress

1. Clona il repository di esempio:

   git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
   

2. Vai alla directory che contiene il codice di esempio:

   cd php-docs-samples/appengine/flexible/wordpress
   

3. Installa le dipendenze:

   composer install
   

4. Esegui lo script di supporto:

   php wordpress.php setup -n \
       --dir=./wordpress-project \
       --db_instance=tutorial-sql-instance \
       --db_name=tutorialdb \
       --db_user=tutorial-user \
       --project_id=[YOUR_PROJECT_ID] \
       --db_password=[YOUR_DATABASE_PASSWORD]

   dove:

   • [YOUR_PROJECT_ID] è l'ID progetto.
   • [YOUR_DATABASE_PASSWORD] è la password del database.

   Il parametro -dir specifica la posizione del tuo progetto WordPress.

5. Lo script di supporto scrive le informazioni in wordpress-project/wordpress/wp-config.php. Esamina i contenuti di wp-config.php per verificare che i nomi, l'ID progetto e la password del database siano corretti.

   if ($onGae) {
       /** Production environment */
       define('DB_HOST', ':/cloudsql/[YOUR_PROJECT_ID]:us-central1:tutorial-sql-instance');
       /** The name of the database for WordPress */
       define('DB_NAME', 'tutorialdb');
       /** MySQL database username */
       define('DB_USER', 'tutorial-user');
       /** MySQL database password */
       define('DB_PASSWORD', '[YOUR_DATABASE_PASSWORD]');
   } else {
       /** Local environment */
       define('DB_HOST', '127.0.0.1');
       /** The name of the database for WordPress */
       define('DB_NAME', 'tutorialdb');
       /** MySQL database username */
       define('DB_USER', 'tutorial-user');
       /** MySQL database password */
       define('DB_PASSWORD', '[YOUR_DATABASE_PASSWORD]');
   }

Distribuzione del progetto WordPress nell'ambiente flessibile di App Engine

1. Vai alla directory del progetto WordPress:

   cd wordpress-project
   

2. Distribuisci il progetto WordPress:

   gcloud app deploy \
       --promote --stop-previous-version app.yaml cron.yaml
   

3. Nel browser, inserisci il seguente URL:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto Google Cloud
   • REGION_ID: un codice assegnato da App Engine alla tua app

Aggiornamento di WordPress, plug-in e temi

È importante mantenere aggiornati WordPress, i plug-in e i temi. Puoi mantenere questi elementi aggiornati utilizzando lo strumento wp. Dopo un aggiornamento, devi eseguire di nuovo il deployment del progetto WordPress.

1. Aggiorna WordPress:

   vendor/bin/wp core update --path=wordpress
   

2. Aggiorna i plug-in:

   vendor/bin/wp plugin update --all --path=wordpress
   # Just in case it updates any of the dropins, copy the files:
   cp wordpress/wp-content/plugins/batcache/advanced-cache.php \
       wordpress/wp-content/plugins/memcached/object-cache.php \
       wordpress/wp-content
   

3. Aggiorna temi:

   vendor/bin/wp theme update --all --path=wordpress
   

4. Distribuisci nuovamente il progetto:

   gcloud app deploy \
       --promote --stop-previous-version app.yaml cron.yaml
   

Esegui la pulizia

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto creato per il tutorial.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Elimina le versioni non predefinite dell'applicazione

Se non intendi eliminare il progetto, puoi ridurre i costi eliminando le versioni non predefinite dell'applicazione.

Per eliminare una versione dell'applicazione:

1. Nella console Google Cloud , vai alla pagina Versioni per App Engine.

   Vai a Versioni

2. Seleziona la casella di controllo per la versione dell'app non predefinita che vuoi eliminare.
   Nota: L'unico modo per eliminare la versione predefinita dell'app App Engine è eliminare il progetto. Tuttavia, puoi interrompere la versione predefinita nella console Google Cloud . Questa azione arresta tutte le istanze associate alla versione. Se necessario, puoi riavviare queste istanze in un secondo momento.

   Nell'ambiente standard di App Engine, puoi arrestare la versione predefinita solo se la tua app ha una scalabilità manuale o di base.

3. Per eliminare la versione dell'app, fai clic su Elimina.

Elimina l'istanza Cloud SQL

Per eliminare un'istanza Cloud SQL:

1. Nella console Google Cloud , vai alla pagina Istanze.

   Vai a Istanze

2. Fai clic sul nome dell'istanza SQL che vuoi eliminare.
3. Per eliminare l'istanza, fai clic su Elimina, quindi segui le istruzioni.

Passaggi successivi

• Scopri come eseguire l'app di esempio PHP Bookshelf nell'ambiente flessibile di App Engine.

• Scopri come eseguire l'app di esempio PHP Bookshelf su Google Kubernetes Engine.

• Scopri come eseguire l'app di esempio PHP Bookshelf su Compute Engine.

• Scopri di più su WordPress.

• Ulteriori informazioni sull'utilizzo di WordPress multisito con i tuoi domini e Mailgun.

• Esplora architetture, diagrammi e best practice di riferimento su Google Cloud. Consulta il nostro Cloud Architecture Center.