Page History

Once the release has been finalized, the last step of the process is to promote the release within the project and beyond. Please wait for 24h after finalizing the release in accordance with the ASF release policy.

Update japicmp configuration

Update the japicmp reference version and enable API compatibility checks for @PublicEvolving  APIs on the corresponding SNAPSHOT branch with the update_japicmp_configuration.sh script (see below).

For a new major release (x.y.0), run the same command also on the master branch for updating the japicmp reference version, and remove all out-dated exclusions in the japicmp configurations (which will usually mean removing all exclusions that aren't workarounds for Scala magic).

tools $ NEW_VERSION=$RELEASE_VERSION releasing/update_japicmp_configuration.sh
tools $ cd ..
$ git add *
$ git commit -m "Update japicmp configuration for $RELEASE_VERSION"

Merge website pull request

Merge the website pull request to list the release. Make sure to regenerate the website as well, as it isn't build automatically.

Remove outdated versions

dist.apache.org

For a new major release remove all release files older than 2 versions, e.g., when releasing 1.7, remove all releases <= 1.5.

For a new bugfix version remove all release files for previous bugfix releases in the same series, e.g., when releasing 1.7.1, remove the 1.7.0 release.

1. If you have not already, check out the Flink section of the release repository on dist.apache.org via Subversion. In a fresh directory:

   Code Block
   language bash
   svn checkout https://dist.apache.org/repos/dist/release/flink --depth=immediates cd flink

   
   

2. Remove files for outdated releases and commit the changes.

   Code Block
   language bash
   svn remove flink-<version_to_remove> svn commit

   
   

3. Verify that files  are removed

   Warning
   Remember to remove the corresponding download links from the website.

   
   

CI

Disable the cron job for the now-unsupported version from (tools/azure-pipelines/build-apache-repo.yml) in the respective branch.

Apache mailing lists

Announce on the dev@ mailing list that the release has been finished.

Announce on the release on the user@ mailing list, listing major improvements and contributions.

Announce the release on the announce@apache.org mailing list.

From: Release Manager
To: dev@flink.apache.org, user@flink.apache.org, user-zh@flink.apache.org, announce@apache.org
Subject: [ANNOUNCE] Apache Flink 1.2.3 released

The Apache Flink community is very happy to announce the release of Apache Flink 1.2.3, which is the third bugfix release for the Apache Flink 1.2 series.

Apache Flink® is an open-source stream processing framework for distributed, high-performing, always-available, and accurate data streaming applications.

The release is available for download at:
https://flink.apache.org/downloads.html

Please check out the release blog post for an overview of the improvements for this bugfix release:
<blob post link>

The full release notes are available in Jira:
<jira release notes link>

We would like to thank all contributors of the Apache Flink community who made this release possible!

Regards,
Release Manager

Recordkeeping

Use reporter.apache.org to seed the information about the release into future project reports.

(Note: Only PMC members have access report releases. If you do not have access, ask on the mailing list for assistance.)

Flink blog

Major or otherwise important releases should have a blog post. Write one if needed for this particular release. Minor releases that don’t introduce new major functionality don’t necessarily need to be blogged.

Please make sure that the release notes of the documentation (see section "Review and update documentation") are linked from the blog post of a major release.
We usually include the names of all contributors in the announcement blog post. Use the following command to get the list of contributors:

git log --pretty="%an%n%cn" <fromCommit>..<toCommit> | sort | uniq | tr "\n" "," | sed 's/,/, /g'

Social media

Tweet, post on Facebook, LinkedIn, and other platforms. Ask other contributors to do the same.

Checklist to declare the process completed

1. Website pull request to list the release merged
2. Release announced on the user@ mailing list.
3. Blog post published, if applicable.
4. Release recorded in reporter.apache.org.
5. Release announced on social media.
6. Completion declared on the dev@ mailing list.
7. Update Homebrew: https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request (seems to be done automatically - at least for minor releases)
8. Update quickstart scripts in flink-web, under the q/ directory
9. Updated the japicmp configuration
   • corresponding SNAPSHOT branch japicmp reference version set to the just released version, and API compatibiltity checks for @PublicEvolving  was enabled
   • (major only) master branch japicmp reference version set to the just released version
   • (major only) master branch japicmp exclusions have been cleared
10. Update the list of previous version in docs/_config.yml on the master branch.
11. Set show_outdated_warning: true in docs/_config.yml in the branch of the previous Flink version
12. Update stable and master alias in flink.py found in https://github.com/apache/infrastructure-bb2/blob/master/flink.py

    1. Update flink_branches_nightly, e.g.

       Code Block
       flink_branches_nightly = [ ('master', 'release-1.13'), ('release-1.12', 'stable'), 'release-1.11', ] -> flink_branches_nightly = [ ('master', 'release-1.14'), ('release-1.13', 'stable'), 'release-1.12', ]

       
       

    2. Add the oldest release to flink_branches_manual

       
       

13. Update docs to "stable" in docs/_config.yml in the branch of the just-released version:
    • Change version from x.y-SNAPSHOT to x.y.z, i.e. 1.6-SNAPSHOT to 1.6.0
    • Change version_title from x.y-SNAPSHOT to x.y, i.e. 1.6-SNAPSHOT to 1.6
    • Change github_branch from master to release-x.y, i.e. master to release-1.6
    • Change baseurl from //ci.apache.org/projects/flink/flink-docs-master to //ci.apache.org/projects/flink/flink-docs-release-x.y
    • Change javadocs_baseurl from //ci.apache.org/projects/flink/flink-docs-master to //ci.apache.org/projects/flink/flink-docs-release-x.y
    • Change is_stable to true
14. Update CURRENT_VERSION in TypeSerializerUpgradeTestBase  with the new version. This will likely fail some tests because snapshots are missing for that version. Generate them, for example in TypeSerializerUpgradeTestBase. 
15. (major/minor only) Update migration tests in master to cover migration from new version: (search for usages of FlinkVersion)
    
    • AbstractOperatorRestoreTestBase
    • CEPMigrationTest
    • BucketingSinkMigrationTest
    • FlinkKafkaConsumerBaseMigrationTest
    • ContinuousFileProcessingMigrationTest
    • WindowOperatorMigrationTest
    • StatefulJobSavepointMigrationITCase
    • StatefulJobWBroadcastStateMigrationITCase