Commit 73b64aafdb300dc56ec05a839238b1a849bf46fb
Committed by
Daniela Feitosa
1 parent
4c3e514f
Exists in
master
and in
29 other branches
Updating release procedure
Showing
2 changed files
with
23 additions
and
19 deletions
Show diff stats
HACKING
@@ -86,3 +86,7 @@ you want to enable it then you need to change some files: | @@ -86,3 +86,7 @@ you want to enable it then you need to change some files: | ||
86 | 86 | ||
87 | 3) Add in config/noosfero.yml at development section: | 87 | 3) Add in config/noosfero.yml at development section: |
88 | exception_recipients: [admin@example.com] | 88 | exception_recipients: [admin@example.com] |
89 | + | ||
90 | +== Releasing and building Debian package | ||
91 | + | ||
92 | +See RELEASING file. |
RELEASING
@@ -12,28 +12,28 @@ This file documents release-related activities. | @@ -12,28 +12,28 @@ This file documents release-related activities. | ||
12 | 12 | ||
13 | == Releasing noosfero | 13 | == Releasing noosfero |
14 | 14 | ||
15 | +Considering you are on Debian GNU/Linux or Debian-bases system | ||
16 | + # apt-get install devscripts debhelper | ||
17 | + | ||
15 | To prepare a release of noosfero, you must follow the steps below: | 18 | To prepare a release of noosfero, you must follow the steps below: |
16 | 19 | ||
17 | -* finish all requirements and bugs assigned to the to-be-released version | ||
18 | -* make sure all tests pass | ||
19 | -* write release notes at the version's wiki topic. | ||
20 | -* generate package with <tt>rake package</tt>. Your tarball will be under the pkg/ | ||
21 | - directory, named as noosfero-${VERSION}.tar.gz | ||
22 | -* test that the package contains everything that is needed: explode the tarball | ||
23 | - in a temporary directory, copy config/database.yml.sqlite3 to | ||
24 | - config/database.yml, and make <tt>rake db:migrate</tt> and <tt>rake test</tt>. If | ||
25 | - everything is ok, you are done. If not, maybe some files are not going into | ||
26 | - the tarball. See lib/tasks/package.rake, probably you'll need to change it. | ||
27 | -* Go to the version's wiki topic and edit it to reflect the new reality. | ||
28 | -* Attach the generated package to that topic. Before attaching calculate the md5 of the package (with mu5sum and paste the MD5 hash as comment in the attachment form) | 20 | +* Finish all requirements and bugs assigned to the to-be-released version |
21 | +* Make sure all tests pass | ||
22 | +* Change the version in lib/noosfero.rb and debian/changelog to the | ||
23 | + to-be-released version (e.g. 0.2.0, 0.3.1) | ||
24 | +* Write release notes at the version's wiki topic | ||
25 | +* Generate packages with <tt>rake noosfero:release</tt>. Your tarball and deb | ||
26 | + pkg will be under the pkg/ directory. This task will create a git tag too. | ||
27 | +* Test that the tarball and deb package are ok | ||
28 | +* Go to the version's wiki topic and edit it to reflect the new reality and | ||
29 | + edit WebPreferences and update DEBIAN_REPOSITORY_TOPICS setting | ||
30 | +* Attach the generated packages to that topic. Before attaching calculate the | ||
31 | + sha1 of the package (with sha1sum and paste the SHA1 hash as comment in the | ||
32 | + attachment form) | ||
29 | * Download the attached and verify the MD5 hash | 33 | * Download the attached and verify the MD5 hash |
30 | -* create a git tag for the released version with <tt>git tag</tt>. | ||
31 | -* IMMEDIATELY change the version in lib/noosfero.rb to the next version. (e.g. | ||
32 | - 0.2.0 -> 0.3.0) | ||
33 | -* update an eventual demonstration version that you run. | ||
34 | -* write an announcement e-mail to the relevant maimling lists pointing to the release notes, and maybe to the demonstration version. | 34 | +* Update an eventual demonstration version that you run. |
35 | +* Write an announcement e-mail to the relevant mailing lists pointing to the | ||
36 | + release notes, and maybe to the demonstration version. | ||
35 | 37 | ||
36 | If you had any problem during these steps, you can do <tt>rake clobber_package</tt> to | 38 | If you had any problem during these steps, you can do <tt>rake clobber_package</tt> to |
37 | completely delete the generated packages and start the process again. | 39 | completely delete the generated packages and start the process again. |
38 | - | ||
39 | - |