From issues-return-40133-archive-asf-public=cust-asf.ponee.io@openwhisk.apache.org Mon Sep 23 18:11:51 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id EC162180665 for ; Mon, 23 Sep 2019 20:11:50 +0200 (CEST) Received: (qmail 73988 invoked by uid 500); 23 Sep 2019 18:11:50 -0000 Mailing-List: contact issues-help@openwhisk.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@openwhisk.apache.org Delivered-To: mailing list issues@openwhisk.apache.org Received: (qmail 73871 invoked by uid 99); 23 Sep 2019 18:11:49 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 23 Sep 2019 18:11:49 +0000 From: GitBox To: issues@openwhisk.apache.org Subject: [GitHub] [openwhisk-release] rabbah commented on a change in pull request #304: updated post-vote release instructions Message-ID: <156926230981.1959.1867768977187475620.gitbox@gitbox.apache.org> Date: Mon, 23 Sep 2019 18:11:49 -0000 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit rabbah commented on a change in pull request #304: updated post-vote release instructions URL: https://github.com/apache/openwhisk-release/pull/304#discussion_r327255963 ########## File path: docs/release_instructions.md ########## @@ -162,22 +162,89 @@ restart the process with new candidate releases. Update your `config.json` file by incrementing the `rc` number and changing git hashes. -### Publishing a Successful Release - -TODO: This portion of the documentation and scripting still needs to be updated. - - 10. [Publish the release artifacts to Apache release directory](publish_apache_directory.md) - You should receive an email from reporter.apache.org asking you to add your version data - to its database shortly after you commit to the dist svn. Please follow the link and - add the information (this is useful for generating board reports). - 11. [Tag the commit IDs in the Github repository for the project](tag_release.md) - 12. [Generate the release notes](generate_release_notes.md) - 13. If appropriate, update dockerhub `latest` tags. - 14. If appropriate update deploy-kube and docker-compose tag info to pick up new images. - 15. Submit a PR to update the downloads page. - - 20. Announce the release -- must wait until website PR is merged and Jenkins publishes site. - 30. Cleanup the artifacts from the release process: - a. Remove the rc files from staging. - b. Remove the previous If there is a previous released version, remove it from Apache release directory - (it will automatically still be available via the Apache archive server). +### Publishing a Successful Release to Apache Dist Servers + +After a successful vote, the release manager will commit the artifacts +being released to the openwhisk subdir of the Apache dist svn. + +The upload_to_dist.sh script automates the copy & svn add operations, but it +assumes that every file found in the release candidate subdir should be released. +If this is not true (eg multiple parallel release votes), then the upload +must be performed manually. +``` +./upload_to_dist.sh ../release-configs/.json +``` + +Assuming the expected set of files were added, commit them: +``` +cd ../stagingArea/svn_release && svn commit -m "Apache OpenWhisk X.Y.Z release of " +``` + +Relatively soon after doing the svn commit, you should receive an email from +from reporter.apache.org asking you to add your version data +to its database. Please follow the link and add the information +(the data is used to generate periodic reports to the ASF Board). + +### Tag GitHub repos + +Each GitHub repository needs to be tagged. Unfortunately, the naming conventions for +tagging vary across the OpenWhisk project repositories and therefore we have not +yet attempted to automate this step. + +For each released repository, the Release Manager should examine the existing set of +tags (`git tag`) and then add a new tag following the same convention using the +git commit hash from .json. After tagging a repo, push the tag. + +Many of the GitHub repositories are configured to build binary artifacts in response +to new tags being committed. Monitor the build process and ensure that all expected +artifacts are created for each tag you commit. + +There are some slightly outdated, but much more detailed comments +on [release tagging](tag_release.md) available if you need a reminder +of the git commands to use. + +### Create GitHub releases + +After pushing the tags, you should go to the GitHub Releases for +each released project and "Draft a new release" using the tag you just +pushed. If the project contains a CHANGELOG or RELEASENOTES, copy that +information into the release description. + +### Dockerhub updates + +If the components you released build docker images, then you should +build the docker images locally, tag them with the release version +(following the naming scheme for the repo), push the new images to +dockerhub using the whiskbot dockerhub id, and update the `latest` +tag to point to the new images. + +If you have published new images to dockerhub, submit PRs to openwhisk-deploy-kube +and openwhisk-devtools (docker-compose) to use the new images. Review comment: ```suggestion and [openwhisk-devtools (docker-compose)](https://github.com/apache/openwhisk-devtools) to use the new images. ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: users@infra.apache.org With regards, Apache Git Services