Utiliser Cloud SQL pour MySQL avec Rails 5

Commencez à développer des applications Ruby on Rails qui s'exécutent dans l'environnement flexible App Engine. Les applications créées sont exécutées sur l'infrastructure sur laquelle sont basés tous les produits Google, vous avez la garantie d'un dimensionnement efficace, à même de desservir l'ensemble de vos utilisateurs, qu'ils soient une poignée ou plusieurs millions.

Dans ce tutoriel, nous partons du principe que vous connaissez bien le développement Web avec Rails. Il vous explique comment configurer Cloud SQL pour MySQL avec une nouvelle application Rails. Vous pouvez également utiliser ce tutoriel comme référence pour la configuration d'applications Rails existantes afin d'utiliser Cloud SQL pour MySQL.

Ce tutoriel nécessite Ruby 2.3.4 ou une version ultérieure.

Avant de commencer

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud SQL Admin API.

   Enable the API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

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

   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

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud SQL Admin API.

   Enable the API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Préparer Cloud SQL pour une instance MySQL

Configurez Cloud SQL pour une instance MySQL pour ce tutoriel :

1. Créez une instance de deuxième génération. Dans le cadre de ce tutoriel, le nom de l'instance est rails-cloudsql-instance.

2. Créez une base de données dans l'instance. Dans le cadre de ce tutoriel, le nom de la base de données de production est cat_list_production.

3. Définissez un mot de passe pour l'utilisateur racine de l'instance.

Configurer votre environnement local pour Rails

Pour configurer votre environnement local pour ce tutoriel, procédez comme suit :

1. Installez Ruby version 2.3.4 ou version ultérieure.

2. Installez le gem Rails 5.

3. Installez le gem Bundler.

Remarque:Vous pouvez également utiliser Cloud Shell, fourni avec Ruby, Rails, Bundler et la CLI Google Cloud installée.

Pour obtenir plus d'informations sur l'installation de Rails et de ses dépendances, reportez-vous au guide officiel Getting started with Rails.

Une fois les étapes préalables effectuées, créez et déployez une application Rails à l'aide de Cloud SQL pour MySQL. Les sections suivantes vous guident dans les étapes de configuration, de connexion à Cloud SQL pour MySQL et de déploiement d'une application.

Créer une application pour répertorier des chats

1. Exécutez la commande rails new afin de créer une application Rails. Cette application stocke une liste de chats dans Cloud SQL pour MySQL.

   rails new cat_sample_app
   

2. Accédez au répertoire contenant l'application Rails générée.

   cd cat_sample_app
   

Exécuter l'application en local

Pour exécuter la nouvelle application Rails sur votre ordinateur local :

1. Installez les dépendances avec Bundler :

   bundle install
   

2. Démarrez un serveur Web local :

   bundle exec bin/rails server
   

3. Dans un navigateur Web, accédez à http://localhost:3000/

Un message Yay! You're on Rails! (Bravo ! Vous êtes sur Rails !), généré par l'application, s'affiche sur la page.

Remarque : Pour quitter le serveur Web, appuyez sur Ctrl+C dans la fenêtre de terminal.

Générer un scaffold (échafaudage) pour répertorier des chats

Générez un scaffold pour une ressource nommée Cat qui servira à répertorier les chats avec leur nom et leur âge.

1. Générez le scaffold.

   bundle exec rails generate scaffold Cat name:string age:integer
   

   Cette commande génère un modèle, un contrôleur et des vues pour la ressource Cat.

   invoke  active_record
   create    db/migrate/20170804210744_create_cats.rb
   create    app/models/cat.rb
   invoke    rspec
   create      spec/models/cat_spec.rb
   invoke  resource_route
   route    resources :cats
   invoke  scaffold_controller
   create    app/controllers/cats_controller.rb
   invoke    erb
   create      app/views/cats
   create      app/views/cats/index.html.erb
   create      app/views/cats/edit.html.erb
   create      app/views/cats/show.html.erb
   create      app/views/cats/new.html.erb
   create      app/views/cats/_form.html.erb
   invoke    jbuilder
   create      app/views/cats/index.json.jbuilder
   create      app/views/cats/show.json.jbuilder
   create      app/views/cats/_cat.json.jbuilder
   invoke  assets
   invoke    js
   create      app/assets/javascripts/cats.js
   invoke    scss
   create      app/assets/stylesheets/cats.scss
   invoke  scss
   create    app/assets/stylesheets/scaffolds.scss
   

