Skip to content

Latest commit

 

History

History
53 lines (43 loc) · 2.42 KB

RELEASING.md

File metadata and controls

53 lines (43 loc) · 2.42 KB
Raw

Releasing

To make a new release of gapic-showcase the following steps should be performed.

  1. Determine the new API version for the api, such as
export VERSION=0.18.0
  1. Create a new branch of the version
git checkout master
git pull origin master
git checkout -b v${VERSION}
  1. The semantic version of this package as well as the API is used across multiple files in gapic-showcase. This needs the be updated. Use the utility script found in util/cmd/bump_version to bump the version across all of the files. Set ${TYPE} to be one of --patch, --minor, --major, --api ${VERSION}, depending which version needs to be updated.
go run ./util/cmd/bump_version --${TYPE}

  1. Update the CHANGELOG.md file with the changes made since the last release including the version in the heading for the changes. Please note that the version must start with the character v in order to match the git tag that will be pushed in a later step. You can get the list of PRs from your local git commit history on the master branch, or from GitHub by using the the query is:pr merged:>=YYYY-MM-DD -author:renovate-bot NOT deps in:title -author:yoshi-code-bot (where the date refers to the last release date; yes, the syntax is slightly unusual because the two -author: conditions don't work when next to each other). You can modify the query template live here.

  2. Create a pull request for this release merging the version branch into master.

  3. Change branches to master and pull.

git checkout master
git pull origin master
  1. Create a tag for the version and push. The automated release will take over from here. Please note that version tags should start with the character v.
git tag v${VERSION}
git push origin v${VERSION}
  1. Build a Docker image.
docker build -t gcr.io/gapic-images/gapic-showcase:latest .
  1. Ensure your Docker daemon is authenticated with your GCP credentials.
gcloud auth login
gcloud auth configure-docker
  1. Tag with the release version and push both the latest and the versioned images.
docker tag gcr.io/gapic-images/gapic-showcase:latest gcr.io/gapic-images/gapic-showcase:${VERSION}
docker push gcr.io/gapic-images/gapic-showcase:latest
docker push gcr.io/gapic-images/gapic-showcase:${VERSION}