Making a release

On the master, check that files which require update for the release are up to date. This includes particularly: asciidoc/release-notes.adoc

Run the following git command to checkout the branch, revert any change and remove untracked and ignored files:

You need to store the current Ivy XML schema in the documentation, so that it will later be accessible on public web site. To do so, run the following command in the directory in which you checked out the release branch:

And commit your changes in the branch:

The status should be release only for final releases, and milestone for any other intermediate release. If the release script is successful, release artifacts will be waiting for you in the build/distrib directory.

Check that all zips can be opened correctly, and that running ant after unzipping the source distribution works properly. You can also do a smoke test with the generated ivy.jar, to see if it is able to resolve properly a basic module (for instance, you can run some tutorials provided in the src/example directory in all distributions).

It’s now time to sign the release artifacts and upload them to a location accessible by other Apache committers.

Here is a simple way to sign the files using gnupg:

Here is a ruby script you can use to sign the files:

Be prepared to enter your passphrase several times if you use this script, gpg will ask for your passphrase for each file to sign.

To be able to test the release within IvyDE, it can be deployed in the IvyDE update site. See that page to know how to process.

All artifacts in build/distrib/dist needs to be published on the 'dist' svn of the ASF, in the dev part.

The following command lines should do the job:

Having your GPG key ID, its password, your apache ID and the associated password, just launch Ant and enter the information as required:

Once uploaded, log in https://repository.apache.org/ with your preferred web browser (use your Apache ID).

You should find there an open repository with the name of the form orgapacheant-XXXX. It should contain the Maven artifacts: the pom, the jar, the sources, the javadocs and the sha and asc files.

Now close the staging repository, with the description "Ivy 2.0.0-beta1". Closing means you finished the upload and some automatic checks will run. You can see them in the Activity tab of the repository.

Once the checks passed, you can find in the Summary the URL of the staging repository. It will something like: https://repository.apache.org/content/repositories/orgapacheant-XXXX/

As soon as you are happy with the artifacts to be released, it is time to tag the release

And push the changes to the ASF repo

Cast a vote to approve the release on the dev@ant.apache.org mailing list.

Here is an example:

If the release is approved, it’s now time to make it public. The artifacts in the dev part needs to be moved into the release one:

In order to keep the main dist area of a reasonable size, old releases should be removed. They will disappear from the main dist but will still be available via the archive. To do so, just use the svn rm command against the artifacts or folders to remove.

Go log in https://repository.apache.org/ with your preferred web browser (use your Apache ID).

Select the appropriate orgapacheant-XXXX repository and select the Release action.

It’s time to update the download image used on the home page and the download page. Use site/images/ivy-dl.xcf as a basis if you have gimp installed. Then you can update the home page to refer to this image, and add a news item announcing the new version. Update also the download page with the new image and update the links to the download location (using a search/replace on the html source is recommended for this).

The just release documentation should be added to the site. To do so, you need to:

Now let’s generate the website with the new toc:

You should verify that the site generated in the production directory is OK. You can open the files with your preferred web browser like it was deployed.

And once your happy with it, commit the changes in the source directory, and in the production directory to get it actually deployed via svnpubsub.

Tip: lot’s of files might need to be 'added' to svn. An handy command to add any file which is not yet under version control is the following one:

If the Eclipse update site has already been prepared to include that new Ivy release, it is now needed to be deployed. Then follow the deployment instruction on that page.

Announce the release on the dev@ant.apache.org, ivy-user@ant.apache.org, user@ant.apache.org and announce@apache.org mailing lists. Note that announce@apache.org only accepts emails sent with an @apache.org address.

Suggested template:

If you feel like anything is missing or misleading in this release doc, update it as soon as you encounter the problem.

Modifications on the template files do not need to be merged, but if you had troubles during your release you may want to merge your fixes back to the trunk.

In the master branch, update the file version.properties with the version of the next release so that anyone building from the trunk will obtain jar with the correct version number.

If the version just release is a final one (not an alpha, beta or rc), the list of changes should be emptied in doc/release-notes.html, and update there the next expected version. The announcement in the file should also be changed accordingly to the next expected version.

Release the version in jira, and create a new unreleased version for the next planned version.