Valkey GLIDE for Go GA blog #277

jbrinkman · 2025-06-17T20:06:51Z

Description

This blog discusses the GA release announcement for go client for Valkey GLIDE and sharing some design/methods we took, and some code snippets to encourage users to try.

This is an update of pr #253

Check List

Commits are signed per the DCO using --signoff

By submitting this pull request, I confirm that my contribution is made under the terms of the BSD-3-Clause License.

Signed-off-by: Niharika Bhavaraju <nbhavaraju@google.com>

…nTelemetry tracing Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

content/blog/2025-05-08-go-client-GA.md

Yury-Fridlyand · 2025-06-17T21:15:35Z

content/blog/2025-05-08-go-client-GA.md

Fix filename to the correct date

That will get fixed with the actual release of the blog. Until we get final approval that is a moving date.

Yury-Fridlyand · 2025-06-17T21:15:43Z

content/blog/2025-05-08-go-client-GA.md

+++
+title= "Valkey GLIDE Go Client: Now Generally Available!"
+description = "Valkey GLIDE Go client reaches general availability. Read to learn more about the go client designed for performance and developer productivity"
+date= 2025-05-08 01:01:01


This will get fixed when the blog is finally approved/posted.

Yury-Fridlyand · 2025-06-17T21:17:09Z

content/blog/2025-05-08-go-client-GA.md

+
+- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.
+- Complete support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.
+- Support for OpenTelemetry tracing which has been added to all language clients, including Go.


Should we highlight context support?
And revised structs in responses

I added context. The revised structs I think are a little too low level, like refactoring package names and moving internal implementation details.

Yury-Fridlyand · 2025-06-17T21:19:56Z

content/blog/2025-05-08-go-client-GA.md

+- Maintains high throughput through efficient connection pipelining
+- Decreases server-side connection management burden
+
+### Built for Performance


I think "Getting Started" should go first, technical details and benchmarking code - after that

For a blog like this, you need to provide the details on why this is a significant event. Once you have their attention, you can provide the information on how they get started. I want them to read the blog first before I have them start following links to other locations and opening code. Imagine seeing an advertisement on TV for a new product. It would seem strange for them to tell you to call some number to order the product before they have even provided the information about why the product is so great, and maybe shown you some examples of how the product will improve your life. Info first, then a Call to Action.

Yury-Fridlyand · 2025-06-17T21:24:56Z

content/blog/2025-05-08-go-client-GA.md

+    WithRequestTimeout(500) // 500ms timeout
+```
+
+## Behind the Scenes: Technical Architecture


Probably move this section to the very end, after batch and others

All of these are part of the basic client configuration. It makes sense to keep them together before batch concepts which are even more advanced.

content/blog/2025-05-08-go-client-GA.md

Yury-Fridlyand · 2025-06-17T21:29:37Z

content/blog/2025-05-08-go-client-GA.md

+	for i, result := range results {
+		fmt.Printf("Command %s results: %v\n", txs[i], result)
+	}
+```


Maybe show an example of receiving error with raiseOnError set and unset (see TestBatchRaiseOnError)

Blog post is already quite long. I don't think we have room to cover every single option and feature. We have documentation for that.

content/blog/2025-05-08-go-client-GA.md

Yury-Fridlyand · 2025-06-17T21:31:18Z

content/blog/2025-05-08-go-client-GA.md

