Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vojtechvitek/openshift-drupal-settings


https://github.com/vojtechvitek/openshift-drupal-settings

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README 

        
# TESTING .settings repository for Drupal



This repository should be a git submodule of the upstream Drupal git repository itself.



    git submodule add https://github.com/VojtechVitek/openshift-drupal-settings.git .openshift/



Drupal on OpenShift

===================



This Git repository helps you get up and running quickly w/ a Drupal

installation on OpenShift. It defaults to using MySQL, so when creating

the application you'll want to select and install both MySQL and Cron

(for running scheduled tasks). 



    rhc app create drupal php-5 mysql-5 cron



The first time you push changes to OpenShift, the build script

will download the latest stable version of Drupal (currently 7.x) and

install it into the 'downloads' data directory.  It will then create and

deploy a default profile for your application, using MySQL into your

'sites' directory. Any new modules you add or files uploaded to the site

will be placed under this directory. If you want to reconfigure Drupal

from a clean state, delete the 'sites' directory (you may need to add

write permissions to the sites/default directory, which Drupal

automatically makes readonly) and push a non-significant change to your

application Git repo.



Because none of your application code is checked into Git and lives

entirely in your data directory, if this application is set to scalable

the new gears will have empty data directories and won't serve requests

properly.  If you'd like to make the app scalable, you'll need to:



1. Check the contents of php/* into your Git repository (in the php/*

   dir)

2. Only install new modules via Drush from the head gear, and then

   commit those changes to the Git repo

3. Use a background task to copy file contents from gear to gear



All of the scripts used to deploy and configure Drupal are located in

the [build](.openshift/action_hooks/build) and [deploy](.openshift/action_hooks/deploy) hooks.



Using Drush

-----------



The Drush management tool for Drupal is automatically installed

and you can simply use it while ssh'd into your gear.



    rhc ssh drupal

    drush --help



Drush has many helpful commands for managing your installation, such as:



    drush dl 	# Download module/theme

    drush en 	# Enable module/theme

    drush dis 	# Disable module/theme

    drush cc all	# Clear all cache

    drush core-cron     # Run cron

    drush updb		# Apply database updates



Running on OpenShift

--------------------



Create an account at http://openshift.redhat.com/



Create a php-5.3 application with MySQL and Cron support.



    rhc app create drupal php-5.3 mysql-5 cron --from-code=git://github.com/openshift/drupal-quickstart.git



That's it, you can now checkout your application at:

    http://drupal-$yournamespace.rhcloud.com



Default Credentials

-------------------



Default Admin Usernameadmin

Default Admin Passwordopenshift_changeme



Updates

-------



You can use Drupal's module management UI to download new versions of

modules into your data directory.



Repo layout

-----------



php/ - At deploy time, the build script will symlink this directory to a

directory containing Drupal  

../data - For persistent data  

../data/sites - The data for your Drupal site, including settings.php,

downloaded modules, and uploaded files  

../data/downloads - The most recent version of Drupal.  

deplist.txt - list of pears to install  

.openshift/action_hooks/build - Script that gets run every push, just prior to starting your app  



Notes about layout

------------------



If you create a php directory in your Git repo, it will be served

instead of Drupal.  The build hook automatically symlinks the installed

version of Drupal from your data directory every time you push.  The

runtime directory in your application is automatically recreated each

push, so anything persistent must be in your Git repo or saved and

retrieved from the data directory.