Source Release For hyrax-dependencies: Difference between revisions

From OPeNDAP Documentation
⧼opendap2-jumptonavigation⧽
No edit summary
Line 33: Line 33:
#* ''git tag -m "hyrax-<number>" -a hyrax-<numbers>''
#* ''git tag -m "hyrax-<number>" -a hyrax-<numbers>''
#* ''git push origin hyrax-<numbers>''
#* ''git push origin hyrax-<numbers>''
# Make 'release' in github
 
== Make 'release' in GitHub ==
## Goto the [https://github.com/OPENDAP/hyrax-dependencies/tags GitHub 'tags' page for ''hyrax-dependencies''].  
## Goto the [https://github.com/OPENDAP/hyrax-dependencies/tags GitHub 'tags' page for ''hyrax-dependencies''].  
## Enter a title for the release (looks at previous releases for examples)
## Enter a title for the release (looks at previous releases for examples)
## Copy the most recent text from the NEWS file into the describe field
## Copy the most recent text from the NEWS file into the describe field
## Click Update this release or Save draft, this will trigger a 'archive and DOI' process on the Zenodo system.
## Click Update this release or Save draft, this will trigger a 'archive and DOI' process on the Zenodo system.

Revision as of 15:23, 7 January 2022

This task is to ensure that the hyrax-dependencies project is up to date and tar balls on www.o.o. are current.

Update ChangeLog, NEW, and release version

Update the ChangeLog file.

Use the script gitlog-to-changelog (which can be found with Google) to update the ChangeLog file by running it using the --since="<date>" option with a date one day later in time than the newest entry in the current ChangeLog.

gitlog-to-changelog --since="1970-01-01" (Specify a date one day later than the one at the top of ChangeLog)

Save the result to a temp file and combine the two files:

cat tmp ChangeLog > ChangeLog.tmp; mv ChangeLog.tmp ChangeLog

If you're making the first ChangeLog entries, then you'll need to create the ChangeLog file first.
Tip: When you're making the commit log entries, use line breaks so ChangeLog will be readable. That is, use lines < 80 characters long.

Update the Version Numbers

If the review of the ChangeLog indicates that there have been changes since the last release, increment the version number in the Makefile.

Make sure any change in version number is also reflected in the NEWS file.

Update the NEWS file

To update the NEWS file, just read over the new ChangeLog entries and summarize.

Commit and Push

  1. Save, commit, and push the changes to master branch.
  2. Once the hyrax-dependencies CI build is finished
    1. Trigger a CI build libdap4 by pushing a small change to the libdap4 master branch. When that CI build has completed successfully,
    2. Trigger a CI build in the bes by pushing a small change to the bes master branch.
  3. Wait for the successful completion.

Tag The Release

  1. Tag, and push the tag.
    • git tag -m "version-<number>" -a <numbers>
    • git push origin <numbers>
  2. Since this is part of Hyrax, also tag this point in the master branch with the Hyrax release number:
    • git tag -m "hyrax-<number>" -a hyrax-<numbers>
    • git push origin hyrax-<numbers>

Make 'release' in GitHub

    1. Goto the GitHub 'tags' page for hyrax-dependencies.
    2. Enter a title for the release (looks at previous releases for examples)
    3. Copy the most recent text from the NEWS file into the describe field
    4. Click Update this release or Save draft, this will trigger a 'archive and DOI' process on the Zenodo system.