Website Version Control
|This page requires tidying up! (Consider using More specific cleanup instructions.) Please help improve this page if you can. The talk page may contain suggestions.|
We are bringing the static and custom files on the website into Git to version control them. They are in this repository:
None of the Wordpress or Wiki system files are included in the repository, this allows those systems to be updated automatically, without engaging the version control.
Set up Git on the Web Server
Many instructions on the web suggest setting up the apache user a SSH key to do passwordless git (such as https://github.com/settings/ssh), but instead we will use the git read only URL:
Seeing as we never need to commit from the webserver, this should be fine.
So all we need to do is ensure Git is installed, and configured.
Pull the remote repository
Once the repository on Github is set up and populated, we need to set up the server to pull from it, without deleting loads of things off the server. We can't just do a
as git will complain about untracked files, overwriting, etc. So we need to be a bit sneaky about it.
We are going to be doing this in the main directory (above public_html) as we are also tracking files outside the webroot
First, we create a .gitignore file in the main directory, with just these contents:
This tells git to ignore (and overwrite) any files it likes. It also won't ever complain about untracked files during a commit (although we won't be commiting from here anyway). DANGER do not so this on a local filesystem, unless you like losing files. Don't commit the .gitignore file to the repository, or you will mess up everyone's computer!
Now set the main directory as a git repository
Then add the remote
git remote add origin email@example.com:NottingHack/website.git
Pull the data from git (this won't change any files yet).
Finally, make a new master branch and set it to track the origin master. This will overwrite any files that exist on the webserver with the tracked files, without affecting untracked files. This is what would fail if we hadn't already made the .gitignore file
git checkout --track origin/master
Set up the Update Hook
In the Admin section of the repository, we add the URL of the deploy script to the "WebHook URLs" section. These are the post-receive hooks and each URL will be POSTed to when the repository is updated.