Merge branch 'update-docs' into 'master'

Update install and update documentation for 7.13

@JobV Please push directly to this branch and merge if ok.

See merge request !199

doc/install/installation.md

@@ -119,6 +119,9 @@ We recommend PostgreSQL but you can also use MySQL
     # Development
     #sudo -u gitlab_ci -H cp config/application.yml.example.development config/application.yml
+    # Copy the example secrets file
+    sudo -u gitlab_ci -H cp config/secrets.yml.example config/secrets.yml
+
     # Edit web server settings
     sudo -u gitlab_ci -H cp config/unicorn.rb.example config/unicorn.rb
     sudo -u gitlab_ci -H editor config/unicorn.rb
@@ -129,6 +132,9 @@ We recommend PostgreSQL but you can also use MySQL
     sudo -u gitlab_ci -H mkdir -p tmp/pids/
     sudo chmod -R u+rwX  tmp/pids/
+    # Change the permissions of the directory where build traces are stored
+    sudo chmod -R u+rwX builds/
+
     # Make sure GitLab CI can write to the builds/ directory
     sudo chmod -R u+rwX  builds
@@ -157,8 +163,13 @@ We recommend PostgreSQL but you can also use MySQL
     # Setup schedules
     sudo -u gitlab_ci -H bundle exec whenever -w RAILS_ENV=production
-## 7. Install Init Script
+### Secure secrets.yml
+
+The `secrets.yml` file stores encryption keys for sessions and secure variables.
+Backup `secrets.yml` someplace safe, but don't store it in the same place as your database backups.
+Otherwise your secrets are exposed if one of your backups is compromised.
+## 8. Install Init Script
 Copy the init script (will be /etc/init.d/gitlab_ci):

doc/raketasks/backup_restore.md

@@ -129,7 +129,7 @@ If you have a cookbook installation there should be a copy of your configuration
 If you have an installation from source:
 1. please backup `config/secrets.yml` file that contains key to encrypt variables in database,
 but don't store it in the same place as your database backups.
-Otherwise your users secrets are exposed in case one of your backups is compromised.
+Otherwise your secrets are exposed in case one of your backups is compromised.
 1. please consider backing up your `application.yml` file,
 1. any SSL keys and certificates, 
 1. and your [SSH host keys](https://superuser.com/questions/532040/copy-ssh-keys-from-one-server-to-another-server/532079#532079).

doc/update/7.12-to-7.13.md

@@ -2,7 +2,7 @@
 ## Notice
-__GitLab CI 7.13 requires GitLab 7.12 or higher and GitLab Multi Runner 0.4.0 or higher
+__GitLab CI 7.13 requires GitLab 7.12 or higher and GitLab Multi Runner 0.5.0 or higher
 ### 1. Stop CI server
@@ -25,7 +25,18 @@ git checkout 7-13-stable
 ### 4. Make sure GitLab CI can write to the builds/ directory
 ```
-sudo chmod -R u+rwX  builds
+sudo chmod -R u+rwX builds
+```
+
+### 4. Copy secrets
+
+The `secrets.yml` file is used to store keys to encrypt sessions and encrypt secure variables.
+When you run migrations make sure to store it someplace safe.
+Don't store it in the same place as your database backups,
+otherwise your secrets are exposed if one of your backups is compromised.
+
+```
+sudo -u gitlab_ci -H cp config/secrets.yml.example config/secrets.yml
 ```
 ### 5. Install libs, migrations etc