Koha-clms/debian
Tomas Cohen Arazi 222496f045 Bug 17030: Make REST api available on packages with plack enabled
This patch is the starting point for making the REST api available
on Plack.

What it does:
- It creates the /api/v1/app.pl mount point in plack.psgi
- It enables the ProxyPass and ProxyPassReverse directives so it
  is reached through Plack.
- It sets rewrite rules so we can use the 'pretty' urls (i.e.
  /api/v1/patrons instead of /api/v1/app.pl/api/v1/patrons).

To test:
- Grab the following files, and put them in /etc/koha (overwrite the existing ones)
  debian/templates/apache-shared-intranet-plack.conf
  debian/templates/apache-shared-opac-plack.conf
- Tweak your /etc/koha/sites/kohadev/plack.psgi file so the API-related stuff
  is present on your file.
- Make sure Plack is enabled for the instance:
  $ sudo koha-plack --enable kohadev
  $ sudo koha-plack --restart kohadev
  $ sudo service apache2 restart
- Follow the previous patch test plan, but use this URLs (no pretty URL):

  http://localhost:8080/api/v1/app.pl/api/v1/patrons/50
  http://localhost:8081/api/v1/app.pl/api/v1/patrons/50
=> SUCCESS: You get a JSON response from the API [1]
- Not use this URLs:
  http://localhost:8080/api/v1/patrons/50
  http://localhost:8081/api/v1/patrons/50
=> SUCCESS: You get a JSON response from the API [1]
- Sign off :-D

[1] this patch made a bug visible (the session is lost when accessing the API through
Plack) but it shouldn't prevent its inclusion because the API right now is not even available
as default for developers to test or fix it.

Signed-off-by: Benjamin Rokseth <benjamin.rokseth@kul.oslo.kommune.no>

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
(cherry picked from commit e4bb70a447)
Signed-off-by: Frédéric Demians <f.demians@tamil.fr>
2016-08-08 16:46:13 +02:00
..
docs Bug 16016: Sitemap handling scripts for packages 2016-05-04 13:34:21 +00:00
scripts Bug 16830: Remove -x usage on koha-indexer 2016-08-05 12:56:23 +02:00
source Switch to native source format. 2010-05-25 07:57:37 -04:00
templates Bug 17030: Make REST api available on packages with plack enabled 2016-08-08 16:46:13 +02:00
README.build Bug 5602: Changes to account for the version update. 2011-08-04 10:26:39 +12:00
bd-to-depends Bug 4847: Remove the python dependency for package builds 2015-03-25 11:22:49 -03:00
build-git-snapshot Bug 17013 - build-git-snapshot: add basetgz parameter and update master version number 2016-08-08 16:41:00 +02:00
changelog Changelog update for 3.22.00~beta 2015-11-17 23:41:16 -03:00
compat Replace old, non-functional Debian packaging with a new one. 2010-04-16 00:41:54 -04:00
control Bug 17063 - debian/control.in update: change maintainer & add libhtml-parser-perl for 16.05.x 2016-08-06 11:57:29 +02:00
control.in Bug 17063 - debian/control.in update: change maintainer & add libhtml-parser-perl for 16.05.x 2016-08-06 11:57:29 +02:00
copyright Update FSF address in debian/copyright. 2010-06-02 07:14:43 -04:00
koha-common.README.Debian Bug 5139 - packages now do email and other cron jobs 2010-10-06 08:12:14 -04:00
koha-common.bash-completion Bug 14727: koha-indexer tab completion in bash 2015-10-13 11:37:55 -03:00
koha-common.config Bug 11404: (follow-up) only ask user if there are instances needing upgrading 2014-05-19 21:51:33 +00:00
koha-common.cron.d Bug 16823 - Comment out koha-rebuild-zebra in koha-common.cron.d 2016-08-01 10:47:58 +02:00
koha-common.cron.daily Bug 14840: Added new cron script send membership expiry reminder notices in crontab.example file 2015-10-06 11:21:18 -03:00
koha-common.cron.hourly Add koha-foreach, a script to run a command for each Koha instance. 2010-05-25 07:59:45 -04:00
koha-common.cron.monthly Bug 13585: Add a cronjob which send UsageStats monthly. 2015-09-07 10:47:06 -03:00
koha-common.default Bug 16830: Remove -x usage on koha-indexer 2016-08-05 12:56:23 +02:00
koha-common.dirs Split off koha-common. 2010-05-25 07:58:56 -04:00
koha-common.docs Bug 10802: make Debian package install history.txt 2013-09-16 15:27:16 +00:00
koha-common.init Bug 13791: make koha-common init script aware of plack 2015-08-24 13:00:41 -03:00
koha-common.install Bug 16016: Sitemap handling scripts for packages 2016-05-04 13:34:21 +00:00
koha-common.logrotate Bug 16138: Restart plack when rotating logfiles 2016-04-01 18:47:01 +00:00
koha-common.postinst Bug 14106: (QA followup) avoid failures if no instances created 2015-05-22 12:28:14 -03:00
koha-common.preinst Bug 14068: fix preinst for fresh package installs 2015-04-29 15:14:10 -03:00
koha-common.templates Bug 11404: Make the install process aware of the changes 2014-05-19 21:50:54 +00:00
koha-post-install-setup Add koha-post-install-setup, a script to be run by sysadmin post-install. 2010-05-25 07:59:19 -04:00
koha.README.Debian Bug 5550 - correct filename referenced in docs 2011-01-01 07:43:30 +13:00
koha.apache-ports Replace old, non-functional Debian packaging with a new one. 2010-04-16 00:41:54 -04:00
koha.config Replace old, non-functional Debian packaging with a new one. 2010-04-16 00:41:54 -04:00
koha.dirs Replace old, non-functional Debian packaging with a new one. 2010-04-16 00:41:54 -04:00
koha.install Bug 7818 : Following, fixing so the packages build Still need to update koha-create to make use of the new file 2012-07-06 11:17:19 +02:00
koha.postinst Bug 4817: Point to README.Debian in koha package description, postinst output. 2010-05-27 05:19:03 -04:00
koha.postrm When purging, remove /var/log/koha. 2010-04-22 06:15:31 -04:00
koha.prerm Replace old, non-functional Debian packaging with a new one. 2010-04-16 00:41:54 -04:00
list-deps Bug 17017 Dependency fixes for 16.05 2016-08-02 17:24:50 +02:00
rules Bug 14167: remove the log4perl.conf file from /etc for packages 2015-07-24 12:54:23 -03:00
unavailable.html Add koha-disable, a script to disable a Koha instance. 2010-05-25 07:59:29 -04:00
update-control Add tools to update debian/control's build dependencies. 2010-06-02 07:14:36 -04:00

README.build

In order to build .deb packages, following debian packages need to be present
(installed): 
devscripts
pbuilder
dh-make
fakeroot

As root (or sudo) execute:
pbuilder create

Executing build-git-snapshot without any arguments will leave package and the
rest in some pbuilder dir, eg. /var/cache/pbuilder/result It is highly
recommended that --buildresult option is used.