2. Ouvrez le fichier config/routes.rb pour voir le contenu généré, reproduit ci-dessous.

   appengine/rails-cloudsql-mysql/config/routes.rb

   Afficher sur GitHub

   Rails.application.routes.draw do
     resources :cats
     get 'cats/index'
     # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html
   
   end

3. Ajoutez root 'cats#index' au fichier.

   appengine/rails-cloudsql-mysql/config/routes.rb

   Afficher sur GitHub

   Rails.application.routes.draw do
     resources :cats
     get 'cats/index'
   
     # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html
     root 'cats#index'
   end

4. Enregistrez le fichier, puis fermez-le.

5. Testez l'application Rails comme indiqué précédemment.

Utiliser Cloud SQL pour MySQL avec App Engine

Cloud SQL pour MySQL est un service de base de données entièrement géré qui permet de configurer, entretenir, gérer et administrer vos bases de données relationnelles MySQL dans Google Cloud. Vous pouvez utiliser Cloud SQL dans une application Rails comme toute autre base de données relationnelle.

Configurer Cloud SQL pour MySQL

Pour commencer à utiliser Cloud SQL avec votre application Rails en production :

1. Ajoutez les gems mysql2 et appengine au fichier Gemfile.

   bundle add mysql2
   bundle add appengine
   

   Le fichier Rails Gemfile contient les entrées gem supplémentaires suivantes :

   appengine/rails-cloudsql-mysql/Gemfile

   Afficher sur GitHub

   # Added at 2017-08-07 11:54:06 -0700 by USER:
   gem "mysql2", "~> 0.4.8"
   
   # Added at 2017-08-07 11:54:12 -0700 by USER:
   gem "appengine", "~> 0.4.1"

   Remarque : Le gem appengine fournit une tâche Rake pour exécuter les migrations de bases de données en production.

2. Pour configurer l'application Rails afin qu'elle se connecte à Cloud SQL, ouvrez le fichier config/database.yml. Les paramètres de base de données réutilisables ci-dessous, définis pour SQLite, s'affichent :

   appengine/rails-cloudsql-mysql/config/boilerplate.database.yml

   Afficher sur GitHub

   # SQLite version 3.x
   #   gem install sqlite3
   #
   #   Ensure the SQLite 3 gem is defined in your Gemfile
   #   gem 'sqlite3'
   #
   default: &default
     adapter: sqlite3
     pool: 5
     timeout: 5000
   
   development:
     <<: *default
     database: db/development.sqlite3
   
   # Warning: The database defined as "test" will be erased and
   # re-generated from your development database when you run "rake".
   # Do not set this db to the same as development or production.
   test:
     <<: *default
     database: db/test.sqlite3
   
   production:
     <<: *default
     database: db/production.sqlite3

3. Configurez le nom de connexion de l'instance Cloud SQL pour l'environnement de production App Engine.

   1. Récupérez le nom de connexion de l'instance.

      gcloud sql instances describe rails-cloudsql-instance
      

   2. Copiez la valeur en regard de connectionName.

4. Modifiez la configuration de la base de données de production database.yml comme suit :

   appengine/rails-cloudsql-mysql/config/database.yml

   Afficher sur GitHub

   production:
     adapter: mysql2
     pool: 5
     timeout: 5000
     username: "[YOUR_MYSQL_USERNAME]"
     password: "[YOUR_MYSQL_PASSWORD]"
     database: "cat_list_production"
     socket:   "/cloudsql/[YOUR_INSTANCE_CONNECTION_NAME]"

   Où :

   • [YOUR_MYSQL_USERNAME] représente votre nom d'utilisateur MySQL.
   • [YOUR_MYSQL_PASSWORD] représente votre mot de passe MySQL.
   • [YOUR_INSTANCE_CONNECTION_NAME] représente le nom de connexion de l'instance que vous avez copié à l'étape précédente.

L'application Rails est désormais configurée pour utiliser Cloud SQL lors du déploiement dans l'environnement flexible App Engine.

Déployer l'application dans l'environnement flexible App Engine

L'environnement flexible App Engine utilise un fichier appelé app.yaml pour décrire la configuration de déploiement d'une application. Si ce fichier n'est pas présent, la CLI gcloud tente de deviner la configuration du déploiement. Cependant, vous devez définir ce fichier pour fournir les paramètres de configuration requis pour la clé secrète Rails et pour Cloud SQL.

