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,6 +29,19 @@ git push origin 6-6-stable 6.6.0.omnibus | ||
| 29 | 29 | ||
| 30 | ## On the build machines | 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 | - Install release dependencies | 45 | - Install release dependencies |
| 33 | 46 | ||
| 34 | ```shell | 47 | ```shell |
| @@ -43,11 +56,23 @@ sudo pip install awscli | @@ -43,11 +56,23 @@ sudo pip install awscli | ||
| 43 | aws configure # enter AWS key and secret | 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 | ```shell | 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 | git fetch | 74 | git fetch |
| 50 | -git checkout 6-6-stable | 75 | +git checkout 6.6.0.my-tag |
| 51 | ``` | 76 | ``` |
| 52 | 77 | ||
| 53 | - Check the system time; the S3 upload will fail if it is off by too much | 78 | - Check the system time; the S3 upload will fail if it is off by too much |
| @@ -58,7 +83,7 @@ date | @@ -58,7 +83,7 @@ date | ||
| 58 | 83 | ||
| 59 | You can adjust the time with the `date` command if necessary. | 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 | ```shell | 88 | ```shell |
| 64 | ./release.sh | 89 | ./release.sh |
| @@ -66,4 +91,11 @@ You can adjust the time with the `date` command if necessary. | @@ -66,4 +91,11 @@ You can adjust the time with the `date` command if necessary. | ||
| 66 | 91 | ||
| 67 | This will `clean --purge` the build environment, build a package and upload it to S3. | 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 | [the gitlab-rails version in omnibus-gitlab]: ../config/software/gitlab-rails.rb#L20 | 101 | [the gitlab-rails version in omnibus-gitlab]: ../config/software/gitlab-rails.rb#L20 |