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

Documentation Improvement Request: Multi-Primary Cluster Set-Up and Service Discovery #50784

Open
JacobAmar opened this issue May 1, 2024 · 0 comments
Labels
feature/Multi-cluster issues related with multi-cluster support feature/Multi-control-plane issues related with multi-control-plane support in a cluster kind/docs kind/enhancement

Comments

@JacobAmar
Copy link

JacobAmar commented May 1, 2024

Describe the feature request
The Istio's documentation for the setup of multi-primary service mesh needs improvement. The current documentation suggests that DNS proxying or admiral is necessary for service discovery on the target clusters. However, actual experience shows that while DNS proxying is needed, auto address allocation is not required for successful service discovery.

The references to this issue are in the following links:

Multi-primary cluster setup
DNS with multiple clusters

Describe alternatives you've considered

The clarification in the documentation is needed to emphasize that DNS proxying is necessary but not the auto address allocation. The documentation should make it clear that service IPs should not overlap, and indicate that Istio automatically creates a service entry for services found in the remote clusters.

Also, adjustments to the documentation for network name specification during the installation of Istio on a flat network would be useful, since the network name wasn't required in the actual process.

In addition, there should be information detailing the remote-secret creation, particularly mentioning how Istio generates the remote secret from the default service account named "istio-reader-service-account". Also, more information about the required RBACs for automating the process of clusters joining the mesh will be beneficial.

Affected product area (please put an X in all that apply)

[ ] Ambient
[ X ] Docs
[ ] Dual Stack
[ ] Installation
[ ] Networking
[ ] Performance and Scalability
[ ] Extensions and Telemetry
[ ] Security
[ ] Test and Release
[ ] User Experience
[ ] Developer Infrastructure

Affected features (please put an X in all that apply)

[ X ] Multi Cluster
[ ] Virtual Machine
[ X ] Multi Control Plane

@istio-policy-bot istio-policy-bot added feature/Multi-cluster issues related with multi-cluster support feature/Multi-control-plane issues related with multi-control-plane support in a cluster kind/docs kind/enhancement labels May 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
feature/Multi-cluster issues related with multi-cluster support feature/Multi-control-plane issues related with multi-control-plane support in a cluster kind/docs kind/enhancement
Projects
None yet
Development

No branches or pull requests

2 participants