Lines Matching +full:bazel +full:- +full:release
1 # How to Create a Release of OpenCensus Java (for Maintainers Only)
7 - Ubuntu 14.04
18 - Follow the instructions on [this
19 page](http://central.sonatype.org/pages/ossrh-guide.html) to set up an
21 - You only need to create the account, not set up a new project
22 - Contact a OpenCensus Java maintainer to add your account after you
24 - (For release deployment only) [Install
25 GnuPG](http://central.sonatype.org/pages/working-with-pgp-signatures.html#installing-gnupg)
27 pair](http://central.sonatype.org/pages/working-with-pgp-signatures.html#generating-a-key-pair).
29 …key](http://central.sonatype.org/pages/working-with-pgp-signatures.html#distributing-your-public-k…
31 - Put your GnuPG key password and OSSRH account information in
32 `<your-home-directory>/.gradle/gradle.properties`:
35 # You need the signing properties only if you are making release deployment
36 signing.keyId=<8-character-public-key-id>
37 signing.password=<key-password>
38 signing.secretKeyRingFile=<your-home-directory>/.gnupg/secring.gpg
40 ossrhUsername=<ossrh-username>
41 ossrhPassword=<ossrh-password>
45 ## Tagging the Release
47 The first step in the release process is to create a release branch, bump
48 versions, and create a tag for the release. Our release branches follow the
53 In this section upstream repository refers to the main opencensus-java github
57 token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/).
59 1. Create the release branch and push it to GitHub:
62 $ MAJOR=0 MINOR=4 PATCH=0 # Set appropriately for new release
70 $ git checkout -b v$MAJOR.$MINOR.x master
73 The branch will be automatically protected by the GitHub branch protection rule for release
78 - Change root build files to the next minor snapshot (e.g.
79 `0.5.0-SNAPSHOT`).
82 $ git checkout -b bump-version master
83 # Change version to next minor (and keep -SNAPSHOT)
84 …$ sed -i 's/[0-9]\+\.[0-9]\+\.[0-9]\+\(.*CURRENT_OPENCENSUS_VERSION\)/'$MAJOR.$((MINOR+1)).0'\1/' \
87 $ git commit -a -m "Start $MAJOR.$((MINOR+1)).0 development cycle"
90 - Go through PR review and push the master branch to GitHub:
94 $ git merge --ff-only bump-version
100 - Change root build files to remove "-SNAPSHOT" for the next release
104 $ git checkout -b release v$MAJOR.$MINOR.x
105 # Change version to remove -SNAPSHOT
106 $ sed -i 's/-SNAPSHOT\(.*CURRENT_OPENCENSUS_VERSION\)/\1/' "${VERSION_FILES[@]}"
108 $ git commit -a -m "Bump version to $MAJOR.$MINOR.$PATCH"
109 $ git tag -a v$MAJOR.$MINOR.$PATCH -m "Version $MAJOR.$MINOR.$PATCH"
112 - Change root build files to the next snapshot version (e.g.
113 `0.4.1-SNAPSHOT`). Commit the result:
116 # Change version to next patch and add -SNAPSHOT
117 …$ sed -i 's/[0-9]\+\.[0-9]\+\.[0-9]\+\(.*CURRENT_OPENCENSUS_VERSION\)/'$MAJOR.$MINOR.$((PATCH+1))-…
120 $ git commit -a -m "Bump version to $MAJOR.$MINOR.$((PATCH+1))-SNAPSHOT"
123 - Go through PR review and push the release tag and updated release branch
128 $ git merge --ff-only release
142 gone through code review. For the current release use:
145 $ git checkout -b v$MAJOR.$MINOR.$PATCH tags/v$MAJOR.$MINOR.$PATCH
152 uploadArchives](https://issues.gradle.org/browse/GRADLE-3420).
155 $ ./gradlew clean build && ./gradlew -Dorg.gradle.parallel=false uploadArchives
158 If the version has the `-SNAPSHOT` suffix, the artifacts will automatically go
159 to the snapshot repository. Otherwise it's a release deployment and the
162 When deploying a Release, the deployment will create [a new staging
164 up the ID in the OSSRH UI (usually in the form of `opencensus-*`).
174 site](http://central.sonatype.org/pages/releasing-the-deployment.html).
178 Once deployment is done, go to Github [release
179 page](https://github.com/census-instrumentation/opencensus-java/releases), press
180 `Draft a new release` to write release notes about the new release.
182 You can use `git log upstream/v$MAJOR.$((MINOR-1)).x..upstream/v$MAJOR.$MINOR.x --graph --first-par…
183 or the Github [compare tool](https://github.com/census-instrumentation/opencensus-java/compare/)
184 to view a summary of all commits since last release as a reference. In addition, you can refer to
185 [CHANGELOG.md](https://github.com/census-instrumentation/opencensus-java/blob/master/CHANGELOG.md)
186 for a list of major changes since last release.
188 Please pick major or important user-visible changes only.
190 ## Update release versions in documentations and build files
198 $ git checkout -b bump-document-version master
226 $ sed -i 's/[0-9]\+\.[0-9]\+\.[0-9]\+\(.*LATEST_OPENCENSUS_RELEASE_VERSION\)/'$MAJOR.$MINOR.$PATCH'…
229 $ sed -i 's/\(\(compile\|runtime\).\+io\.opencensus:.\+:\)[0-9]\+\.[0-9]\+\.[0-9]\+/\1'$MAJOR.$MINO…
232 $ sed -i 's/\(<version>\)[0-9]\+\.[0-9]\+\.[0-9]\+/\1'$MAJOR.$MINOR.$PATCH'/' \
236 2. Update bazel dependencies for subproject `examples`:
238 - Follow the instructions on [this
239 page](https://docs.bazel.build/versions/master/generate-workspace.html) to
240 install bazel migration tool. You may also need to manually apply
242 https://github.com/nevillelyh/migration-tooling/commit/f10e14fd18ad3885c7ec8aa305e4eba266a07ebf)
246 - Use the following command to generate new dependencies file:
249 $ bazel run //generate_workspace -- \
250 --artifact=com.google.guava:guava-jdk5:23.0
251 --artifact=com.google.guava:guava:23.0 \
252 --artifact=io.grpc:grpc-all:1.9.0 \
253 --artifact=io.opencensus:opencensus-api:$MAJOR.$MINOR.$PATCH \
254 --artifact=io.opencensus:opencensus-contrib-grpc-metrics:$MAJOR.$MINOR.$PATCH \
255 --artifact=io.opencensus:opencensus-contrib-zpages:$MAJOR.$MINOR.$PATCH \
256 --artifact=io.opencensus:opencensus-exporter-stats-prometheus:$MAJOR.$MINOR.$PATCH \
257 --artifact=io.opencensus:opencensus-exporter-stats-stackdriver:$MAJOR.$MINOR.$PATCH \
258 --artifact=io.opencensus:opencensus-exporter-trace-logging:$MAJOR.$MINOR.$PATCH \
259 --artifact=io.opencensus:opencensus-exporter-trace-stackdriver:$MAJOR.$MINOR.$PATCH \
260 --artifact=io.opencensus:opencensus-impl:$MAJOR.$MINOR.$PATCH \
261 --artifact=io.prometheus:simpleclient_httpserver:0.3.0 \
262 --repositories=http://repo.maven.apache.org/maven2
267 - Copy this file to overwrite `examples/opencensus_workspace.bzl`.
269 - Use the following command to rename the generated rules and commit the
273 $ sed -i 's/def generated_/def opencensus_/' examples/opencensus_workspace.bzl
274 $ git commit -a -m "Update release versions for all readme and build files."
279 4. In addition, create a PR to mark the new release in
280 [CHANGELOG.md](https://github.com/census-instrumentation/opencensus-java/blob/master/CHANGELOG.md)
281 on master branch. Once that PR is merged, cherry-pick the commit and create another PR to the
282 release branch (branch v$MAJOR.$MINOR.x).
293 If option `-Dorg.gradle.parallel=false` is used, you will hit [this bug](https://issues.sonatype.or…