+raiseOnError := true
+results, err := client.Exec(context.Background(), *tx, raiseOnError)
+```
+


Proposal: show example with context, pubsub, open telemetry

I'm trying not to expand the blog post even further than it already is. As blog posts go, this is already quite large. We should probably create separate blog posts for each of thos concepts, so that they can be adequately addressed. Quite honestly, if I were writing the posts from scratch, I would have created a general high level blog for the 2.0 release, and then separate blogs for each of the major features we want to highlight. I'll let @madolson and @stockholmux guide us on how they want to proceed here.

Yeah, my opinion is that this post is already like 2x-3x longer than I would like. The average person reads a Valkey.io blog for about 3.5 minutes, so ideally we want it to be about that long and convey the N most important things. There is also a lot of overlap with https://valkey.io/blog/2025-03-4-go-client-in-public-preview/.

I think ideally I would just focus on batch support and open telemetry integration. Everything else seems duplicative of work discussed elsewhere.

Co-authored-by: Yury-Fridlyand <yury.fridlyand@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Co-authored-by: Yury-Fridlyand <yury.fridlyand@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

content/blog/2025-05-08-go-client-GA.md

acarbonetto · 2025-06-18T04:02:33Z

content/blog/2025-05-08-go-client-GA.md

+
+The Valkey GLIDE contributors are pleased to announce the general availability (GA) release of the Valkey GLIDE Go client. This release brings the power and reliability of Valkey to Go developers with an API designed for performance and developer productivity.
+
+Vakey GLIDE 2.0 brings exciting new features for all of our language clients (Java, Node.js, Python, and now Go). These features include pipelines, OpenTelemetry support, MacOS x86 support, and improved performance and bug fixes.


link to changelog?

content/blog/2025-05-08-go-client-GA.md

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

content/blog/2025-05-08-go-client-GA.md

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Co-authored-by: Andrew Carbonetto <andrew.carbonetto@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

madolson · 2025-06-18T20:08:54Z

content/blog/2025-05-08-go-client-GA.md

+raiseOnError := true
+results, err := client.Exec(context.Background(), *tx, raiseOnError)
+```
+


Yeah, my opinion is that this post is already like 2x-3x longer than I would like. The average person reads a Valkey.io blog for about 3.5 minutes, so ideally we want it to be about that long and convey the N most important things. There is also a lot of overlap with https://valkey.io/blog/2025-03-4-go-client-in-public-preview/.

I think ideally I would just focus on batch support and open telemetry integration. Everything else seems duplicative of work discussed elsewhere.

madolson · 2025-06-18T20:12:37Z

content/blog/2025-05-08-go-client-GA.md

+- Implementation of `Watch()` that monitors keys for changes,
+- Implementation of `Unwatch()` that releases monitoring,
+- Proper handling of transaction failure when watched keys change,
+- Passing watch state through to the Valkey server during execution.


Is the persona reading this blog going to know what this means.

I would also remove "Proper handling of transaction failure when watched keys change", since I don't know what that means.

madolson · 2025-06-18T20:15:07Z

content/blog/2025-05-08-go-client-GA.md

+
+The Valkey GLIDE contributors are pleased to announce the general availability (GA) release of the Valkey GLIDE Go client. This release brings the power and reliability of Valkey to Go developers with an API designed for performance and developer productivity.
+
+Vakey GLIDE 2.0 brings exciting new features for all of our language clients (Java, Node.js, Python, and now Go). These features include pipelines, OpenTelemetry support, MacOS x86 support, improved performance, and bug fixes.


I would cut this. It seems like maybe this is worth a separate blog post, but it's not really relevant to this blog.

madolson · 2025-06-18T20:15:35Z

content/blog/2025-05-08-go-client-GA.md

+
+## What's new in GA?
+
+- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.


Suggested change

- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.

