zeip / kada Goto Github PK

The project is licensed under the same license as Drupal itself, namely GNU General Public License 2 or later.

KADA Drupal distribution. Copyright © 2017 City of Turku, http://www.turku.fi/, [email protected]

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA

Projekti on lisensoitu samalla lisenssisopimuksella kuin Drupal itsessään, eli GNU Yleinen Lisenssi (GNU General Public License) 2 tai myöhempi.

KADA-Drupal-jakelu Tekijänoikeus © 2017 Turun kaupunki, http://www.turku.fi/, [email protected]

Tämä ohjelma on vapaa; tätä ohjelmaa on sallittu levittää edelleen ja muuttaa GNU yleisen lisenssin (GPL-lisenssin) ehtojen mukaan sellaisina kuin Free Software Foundation on ne julkaissut; joko Lisenssin version 2, tai (valinnan mukaan) minkä tahansa myöhemmän version mukaisesti.

Tätä ohjelmaa levitetään siinä toivossa, että se olisi hyödyllinen, mutta ilman mitään takuuta; ilman edes hiljaista takuuta kaupallisesti hyväksyttävästä laadusta tai soveltuvuudesta tiettyyn tarkoitukseen. Katso GPL-lisenssistä lisää yksityiskohtia.

Tämän ohjelman mukana pitäisi tulla kopio GPL-lisenssistä; jos näin ei ole, kirjoita osoitteeseen Free Software Foundation Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

The platform developers use Slack as the primary communication method. If you want to join the Slack channel, contact [email protected] or any current developer of the platform for an invitation. The Slack is free to join for all.

Some instructions which are not related to the vagrant nor ansible setup.

	builds
		- Contains built codebases, preserves history
	code
		modules
			- IMPORTANT: Use tkufi_ prefix with custom and feature modules
			custom
				- Custom modules directory
				- Symlinked from current codebase build when in development
			features
				- Features directory
				- Symlinked from current codebase build when in development
		profiles
			kadaprofile
				- KADA Drupal install profile
				- Symlinked from current codebase build when in development
		themes
			custom
				driveturku
					- DriveTurku theme
					- Symlinked from current codebase build when in development
	conf
		_ping.php
			- Is copied to Drupal root during build
		dev.settings.php
			- Settings for develop environment
		kadaproject.make
			- Drush make file that defines what drupal core, contrib modules / themes and libraries are used in the project
			- Each additional dependency must be set into this file as contrib code is not in version control
		robots.txt
			- Prevents indexing of set paths
		site.yml
			- Configures custom build.sh behaviour for each environment
		vagrant.settings.php
			- Settings for local environment
	current
		- Current build code
	files
		- Actual location for sites/default/files
	patches
		- Local patches that are not in any drupal.org issue queue
	build.sh
		- Custom project build script
		- Use when checking out code that has new contrib dependencies
		- Behaviour of this script depends on conf/site.yml
	kada.aliases.drushrc.php
		- Project drush aliases
	kada_devsync.sh
		- Syncs sql and files from development
	drush.sh
		- Is supposed to be used when running build outside vagrant box (not tested, better to login to vagrant and build there for now)

Note, this assumes you already did a successful "vagrant up".

1. Go to inside the box

   $ vagrant ssh
   

2. Build Drupal from the make file

   $ cd /vagrant/drupal
   $ ./build.sh new
   

3. Do a site-install at http://local.kada.fi/install.php?profile=kadaprofile (try with port 8080 if varnish is preventing install).

• Choose some features to enable during install
• Events base feature is not yet working with the site-install
• Domains will give notice during install, can be ignored
• If you get timeouts, just refresh the page and batch process will continue

4. When install is finished, visit the site at http://local.kada.fi

• The cache has to be rebuilt and features reverted, probably a couple of times before things start working
• If some database error occurs due to missing module, add the module to correct feature's .info file.

5. Enable User feature and revert it

• drush en tkufi_user_feature -y; drush fr tkufi_user_feature -y
• You can login with editor:secretpass to see what a content editor has access to

Copy your own SSH public key to Vagrant's authorized keys (to make it easy to connect with Sequel Pro for example)

$ pbcopy < ~/.ssh/id_rsa.pub (copies the public key to clipboard)
$ vagrant ssh
$ vi ~/.ssh/authorized_keys (paste the contents of your publickey to the end of this file)

There is a script for syncing database + files from development.

From the project root:

$ ./drupal/kada_devsync.sh

After syncing database and files, syncscript runs additional commands, like downloads+enables Devel module.

All the tools required for managing the development environment are built into the vagrant box and means that all of these commands mentioned below should be run inside the vagrant box. You can access the vagrant box with:

$ vagrant ssh

Build is needed when there is changes (or vanilla project repo checkout) made in drush make file. And if in doubt after checking out some other people's code, there is no harm done if you run this command (unless you have done something not so cool like modified core / contrib code).

Also you should be syncing database from develop environment frequently to ensure that you have most up to date database. This way you should be able to avoid adding unnecessary changes into feature recreates.

$ cd <PROJECT_ROOT>
$ ./build.sh update

After build is done, it's advised to run bunch of drush commands to ensure that database is in the same state as in the feature code.

$ cd <PROJECT_ROOT>/current
$ drush fra -y && drush fra -y && drush cc all

Feature revert is ran twice as we have notices that for some reason features might not get reverted in first run.

• Contains update hooks for feature / module enabling

• Naming: kada_NAME
• Avoid creating custom modules or if you really have to, please consult other developers first

• Naming: kada_NAME_feature
• Should contain update hooks to enable additional modules related to feature change
• Feature specific custom code can be inserted into *.module instead of creating custom modules
• Fill out changes and other important notes into README.txt file in the feature directory (if you need template, look at tkufi_page_feature)
• ALWAYS RECREATE FEATURES AND SAVE VIEWS IN ENGLISH!!! (make sure there is /en prefix in the path, otherwise all views translations and such will be exported to code in Finnish)