Pour configurer l'exemple d'application en vue du déploiement sur App Engine, créez un fichier nommé app.yaml à la racine du répertoire de l'application Rails et ajoutez-y les lignes suivantes :

appengine/rails-cloudsql-mysql/app.yaml

Afficher sur GitHub

entrypoint: bundle exec rackup --port $PORT
env: flex
runtime: ruby

Configurer la clé secrète Rails dans le fichier app.yaml

Lorsqu'une application Rails est déployée dans l'environnement production, définissez la variable d'environnement SECRET_KEY_BASE sur une valeur de clé secrète afin de protéger les données de session des utilisateurs. Cette variable d'environnement est lue à partir du fichier config/secrets.yml dans votre application Rails.

1. Générez une nouvelle clé secrète.

   bundle exec bin/rails secret
   

2. Copiez la clé secrète générée.

3. Ouvrez le fichier app.yaml que vous avez créé précédemment et ajoutez une section env_variables. Le fichier env_variables définit les variables d'environnement dans l'environnement flexible App Engine. Le fichier app.yaml doit alors ressembler à l'exemple suivant, la valeur de [SECRET_KEY] étant remplacée par votre clé secrète.

   appengine/rails-cloudsql-mysql/app.yaml

   Afficher sur GitHub

   entrypoint: bundle exec rackup --port $PORT
   env: flex
   runtime: ruby
   
   env_variables:
     SECRET_KEY_BASE: [SECRET_KEY]

Configurer l'instance Cloud SQL dans le fichier app.yaml

Ensuite, configurez l'environnement flexible App Engine pour utiliser l'instance Cloud SQL spécifiée. Pour cela, indiquez le nom de connexion de l'instance Cloud SQL dans le fichier de configuration app.yaml.

1. Ouvrez le fichier app.yaml et ajoutez une section appelée beta_settings.

2. Définissez un paramètre imbriqué cloud_sql_instances ayant comme valeur le nom de connexion de l'instance.

   Remarque : Vous pouvez récupérer le nom de connexion de l'instance Cloud SQL en exécutant gcloud sql instances describe rails-cloudsql-instance.

   Le fichier app.yaml doit ressembler à ceci :

   appengine/rails-cloudsql-mysql/app.yaml

   Afficher sur GitHub

   entrypoint: bundle exec rackup --port $PORT
   env: flex
   runtime: ruby
   
   env_variables:
     SECRET_KEY_BASE: [SECRET_KEY]
   
   beta_settings:
     cloud_sql_instances: [YOUR_INSTANCE_CONNECTION_NAME]

Créer une application d'environnement flexible App Engine

Si vous déployez une application pour la première fois, vous devez créer une application d'environnement flexible App Engine et sélectionner la région dans laquelle vous souhaitez exécuter l'application Rails.

1. Créez une application App Engine.

   gcloud app create
   

2. Sélectionnez une région prenant en charge l'environnement flexible App Engine pour les applications Ruby. Obtenez plus d'informations sur les régions et les zones.

Déployer une nouvelle version

Déployez ensuite une nouvelle version de l'application Rails décrite dans le fichier app.yaml sans rediriger le trafic depuis la version de diffusion par défaut actuelle.

1. Précompilez les éléments Rails.

   bundle exec bin/rails assets:precompile
   

2. Une fois la compilation de ces éléments terminée, déployez une nouvelle version de l'application.

   gcloud app deploy --no-promote
   

   Le déploiement peut prendre quelques minutes. Attendez qu'un message de réussite apparaisse. Vous pouvez afficher les versions déployées dans la liste des versions d'App Engine.

Avertissement : Les anciennes versions de votre application sont conservées, tout comme les instances de VM associées. Sachez que toutes ces versions d'application et instances de VM sont des ressources facturables.

Une fois que vous avez déployé la nouvelle version, si vous tentez d'y accéder, le message d'erreur suivant s'affiche car vous n'avez pas migré la base de données.

Accorder l'autorisation d'accès au gem appengine

Ensuite, accordez l'accès au compte de service cloudbuild pour exécuter des migrations de base de données de production à l'aide du appengine.

1. Répertoriez les projets disponibles.

   gcloud projects list
   

2. Dans le résultat, recherchez le projet que vous souhaitez utiliser pour déployer votre application et copiez le numéro de projet associé.

