Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Deprecations for connect-native SDK and specific connect native APIs #17937

Merged
merged 21 commits into from
Jun 28, 2023
Prev Previous commit
Next Next commit
Update go.mdx
  • Loading branch information
David Yu authored Jun 28, 2023
commit be0167b4920f2406f53f326780fff2f7633734d7
4 changes: 3 additions & 1 deletion website/content/docs/connect/native/go.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,10 @@ description: >-

# Service Mesh Native Integration for Go Applications

-> **Note:** The Connect Native golang SDK is currently deprecated and will be removed in a future Consul release.
<Note>
The Connect Native golang SDK is currently deprecated and will be removed in a future Consul release.
The eventual removal of the SDK is dependent on the delivery of proxyless GRPC via XDS which is tracked on [GH-10339](https://github.com/hashicorp/consul/issues/10339).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The eventual removal of the SDK is dependent on the delivery of proxyless GRPC via XDS which is tracked on [GH-10339](https://github.com/hashicorp/consul/issues/10339).
We will replace the SDK functionality with proxy-less gRPC connections to Consul xDS. Refer to [GH-10339](https://github.com/hashicorp/consul/issues/10339) for additional information and to track progress toward the replacement functionality.

Is it correct to characterize the upcoming functionality as a replacement for the SDK?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically yes since all that is needed is the native golang package for XDS. I.e.

import _ "google.golang.org/grpc/xds"

</Note>

We provide a library that makes it drop-in simple to integrate Consul service mesh
with most [Go](https://golang.org/) applications. This page shows examples
Expand Down