Commit 74dcbdb0673dcf1a51f1d57bda233fa3201dc7c0
1 parent
e437ab09
Exists in
master
and in
13 other branches
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 | ... | ... |