3. Ajoutez un membre à la stratégie IAM de votre projet afin d'autoriser le rôle roles/editor à exécuter des migrations de base de données. Remplacez [YOUR-PROJECT-ID] par l'ID de votre projet Google Cloud et [PROJECT_NUMBER] par le numéro de projet que vous avez copié à l'étape précédente.

   gcloud projects add-iam-policy-binding [YOUR-PROJECT-ID] \
     --member=serviceAccount:[PROJECT_NUMBER]@cloudbuild.gserviceaccount.com \
     --role=roles/editor
   

Migrer votre base de données Rails

Les migrations de base de données Rails permettent de mettre à jour le schéma de votre base de données sans utiliser directement la syntaxe SQL. Vous allez ensuite migrer votre base de données cat_list_production.

Le gem appengine fournit la tâche Rake appengine:exec qui permet d'exécuter une commande sur la dernière version déployée pour votre application dans l'environnement flexible App Engine de production.

1. Migrez en production la base de données cat_list_production Cloud SQL pour MySQL.

   bundle exec rake appengine:exec -- bundle exec rake db:migrate
   

   Un résultat semblable à celui-ci s'affiche :

   ---------- EXECUTE COMMAND ----------
   bundle exec rake db:migrate
   Debuggee gcp:787021104993:8dae9032f8b02004 successfully registered
   == 20170804210744 CreateCats: migrating =======================================
   -- create_table(:cats)
      -> 0.0219s
   == 20170804210744 CreateCats: migrated (0.0220s) ==============================
   
   ---------- CLEANUP ----------
   

   Remarque : Si une erreur d'autorisation survient lors d'une tentative d'exécution de migrations de base de données, vous devez vérifier que [PROJECT_NUMBER]@cloudbuild.gserviceaccount.com détient bien le rôle roles/editor.

2. Pour vérifier la migration de la base de données, accédez à :

   [YOUR-VERSION]-dot-[YOUR-PROJECT-ID].appspot.com
   

   Remarque : Pour obtenir la liste des versions, utilisez la commande gcloud app versions list. Le dernier élément default de version de service correspond au déploiement le plus récent.

Si le déploiement a réussi, les éléments suivants s'affichent :

Migrer le trafic vers une nouvelle version

Enfin, dirigez le trafic vers la version nouvellement déployée à l'aide de la commande suivante :

gcloud app services set-traffic default --splits [YOUR-VERSION]=1

La nouvelle version de l'application est désormais accessible depuis :

https://[YOUR-PROJECT-ID].appspot.com

Lire les journaux App Engine

Maintenant que vous avez déployé votre application Rails, vous souhaiterez peut-être en consulter les journaux. Vous pouvez lire les journaux d'une application à l'aide de l'explorateur de journaux situé dans Google Cloud Console.

Pour en savoir plus, consultez la section consacrée à la lecture des journaux à l'aide de la CLI gcloud.

Effectuer un nettoyage des ressources

Une fois le tutoriel terminé, vous pouvez procéder au nettoyage des ressources que vous avez créées afin qu'elles ne soient plus comptabilisées dans votre quota et qu'elles ne vous soient plus facturées. Dans les sections suivantes, nous allons voir comment supprimer ou désactiver ces ressources.

Supprimer le projet

Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.

Pour supprimer le projet :

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Supprimer une version App Engine

Pour supprimer une version d'application :

1. In the Google Cloud console, go to the Versions page for App Engine.

   Go to Versions

2. Select the checkbox for the non-default app version that you want to delete.
   Note : Le seul moyen de supprimer la version par défaut de votre application App Engine consiste à supprimer votre projet. Vous pouvez toutefois arrêter la version par défaut dans la console Google Cloud. Cette opération a pour effet d'arrêter toutes les instances associées à la version. Vous pourrez redémarrer ces instances ultérieurement si nécessaire.

   Dans l'environnement standard App Engine, vous ne pouvez arrêter la version par défaut que si vous avez spécifié le scaling manuel ou de base pour votre application.

3. Pour supprimer la version de l'application, cliquez sur  Supprimer.

Supprimer une instance Cloud SQL

Pour supprimer une instance Cloud SQL :

1. In the Google Cloud console, go to the Instances page.

   Go to Instances

2. Click the name of the SQL instance you that want to delete.
3. To delete the instance, click Delete, and then follow the instructions.

Étape suivante

• Découvrez comment exécuter l'exemple d'application Ruby Bookshelf dans l'environnement flexible App Engine.

• Découvrez comment exécuter l'exemple d'application Ruby Bookshelf sur Compute Engine.

• Découvrez comment exécuter l'exemple d'application Ruby Bookshelf sur Google Kubernetes Engine.