Commit 74dcbdb0673dcf1a51f1d57bda233fa3201dc7c0

Authored by Jacob Vosmaer
1 parent e437ab09

Add more details to the release documentation

Showing 1 changed file with 35 additions and 3 deletions   Show diff stats
doc/release.md
... ... @@ -29,6 +29,19 @@ git push origin 6-6-stable 6.6.0.omnibus
29 29  
30 30 ## On the build machines
31 31  
  32 +### One-time
  33 +
  34 +- Set up the `attach.sh` script
  35 +
  36 +```shell
  37 +sudo su - omnibus-build
  38 +cat > attach.sh <<EOF
  39 +#!/bin/sh
  40 +script -c 'screen -x || screen' /dev/null
  41 +EOF
  42 +chmod +x attach.sh
  43 +```
  44 +
32 45 - Install release dependencies
33 46  
34 47 ```shell
... ... @@ -43,11 +56,23 @@ sudo pip install awscli
43 56 aws configure # enter AWS key and secret
44 57 ```
45 58  
46   -- Check out the release branch of omnibus-gitlab.
  59 +- Set up a deploy key to fetch the GitLab EE source code.
  60 +
  61 +### Each build
  62 +
  63 +- Log in as the build user and start a screen session
47 64  
48 65 ```shell
  66 +sudo su - omnibus-build
  67 +./attach.sh
  68 +```
  69 +
  70 +- Check out the release tag of omnibus-gitlab.
  71 +
  72 +```shell
  73 +cd ~/omnibus-gitlab
49 74 git fetch
50   -git checkout 6-6-stable
  75 +git checkout 6.6.0.my-tag
51 76 ```
52 77  
53 78 - Check the system time; the S3 upload will fail if it is off by too much
... ... @@ -58,7 +83,7 @@ date
58 83  
59 84 You can adjust the time with the `date` command if necessary.
60 85  
61   -- Run the release script
  86 +- Start the release script
62 87  
63 88 ```shell
64 89 ./release.sh
... ... @@ -66,4 +91,11 @@ You can adjust the time with the `date` command if necessary.
66 91  
67 92 This will `clean --purge` the build environment, build a package and upload it to S3.
68 93  
  94 +- Detach from screen: press Ctrl-a DD
  95 +- Check in on the build after 30 minutes.
  96 +- When the build is done, update the download page with the package URL's and MD5 hashes.
  97 +
  98 +See a previous [CE example](https://gitlab.com/gitlab-com/www-gitlab-com/merge_requests/141)
  99 +and [EE example](https://dev.gitlab.org/gitlab/gitlab-ee/commit/7301417820404f92ca7c0a9940408ef414ef3c01).
  100 +
69 101 [the gitlab-rails version in omnibus-gitlab]: ../config/software/gitlab-rails.rb#L20
... ...