Thanks to visit codestin.com
Credit goes to github.com

Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
b096eaa
3540: Filtered out com.fasterxml.jackson.core and org.threeten.bp.zon…
Dec 31, 2018
e9ea3d9
Spanner: closed watch-dog daemon threads spawned by Spanner client (#…
javabrown Dec 31, 2018
fb2b690
Fix Kokoro release jobs (#4225)
chingor13 Jan 2, 2019
6e2c2dd
Pub/Sub: Add message abandonment (#4250)
charlesliqlogic Jan 2, 2019
70d7efb
BigQuery: Fix Maximum Bytes Billed property. (#4262)
Jan 2, 2019
f526a44
Update UsePubSubEmulatorSnippet.java (#4256)
kenfesta Jan 2, 2019
63a9cb7
Logging: disable severity based flush on write by default (#4254)
ajaaym Jan 2, 2019
7978818
Docs: Fix maven site generation (#4232)
chingor13 Jan 2, 2019
b7c1878
Bigtable: deprecate the use of typesafe names (#4257)
igorbernstein2 Jan 3, 2019
2b9f530
Fixed cannot call public methods in via reflection (#4249)
charlesliqlogic Jan 3, 2019
73e93c0
BigQuery : Fix numBytes, numRows in TableInfo/Table (#4271)
Jan 3, 2019
eb6c4d2
Cloud Bigtable: helloWorld sample (#4274)
elisheva-qlogic Jan 3, 2019
b2a95a0
Add .tmpl extension for README.md so releasetool is not confused (#4280)
chingor13 Jan 3, 2019
c367308
Release v0.75.0 (#4282)
kolea2 Jan 3, 2019
6d56b8c
Bump next snapshot (#4286)
kolea2 Jan 3, 2019
c602062
3540: Changes after review. Using transformer instead.
Jan 4, 2019
ca7054e
Fix #4284 NPE for getZone (#4289)
ajaaym Jan 4, 2019
ba4ba16
Regenerate securitycenter client (#4290)
yoshi-automation Jan 4, 2019
28720b5
Bigtable admin: deprecate typesafe names part 2 (#4258)
igorbernstein2 Jan 4, 2019
978f3b7
Regenerate iamcredentials client (#4277)
yoshi-automation Jan 7, 2019
f28bbcc
Revert "Pub/Sub: Add message abandonment (#4250)" (#4297)
chingor13 Jan 7, 2019
d2302cd
updated links (#4287)
romlogic Jan 7, 2019
395b016
Release v0.76.0 (#4298)
chingor13 Jan 8, 2019
318415e
3540: Filtered out com.fasterxml.jackson.core and org.threeten.bp.zon…
Dec 31, 2018
b8365a1
3540: Changes after review. Using transformer instead.
Jan 4, 2019
059ce5d
Merge branch '3540' of https://github.com/andrey-qlogic/google-cloud-…
Jan 8, 2019
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .kokoro/continuous/bigtable-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.table=projects/gcloud-devel/instances/google-cloud-bigtable/tables/integration-tests"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable -Dbigtable.table=integration-tests"
}

env_vars: {
Expand Down
2 changes: 1 addition & 1 deletion .kokoro/continuous/bigtableadmin-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.instance=projects/gcloud-devel/instances/google-cloud-bigtable"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable"
}

env_vars: {
Expand Down
2 changes: 1 addition & 1 deletion .kokoro/nightly/bigtable-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.table=projects/gcloud-devel/instances/google-cloud-bigtable/tables/integration-tests"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable -Dbigtable.table=integration-tests"
}

env_vars: {
Expand Down
2 changes: 1 addition & 1 deletion .kokoro/nightly/bigtableadmin-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.instance=projects/gcloud-devel/instances/google-cloud-bigtable"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable"
}

env_vars: {
Expand Down
2 changes: 1 addition & 1 deletion .kokoro/presubmit/bigtable-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.table=projects/gcloud-devel/instances/google-cloud-bigtable/tables/integration-tests"
value: "google-cloud-clients/google-cloud-bigtable -Dbigtable.env=prod -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable -Dbigtable.table=integration-tests"
}

env_vars: {
Expand Down
2 changes: 1 addition & 1 deletion .kokoro/presubmit/bigtableadmin-it.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ env_vars: {

env_vars: {
key: "INTEGRATION_TEST_ARGS"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.instance=projects/gcloud-devel/instances/google-cloud-bigtable"
value: "google-cloud-clients/google-cloud-bigtable-admin -Dbigtable.project=gcloud-devel -Dbigtable.instance=google-cloud-bigtable"
}

env_vars: {
Expand Down
15 changes: 12 additions & 3 deletions .kokoro/release/drop.sh
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,20 @@

set -eo pipefail

# STAGING_REPOSITORY_ID must be set
if [ -z "${STAGING_REPOSITORY_ID}" ]; then
echo "Missing STAGING_REPOSITORY_ID environment variable"
exit 1
fi

source $(dirname "$0")/common.sh
MAVEN_SETTINGS_FILE=$(realpath $(dirname "$0")/../)/settings.xml
pushd $(dirname "$0")/../
MAVEN_SETTINGS_FILE=$(realpath $(dirname "$0")/../../)/settings.xml
pushd $(dirname "$0")/../../

setup_environment_secrets
create_settings_xml_file "settings.xml"

mvn nexus-staging:drop -P release
mvn nexus-staging:drop -B \
-P release \
--settings ${MAVEN_SETTINGS_FILE} \
-DstagingRepositoryId=${STAGING_REPOSITORY_ID}
15 changes: 12 additions & 3 deletions .kokoro/release/promote.sh
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,20 @@

set -eo pipefail

# STAGING_REPOSITORY_ID must be set
if [ -z "${STAGING_REPOSITORY_ID}" ]; then
echo "Missing STAGING_REPOSITORY_ID environment variable"
exit 1
fi

source $(dirname "$0")/common.sh
MAVEN_SETTINGS_FILE=$(realpath $(dirname "$0")/../)/settings.xml
pushd $(dirname "$0")/../
MAVEN_SETTINGS_FILE=$(realpath $(dirname "$0")/../../)/settings.xml
pushd $(dirname "$0")/../../

setup_environment_secrets
create_settings_xml_file "settings.xml"

mvn nexus-staging:release -P release
mvn nexus-staging:release -B \
-P release \
--settings ${MAVEN_SETTINGS_FILE} \
-DstagingRepositoryId=${STAGING_REPOSITORY_ID}
8 changes: 6 additions & 2 deletions .kokoro/release/stage.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,11 @@
# Need to save the properties file
action {
define_artifacts {
regex: "github/google-cloud-java/target/nexus-staging/staging/*.properties"
strip_prefix: "github/google-cloud-java"
regex: "**/target/nexus-staging/staging/*.properties"
regex: "**/target/*.jar"
regex: "**/target/*.jar.asc"
regex: "**/target/*.pom"
regex: "**/target/*.pom.asc"
fail_if_no_artifacts: true
}
}
3 changes: 1 addition & 2 deletions .kokoro/release/stage.sh
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,9 @@ pushd $(dirname "$0")/../../
setup_environment_secrets
create_settings_xml_file "settings.xml"

mvn clean install deploy \
mvn clean deploy -B \
-DskipTests=true \
--settings ${MAVEN_SETTINGS_FILE} \
-DstagingProfileId=3187e4f20d328b \
-Dgpg.executable=gpg \
-Dgpg.passphrase=${GPG_PASSPHRASE} \
-Dgpg.homedir=${GPG_HOMEDIR} \
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ If you are using Maven, add this to your pom.xml file
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-bom</artifactId>
<version>0.74.0-alpha</version>
<version>0.76.0-alpha</version>
<type>pom</type>
<scope>import</scope>
</dependency>
Expand All @@ -86,11 +86,11 @@ If you are using Maven, add this to your pom.xml file
[//]: # ({x-version-update-start:google-cloud-storage:released})
If you are using Gradle, add this to your dependencies
```Groovy
compile 'com.google.cloud:google-cloud-storage:1.56.0'
compile 'com.google.cloud:google-cloud-storage:1.58.0'
```
If you are using SBT, add this to your dependencies
```Scala
libraryDependencies += "com.google.cloud" % "google-cloud-storage" % "1.56.0"
libraryDependencies += "com.google.cloud" % "google-cloud-storage" % "1.58.0"
```
[//]: # ({x-version-update-end})

Expand All @@ -111,7 +111,7 @@ If you are running into problems with version conflicts, the easiest way to solv
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-bom</artifactId>
<version>0.74.0-alpha</version>
<version>0.76.0-alpha</version>
<type>pom</type>
<scope>import</scope>
</dependency>
Expand Down
155 changes: 97 additions & 58 deletions RELEASING.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,97 @@
One-time setup
==============
## Setup

### Install releasetool

See [releasetool](https://github.com/googleapis/releasetool) for installation instructions. You will
need python 3.6+ to run this tool.

## Prepare a release

1. Make sure the team agrees that it is time to release.

2. Look over all of the commits since the last release and make sure there are no breaking changes
on the public surface. If there are any breaking changes, create and merge a new PR to revert the
surface back.

**Note:** this should just be a scan of the public surface that would appear in Java doc.
Implementation changes, README changes, and snippet changes can all be skipped for this check.

3. Verify that all unit and integration tests for the last commit have passed.

4. Run `releasetool start`. Select "minor" or "patch" for the release type. This will bump the
artifact versions, ask you to edit release notes, and create the release pull request.

**Note:** be sure to make these notes nice as they will be used for the release notes as well.

## Pushing a release to Maven using Kokoro

To manually publish the artifacts to Maven (rather than using Kokoro), you will need to follow the
"Additional setup for manual publishing" steps below and follow the instructions in the
"Manually publishing" section.

1. Trigger the `google-cloud-java/release/stage` Kokoro job and wait for it to complete. This will
stage the built artifacts and prepare them for publishing.

2. Look through the logs for the `google-cloud-java/release/stage` and find the staging repository
ids used. They will look like `comgoogleapi-XYZ` and `comgooglecloud-XYZ`.

3. Promote or drop the staged repository.

a. To publish the staged repository, trigger the `google-cloud-java/release/promote` Kokoro job for
each staging repository. To specify the staging repository, add an environment variable
configuration with `STAGING_REPOSITORY_ID=<staging repository id>` from the UI. **Note: thi
will need to be run for each staging repository. It may take a few hours for the released
versions to be available for users to download.**

b. To drop (abort) the staged repository, trigger the `google-cloud-java/release/drop` Kokoro job
with the same staging repository id configuration as if you were publishing.

## Publish Javadoc

1. Run `git clean -x -f -d` to put the repo in a clean state.

2. Locally build the repo by running `mvn install -DskipTests`.

3. Run `python utilities/stage_sites.py`. This script checks out `gh-pages` branch of the
repository, builds the documentation site and javadocs, copies them to the branch and commits it.
This script does not push the docs and it must be done manually on the later step. The script
assumes that there is no directory called `tmp_gh-pages` in the repository root. If it is
present, remove it before running the script.

4. Run `cd tmp_gh-pages && git push && cd ..`.

5. (Optional) Run `rm -rf tmp_gh-pages` to remove the generated docs directory from your local
machine.

## Tag the release

1. Run `releasetool tag` to publish a release on Github. It will list the last few merged PRs.
Select the newly merged release PR. Releasetool will create the GitHub release with notes
extracted from the pull request and tag the new release.

## Prepare the next snapshot version

1. Run `releasetool start` to bump the next snapshot version. Select "snapshot" when prompted for
the release type. This will bump the artifact versions and create a pull request.

2. Review and submit the PR.

## Additional setup for manual publishing

### Set up Sonatype Account

Set up Sonatype Account
-----------------------
* Sign up for a Sonatype JIRA account [here](https://issues.sonatype.org)
* Click *Sign Up* in the login box, follow instructions

Get access to repository
------------------------
### Get access to repository

* Go to [community support](https://issues.sonatype.org/browse/OSSRH)
* Ask for publish rights by creating an issue similar to [this one](https://issues.sonatype.org/browse/OSSRH-32032)
* You must be logged in to create a new issue
* Use the *Create* button at the top tab

Set up PGP keys
---------------
### Set up PGP keys

* Install GNU Privacy Guard (GPG)
* GPG is installed by default on Ubuntu systems
* For other systems, see [GnuPG download page](https://www.gnupg.org/download/)
Expand All @@ -30,8 +107,8 @@ Set up PGP keys

* Upload your public key to a public server: ```gpg --send-keys --keyserver hkp://pgp.mit.edu ABCDEFGH```

Create a Maven settings file
----------------------------
### Create a Maven settings file

* Create a file at ```$HOME/.m2/settings.xml``` with your passphrase and your sonatype username and password
```
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
Expand Down Expand Up @@ -72,42 +149,13 @@ Create a Maven settings file

Make sure you are using Maven version 3.3 or higher to support the Nexus plugin required to stage a release.

Install releasetool
-------------------
See [releasetool](https://github.com/googleapis/releasetool) for installation instructions. You will
need python 3.6+ to run this tool.

To push a release version
=========================
### Manually publishing (from a local machine)

1. Make sure the team agrees that it is time to release.
1. Run `git clean -x -f -d` to put the repo in a clean state.

2. Look over all of the commits since the last release and make sure there are no breaking changes
on the public surface. If there are any breaking changes, create and merge a new PR to revert the
surface back.

**Note:** this should just be a scan of the public surface that would appear in Java doc.
Implementation changes, README changes, and snippet changes can all be skipped for this check.
2. Locally build the repo by running `mvn install -DskipTests`.

3. Verify that all unit and integration tests for the last commit have passed.

4. Run `releasetool start`. Select "minor" or "patch" for the release type. This will bump the
artifact versions, ask you to edit release notes, and create the release pull request.

**Note:** be sure to make these notes nice as they will be used for the release notes as well.

5. Run `git clean -x -f -d` to put the repo in a clean state.

6. Locally build the repo by running `mvn install -DskipTests`.

7. Run `python utilities/stage_sites.py`. This script checks out `gh-pages` branch of the
repository, builds the documentation site and javadocs, copies them to the branch and commits it.
This script does not push the docs and it must be done manually on the later step. The script
assumes that there is no directory called `tmp_gh-pages` in the repository root. If it is
present, remove it before running the script.

8. Check that you are not trying to release a SNAPSHOT build (the artifacts versions do not have
"-SNAPSHOT" suffix) and then run `mvn clean deploy -DskipTests=true --settings ~/.m2/settings.xml -P release`
3. and then run `mvn clean deploy -DskipTests=true --settings ~/.m2/settings.xml -P release`
command. It will build and deploy artifacts to the staging repository.

**Note:** you may need to specify the stagingProfileId with `-DstagingProfileId=3187e4f20d328b`
Expand All @@ -116,20 +164,11 @@ To push a release version
9. Run `mvn nexus-staging:release` to release the artifacts. If you wish to abort the release, run
`mvn nexus-staging:drop`.

10. Run `cd tmp_gh-pages && git push && cd ..` to push the previously generated docs (step 7).

11. Run `rm -rf tmp_gh-pages` to remove the generated docs directory from your local machine.

12. Run `releasetool tag` to publish a release on Github. It will list the last few merged PRs.
Select the newly merged release PR. Releasetool will create the GitHub release with notes
extracted from the pull request and tag the new release.

13. Run `releasetool start` to bump the next snapshot version. Select "snapshot" when prompted for
the release type. This will bump the artifact versions and create a pull request.

14. Review and submit the PR.
## Improvements

Improvements
============
* Automatic tagging is not currently implemented, though it was discussed in #119. If the version
updates continue to be manual, a one-line git tag command can be added to `after_success.sh` to
correctly tag releases. However, automatically creating useful annotations for this tag will be
difficult. Also, if the release process becomes fully automated, tagging becomes a harder
problem, as mentioned in that issue.

Automatic tagging is not currently implemented, though it was discussed in [#119](https://github.com/googleapis/google-cloud-java/pull/119). If the version updates continue to be manual, a one-line git tag command can be added to `after_success.sh` to correctly tag releases. However, automatically creating useful annotations for this tag will be difficult. Also, if the release process becomes fully automated, tagging becomes a harder problem, as mentioned in that issue.
7 changes: 5 additions & 2 deletions TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,9 @@ To use the `prod` environment:
```shell
mvn verify -am -pl google-cloud-bigtable \
-Dbigtable.env=prod \
-Dbigtable.table=projects/my-project/instances/my-instance/tables/my-table
-Dbigtable.project=my-project
-Dbigtable.instance=my-instance
-Dbigtable.table=my-table
```

### Testing code that uses Bigtable Admin
Expand All @@ -77,7 +79,8 @@ To run the tests:
created earlier. Example:
```shell
mvn verify -am -pl google-cloud-bigtable-admin \
-Dbigtable.instance=projects/my-project/instances/my-instance
-Dbigtable.project=my-project
-Dbigtable.instance=my-instance
```

### Testing code that uses Compute
Expand Down
4 changes: 2 additions & 2 deletions google-api-grpc/grpc-google-cloud-asset-v1beta1/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<artifactId>grpc-google-cloud-asset-v1beta1</artifactId>
<version>0.39.1-SNAPSHOT</version><!-- {x-version-update:grpc-google-cloud-asset-v1beta1:current} -->
<version>0.41.0</version><!-- {x-version-update:grpc-google-cloud-asset-v1beta1:current} -->
<name>grpc-google-cloud-asset-v1beta1</name>
<description>GRPC library for grpc-google-cloud-asset-v1beta1</description>
<parent>
<groupId>com.google.api.grpc</groupId>
<artifactId>google-api-grpc</artifactId>
<version>0.39.1-SNAPSHOT</version><!-- {x-version-update:google-api-grpc:current} -->
<version>0.41.0</version><!-- {x-version-update:google-api-grpc:current} -->
</parent>
<dependencies>
<dependency>
Expand Down
Loading