Deployment (moved): Difference between revisions
Content added Content deleted
imported>Mdaniel m (Mdaniel moved page Deployment to Deployment (moved): Documentation in migration process) |
imported>Mdaniel (deprecation process in favor of sphinx and readthedocs) |
||
| Line 1: | Line 1: | ||
{{Hacking OpenHatch}} |
{{Hacking OpenHatch}} |
||
We are updating our documentation system. This page is now included in our project package, and is automatically generated by sphinx at openhatch.readthedocs.org [http://openhatch.readthedocs.org/en/latest/deployment/deployment.html] |
|||
This is a quick-and-dirty page explaining how to deploy new versions of the OpenHatch code. |
|||
== Prerequisites == |
|||
* You must be part of the [[Login team]] (so your SSH key is available in Github and you're in the openhatch-committers group, and also that your SSH key is in the deploy@linode.openhatch.org account's .ssh/authorized_keys) |
|||
* You must be at a computer with that SSH key |
|||
* Deploying takes about 3 minutes, maybe less if things go well. (If there are database migrations to run, it can take dramatically longer.) |
|||
== How the deploy script works == |
|||
You need to have these programs installed: '''ssh''', '''git'''. |
|||
The script does two things: |
|||
* Push your current git HEAD onto origin/master. |
|||
* SSHs (once) to the linode, where it runs mysite/scripts/deploy_myself.sh which updates the site. |
|||
== Recommended way to use the deploy script == |
|||
* Make sure .git/config says that the ''url'' for ''origin'' is: |
|||
git@github.com:openhatch/oh-mainline.git |
|||
* <code>git fetch</code> # get the latest |
|||
* <code>git checkout origin/master -b deploy_me</code> # create a deploy_me branch |
|||
* Then get the patch file with e.g. wget, and do |
|||
* <code>git am /path/to/the/patch.file</code> # Import the patch into current branch, probably called deploy_me |
|||
* Then "git log" and sanity-check it |
|||
* If you like it, do |
|||
cd mysite |
|||
./scripts/deploy |
|||
* It's really important to make the separate branch so that you don't accidentally push random local work into the live site. |
|||
Revision as of 03:58, 18 June 2012
This is a page about improving or modifying OpenHatch.
We call that "Hacking OpenHatch," and there is a whole category of pages about that.
We are updating our documentation system. This page is now included in our project package, and is automatically generated by sphinx at openhatch.readthedocs.org [1]