No Description
Roeland Jago Douma 984c25d781
Merge pull request #211 from nextcloud/stable16
1 day ago
config Roll out 16.0.0 on beta channel 1 day ago
docs Deploy updater server on webhook 1 week ago
src deliver whats-new info also to pre-releases 8 months ago
tests Roll out 16.0.0 on beta channel 1 day ago
vendor Add autoloader 2 years ago
.gitignore Deploy updater server on webhook 1 week ago
.htaccess Initial import 2 years ago
.travis.yml Manually require PHPUnit 5.7 2 years ago
LICENSE Initial import 2 years ago
README.md Deploy updater server on webhook 1 week ago
composer.json Deploy updater server on webhook 1 week ago
index.php Deploy updater server on webhook 1 week ago

README.md

This is the server that is called from Nextcloud to check if a new version of the server is available.

How to release a new update

  1. Adjust config/config.php for the update
  2. Adjust tests/integration/features/update.feature for the integration tests

If the tests are not passing the TravisCI test execution will fail.

Example calls

Deployed URL: https://updates.nextcloud.org/updater_server/ Example call: updater_server/?version=9x0x0x12x1448709225.0768x1448709281xstablexx2015-10-19T18:44:30+00:00%208ee2009de36e01a9866404f07722892f84c16e3e

<?xml version="1.0" encoding="UTF-8"?>
<nextcloud>
 <version>9.0.51</version>
 <versionstring>Nextcloud 9.0.51</versionstring>
 <url>https://download.nextcloud.com/server/releases/nextcloud-9.0.51.zip</url>
 <web>https://docs.nextcloud.org/server/9/admin_manual/maintenance/upgrade.html</web>
</nextcloud>

Webhook deployment

If you wish to receive webhooks and then automatically deploy the lastest version of the updater server there is one special API endpoint available.

For this the Github Webhook needs to be configured to send push events to the endpoint /hook of the updater server. There only the ending part is crucial. That means that any URL ending in /hook which is served by the index.php of the updater server will trigger this behaviour.

Configure a webhook on Github in the repository of choice with application/json as content type, a random secret and the push event to be sent.

Then place a file config/secrets.php (see config/secrets.dist.php as example) with the same secret and the branch it should trigger on.

Once this is done the updater server will run a git pull in the directory of the index.php every time a valid event comes which matches the secret and then branch name. Keep in mind that the directory needs to be writable by the user under which PHP runs (most likely the webserver user).