- The major addition in the GA release is [batch support](#batch-support) that includes both transactions and pipelines.

madolson · 2025-06-18T20:15:50Z

content/blog/2025-05-08-go-client-GA.md

+## What's new in GA?
+
+- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.
+- Complete support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.


Suggested change

- Complete support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.

- Support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.

madolson · 2025-06-18T20:16:12Z

content/blog/2025-05-08-go-client-GA.md

+- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.
+- Complete support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.
+- Support for OpenTelemetry tracing which has been added to all language clients, including Go.
+- Go context support for all commands and batch operations.


Suggested change

- Go context support for all commands and batch operations.

madolson · 2025-06-18T20:16:36Z

content/blog/2025-05-08-go-client-GA.md

+
+## Key Features
+
+### Advanced Cluster Topology Management


This seems duplicative of https://valkey.io/blog/2025-03-4-go-client-in-public-preview/

jbrinkman · 2025-06-19T19:04:55Z

This was originally just supposed to be cleaning up a post written by a contractor no longer working on the project. At this point, with all the apparent duplication, it is a significant rewrit to get it trimmed down and focused on just the essential items. I'll close this PR and resubmit a fresh file that incorporates the feedback above. Some of the examples, which I've already rewritten once, will be re-used, but the rest of the post will be new.

niharikabhavaraju and others added 4 commits June 16, 2025 19:11

Valkey Glide Go client transaction blog

919a670

Signed-off-by: Niharika Bhavaraju <nbhavaraju@google.com>

Added GA release blog content

f4c337b

Signed-off-by: Niharika Bhavaraju <nbhavaraju@google.com>

minor change

18c0715

Signed-off-by: Niharika Bhavaraju <nbhavaraju@google.com>

docs: update Go client docs for v2 release with batch support and Ope…

7e11c78

…nTelemetry tracing Signed-off-by: jbrinkman <joe.brinkman@improving.com>

jbrinkman requested review from madolson and stockholmux as code owners June 17, 2025 20:06

docs: apply changes based on feedback in pr253

c547d06

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Yury-Fridlyand reviewed Jun 17, 2025

View reviewed changes

Yury-Fridlyand mentioned this pull request Jun 17, 2025

Valkey-Glide Go client GA release announcement blog #253

Open

1 task

yipin-chen mentioned this pull request Jun 17, 2025

Release 2.0 Tasks & Checklist valkey-io/valkey-glide#4070

Closed

31 tasks

jbrinkman and others added 4 commits June 17, 2025 20:12

Update content/blog/2025-05-08-go-client-GA.md

8d328cf

Co-authored-by: Yury-Fridlyand <yury.fridlyand@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

docs: apply changes based on feedback

8e609e4

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Update content/blog/2025-05-08-go-client-GA.md

c8a9237

Co-authored-by: Yury-Fridlyand <yury.fridlyand@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

docs: update contributions list

07fc581

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Yury-Fridlyand approved these changes Jun 18, 2025

View reviewed changes

content/blog/2025-05-08-go-client-GA.md Outdated Show resolved Hide resolved

acarbonetto approved these changes Jun 18, 2025

View reviewed changes

omanges reviewed Jun 18, 2025

View reviewed changes

content/blog/2025-05-08-go-client-GA.md Outdated Show resolved Hide resolved

docs: update contributors spellings and links

76aeb2c

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

vikaskpandey reviewed Jun 18, 2025

View reviewed changes

content/blog/2025-05-08-go-client-GA.md Outdated Show resolved Hide resolved

jbrinkman and others added 3 commits June 18, 2025 08:36

docs: fix Vikas github url

1a33594

Signed-off-by: jbrinkman <joe.brinkman@improving.com>

Update content/blog/2025-05-08-go-client-GA.md

6f826d6

Co-authored-by: Andrew Carbonetto <andrew.carbonetto@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

Update content/blog/2025-05-08-go-client-GA.md

b5ce022

Co-authored-by: Andrew Carbonetto <andrew.carbonetto@improving.com> Signed-off-by: Joseph Brinkman <joe.brinkman@improving.com>

madolson reviewed Jun 18, 2025

View reviewed changes

jbrinkman closed this Jun 19, 2025


		The Valkey GLIDE contributors are pleased to announce the general availability (GA) release of the Valkey GLIDE Go client. This release brings the power and reliability of Valkey to Go developers with an API designed for performance and developer productivity.

		Vakey GLIDE 2.0 brings exciting new features for all of our language clients (Java, Node.js, Python, and now Go). These features include pipelines, OpenTelemetry support, MacOS x86 support, and improved performance and bug fixes.


		## What's new in GA?

		- The major addition in the GA release is comprehensive [batch support](#batch-support) that includes both transactions and pipelines.

	- Complete support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.
	- Support for all Valkey commands encompassing scripting, functions, pubsub, server management, and all other operations in both standalone and cluster modes.

Valkey GLIDE for Go GA blog #277

Valkey GLIDE for Go GA blog #277

Uh oh!

Conversation

jbrinkman commented Jun 17, 2025

Description

Check List

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jbrinkman Jun 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jbrinkman commented Jun 19, 2025

Uh oh!

Uh oh!

jbrinkman Jun 18, 2025 •

edited

Loading