You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@calcite.apache.org by fr...@apache.org on 2022/03/27 22:48:18 UTC
[calcite-avatica-go] branch master updated: Update website for 5.1.0 release and replace docker-compose with docker compose
This is an automated email from the ASF dual-hosted git repository.
francischuang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/calcite-avatica-go.git
The following commit(s) were added to refs/heads/master by this push:
new c88607c Update website for 5.1.0 release and replace docker-compose with docker compose
c88607c is described below
commit c88607c1be48aacfd717f33103bd9ce58b5c7345
Author: Francis Chuang <fr...@apache.org>
AuthorDate: Mon Mar 28 09:47:51 2022 +1100
Update website for 5.1.0 release and replace docker-compose with docker compose
---
docker.sh | 4 +--
site/_docs/go_history.md | 2 +-
site/_docs/go_howto.md | 20 +++++------
site/_posts/2022-03-27-release-avatica-go-5.1.0.md | 39 ++++++++++++++++++++++
site/develop/avatica-go.md | 16 ++++-----
5 files changed, 60 insertions(+), 21 deletions(-)
diff --git a/docker.sh b/docker.sh
index 175d7dc..90350cd 100755
--- a/docker.sh
+++ b/docker.sh
@@ -473,9 +473,9 @@ https://github.com/apache/calcite-avatica-go/blob/$COMMIT/site/develop/avatica-g
Please vote on releasing this package as Apache Calcite Avatica Go $TAG_WITHOUT_RC.
-To run the tests without a Go environment, install docker and docker-compose. Then, in the root of the release's directory, run: docker-compose run test
+To run the tests without a Go environment, install docker and docker compose. Then, in the root of the release's directory, run: docker compose run test
-When the test suite completes, run \"docker-compose down\" to remove and shutdown all the containers.
+When the test suite completes, run \"docker compose down\" to remove and shutdown all the containers.
The vote is open for the next 72 hours and passes if a majority of at least three +1 PMC votes are cast.
diff --git a/site/_docs/go_history.md b/site/_docs/go_history.md
index c02a9fb..a2264c9 100644
--- a/site/_docs/go_history.md
+++ b/site/_docs/go_history.md
@@ -28,7 +28,7 @@ For a full list of releases, see
Downloads are available on the
[downloads page]({{ site.baseurl }}/downloads/avatica-go.html).
-## <a href="https://github.com/apache/calcite-avatica-go/releases/tag/v5.1.0">5.1.0</a> / 2022-04-XX
+## <a href="https://github.com/apache/calcite-avatica-go/releases/tag/v5.1.0">5.1.0</a> / 2022-03-27
{: #v5-1-0}
Apache Calcite Avatica Go 5.1.0 is a maintenance release of Avatica Go with some dependency updates and bug fixes.
diff --git a/site/_docs/go_howto.md b/site/_docs/go_howto.md
index 8cc0c7e..c811c5d 100644
--- a/site/_docs/go_howto.md
+++ b/site/_docs/go_howto.md
@@ -49,19 +49,19 @@ the script will make a copy of the contents and move it to a different location,
{% highlight bash %}
# On Linux:
-docker-compose run -v ~/.gnupg:/.gnupg dry-run
+docker compose run -v ~/.gnupg:/.gnupg dry-run
# On Windows
-docker-compose run -v /c/Users/username/AppData/Roaming/gnupg:/.gnupg dry-run
+docker compose run -v /c/Users/username/AppData/Roaming/gnupg:/.gnupg dry-run
{% endhighlight %}
### Build the release
{% highlight bash %}
# On Linux:
-docker-compose run -v ~/.gnupg:/.gnupg release
+docker compose run -v ~/.gnupg:/.gnupg release
# On Windows
-docker-compose run -v /c/Users/username/AppData/Roaming/gnupg:/.gnupg release
+docker compose run -v /c/Users/username/AppData/Roaming/gnupg:/.gnupg release
{% endhighlight %}
If the build fails, perform a clean:
@@ -73,7 +73,7 @@ git push origin :refs/tags/vX.Y.Z-rcA
2. Clean the local repository
{% highlight bash %}
-docker-compose run clean
+docker compose run clean
{% endhighlight %}
### Check the release before uploading
@@ -110,7 +110,7 @@ Note the use of `--force-log` to suppress the svn warning, because the commit me
This assumes that a release was built and the artifacts are in the `dist/` folder.
{% highlight bash %}
-docker-compose run publish-release-for-voting
+docker compose run publish-release-for-voting
{% endhighlight %}
The script will also generate a vote email to send to the dev list. You can use this email, but make sure to check that
@@ -149,10 +149,10 @@ https://github.com/apache/calcite-avatica-go/blob/$COMMIT/site/develop/avatica-g
Please vote on releasing this package as Apache Calcite Avatica Go X.Y.Z.
-To run the tests without a Go environment, install docker and docker-compose. Then, in the root of the release's directory, run:
-docker-compose run test
+To run the tests without a Go environment, install docker and docker compose. Then, in the root of the release's directory, run:
+docker compose run test
-When the test suite completes, run \"docker-compose down\" to remove and shutdown all the containers.
+When the test suite completes, run \"docker compose down\" to remove and shutdown all the containers.
The vote is open for the next 72 hours and passes if a majority of
at least three +1 PMC votes are cast.
@@ -222,7 +222,7 @@ git push origin vX.Y.Z
This assumes that a rc release was tagged and pushed to the git repository.
{% highlight bash %}
-docker-compose run promote-release
+docker compose run promote-release
{% endhighlight %}
### Announce the release
diff --git a/site/_posts/2022-03-27-release-avatica-go-5.1.0.md b/site/_posts/2022-03-27-release-avatica-go-5.1.0.md
new file mode 100644
index 0000000..92adc29
--- /dev/null
+++ b/site/_posts/2022-03-27-release-avatica-go-5.1.0.md
@@ -0,0 +1,39 @@
+---
+layout: news_item
+date: "2022-03-27 08:30:00 +0000"
+author: francischuang
+version: 5.1.0
+categories: [release]
+tag: v5-1-0
+sha: c232d7b
+component: avatica-go
+---
+<!--
+{% comment %}
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+{% endcomment %}
+-->
+
+Apache Calcite Avatica Go 5.1.0 is a maintenance release of Avatica Go with some dependency updates and bug fixes.
+This release supports Go 1.17 and 1.18, which are currently the versions supported and maintained by the Go team.
+
+Of particular note is the replacement of the [github.com/golang/protobuf](https://github.com/golang/protobuf) package with
+[google.golang.org/protobuf](https://pkg.go.dev/google.golang.org/protobuf) and the
+[golang.org/x/xerrors](https://pkg.go.dev/golang.org/x/xerrors) package with the standard library's built-in
+[errors](https://pkg.go.dev/errors) package as the former packages have all be superseded by their replacements.
+
+The Calcite team recommends users of this package to upgrade to this version, where practical, as the dependencies being
+used by this package have also been upgraded.
\ No newline at end of file
diff --git a/site/develop/avatica-go.md b/site/develop/avatica-go.md
index 8cb7c66..42d8af4 100644
--- a/site/develop/avatica-go.md
+++ b/site/develop/avatica-go.md
@@ -32,8 +32,8 @@ To file issues, please use the [Calcite JIRA](https://issues.apache.org/jira/pro
as the component.
## Updating protobuf definitions
-1. Install [docker](https://docs.docker.com/install/) and [docker-compose](https://docs.docker.com/compose/install/).
-2. From the root of the repository, run `docker-compose run compile-protobuf`
+1. Install [docker](https://docs.docker.com/install/) and [docker compose](https://docs.docker.com/compose/install/).
+2. From the root of the repository, run `docker compose run compile-protobuf`
## Live reload during development
It is possible to reload the code in real-time during development. This executes the test suite every time a `.go` or
@@ -41,21 +41,21 @@ It is possible to reload the code in real-time during development. This executes
during development allows us to not have to manually execute the test suite on save.
### Set up
-1. Install [docker](https://docs.docker.com/install/) and [docker-compose](https://docs.docker.com/compose/install/).
+1. Install [docker](https://docs.docker.com/install/) and [docker compose](https://docs.docker.com/compose/install/).
-2. From the root of the repository, run `docker-compose run dev`.
+2. From the root of the repository, run `docker compose run dev`.
-3. After terminating the container, stop all the containers and remove them using: `docker-compose down`
+3. After terminating the container, stop all the containers and remove them using: `docker compose down`
## Testing
The test suite takes around 4 minutes to run if you run both the Avatica HSQLDB and Apache Phoenix tests.
### Easy way
-1. Install [docker](https://docs.docker.com/install/) and [docker-compose](https://docs.docker.com/compose/install/).
+1. Install [docker](https://docs.docker.com/install/) and [docker compose](https://docs.docker.com/compose/install/).
-2. From the root of the repository, run `docker-compose run test`.
+2. From the root of the repository, run `docker compose run test`.
-3. After the tests complete, stop all the containers and remove them using: `docker-compose down`
+3. After the tests complete, stop all the containers and remove them using: `docker compose down`
### Manual set up
1. Install [Go](https://golang.org/doc/install).