11.3. Rédiger votre demande
Si vous démarrez votre application Rails à partir de zéro, vous devez d'abord installer la gem Rails. Vous pourrez ensuite écrire votre application.
Procédure
Installer la gem Rails :
$ gem install rails
Exemple de sortie
Successfully installed rails-4.3.0 1 gem installed
Après avoir installé la gem Rails, créez une nouvelle application avec PostgreSQL comme base de données :
$ rails new rails-app --database=postgresql
Allez dans le répertoire de votre nouvelle application :
$ cd rails-app
Si vous avez déjà une application, assurez-vous que la gem
pg
(postgresql) est présente dans votreGemfile
. Si ce n'est pas le cas, modifiez votreGemfile
en ajoutant la gemme :gem 'pg'
Générer un nouveau
Gemfile.lock
avec toutes vos dépendances :$ bundle install
Outre l'utilisation de la base de données
postgresql
avec la gempg
, vous devez également vous assurer queconfig/database.yml
utilise l'adaptateurpostgresql
.Assurez-vous d'avoir mis à jour la section
default
dans le fichierconfig/database.yml
, de manière à ce qu'elle ressemble à ceci :default: &default adapter: postgresql encoding: unicode pool: 5 host: localhost username: rails password:
Créez les bases de données de développement et de test de votre application :
$ rake db:create
Cette opération crée les bases de données
development
ettest
dans votre serveur PostgreSQL.
11.3.1. Création d'une page de bienvenue
Étant donné que Rails 4 ne sert plus de page statique public/index.html
en production, vous devez créer une nouvelle page racine.
Pour créer une page de bienvenue personnalisée, il faut suivre les étapes suivantes :
- Créer un contrôleur avec une action d'indexation.
- Créez une page de visualisation pour l'action d'indexation du contrôleur de bienvenue.
- Créez une route qui dessert la page racine des applications avec le contrôleur et la vue créés.
Rails propose un générateur qui réalise toutes les étapes nécessaires pour vous.
Procédure
Exécuter le générateur Rails :
$ rails generate controller welcome index
Tous les fichiers nécessaires sont créés.
modifier la ligne 2 du fichier
config/routes.rb
comme suit :root 'welcome#index'
Exécutez le serveur rails pour vérifier que la page est disponible :
$ rails server
Vous devriez voir votre page en visitant http://localhost:3000 dans votre navigateur. Si vous ne voyez pas la page, vérifiez les journaux qui sont envoyés à votre serveur pour le débogage.
11.3.2. Configuration de l'application pour OpenShift Container Platform
Pour que votre application communique avec le service de base de données PostgreSQL fonctionnant dans OpenShift Container Platform, vous devez modifier la section default
dans votre config/database.yml
pour utiliser les variables d'environnement, que vous devez définir plus tard, lors de la création du service de base de données.
Procédure
Modifiez la section
default
dans votreconfig/database.yml
avec des variables prédéfinies comme suit :Exemple de fichier YAML
config/database
<% user = ENV.key?("POSTGRESQL_ADMIN_PASSWORD") ? "root" : ENV["POSTGRESQL_USER"] %> <% password = ENV.key?("POSTGRESQL_ADMIN_PASSWORD") ? ENV["POSTGRESQL_ADMIN_PASSWORD"] : ENV["POSTGRESQL_PASSWORD"] %> <% db_service = ENV.fetch("DATABASE_SERVICE_NAME","").upcase %> default: &default adapter: postgresql encoding: unicode # For details on connection pooling, see rails configuration guide # http://guides.rubyonrails.org/configuring.html#database-pooling pool: <%= ENV["POSTGRESQL_MAX_CONNECTIONS"] || 5 %> username: <%= user %> password: <%= password %> host: <%= ENV["#{db_service}_SERVICE_HOST"] %> port: <%= ENV["#{db_service}_SERVICE_PORT"] %> database: <%= ENV["POSTGRESQL_DATABASE"] %>
11.3.3. Stockage de votre application dans Git
La construction d'une application dans OpenShift Container Platform nécessite généralement que le code source soit stocké dans un dépôt git, vous devez donc installer git
si vous ne l'avez pas déjà.
Conditions préalables
- Installer git.
Procédure
Assurez-vous d'être dans le répertoire de votre application Rails en exécutant la commande
ls -1
. La sortie de la commande devrait ressembler à ceci :$ ls -1
Exemple de sortie
app bin config config.ru db Gemfile Gemfile.lock lib log public Rakefile README.rdoc test tmp vendor
Exécutez les commandes suivantes dans le répertoire de votre application Rails pour initialiser et valider votre code dans git :
$ git init
$ git add .
$ git commit -m "initial commit"
Une fois que votre application est validée, vous devez la pousser vers un dépôt distant. Compte GitHub, dans lequel vous créez un nouveau dépôt.
Définissez la télécommande qui pointe vers votre dépôt
git
:$ git remote add origin git@github.com:<namespace/repository-name>.git
Poussez votre application vers votre dépôt git distant.
$ git push