-
Notifications
You must be signed in to change notification settings - Fork 574
Add ambient mode caveats #3517
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
base: master
Are you sure you want to change the base?
Add ambient mode caveats #3517
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Original file line number | Diff line number | Diff line change | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
@@ -464,6 +464,9 @@ message ServiceEntry { | |||||||||
// 1. subjectAltNames: In addition to verifying the SANs of the | ||||||||||
// service accounts associated with the pods of the service, the | ||||||||||
// SANs specified here will also be verified. | ||||||||||
// | ||||||||||
// **NOTE 3:** Ambient mode does not support wildcard hostsnames. | ||||||||||
// | ||||||||||
// +kubebuilder:validation:MinItems=1 | ||||||||||
// +kubebuilder:validation:MaxItems=256 | ||||||||||
// +protoc-gen-crd:list-value-validation:XValidation:message="hostname cannot be wildcard",rule="self != '*'" | ||||||||||
|
@@ -595,6 +598,9 @@ message ServiceEntry { | |||||||||
// For a Kubernetes Service, the equivalent effect can be achieved by setting | ||||||||||
// the annotation "networking.istio.io/exportTo" to a comma-separated list | ||||||||||
// of namespace names. | ||||||||||
// | ||||||||||
// **Note:** Ambient mode does not support this field. Service entries will | ||||||||||
// be exported to all namespaces. | ||||||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is this the temporary limitation? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. No, IIRC one of the big changes in ambient is that we want all workloads to have the same view of the mesh. So the same host corresponds to the same service/serviceentry regardless of the workload namespace
Comment on lines
+602
to
+603
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @craigbox same question about ingress |
||||||||||
repeated string export_to = 7; | ||||||||||
|
||||||||||
// If specified, the proxy will verify that the server certificate's | ||||||||||
|
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -21,8 +21,9 @@ syntax = "proto3"; | |||||
// $aliases: [/docs/reference/config/networking/v1alpha3/sidecar] | ||||||
|
||||||
// `Sidecar` describes the configuration of the sidecar proxy that mediates | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. and possibly a "Note 4" that says "Sidecar configuration is not required in ambient mode."? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Its required in sidecar mode either. Its more like, it has no effect in ambient mode There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I so wish that this object had been named " |
||||||
// inbound and outbound communication to the workload instance it is attached to. By | ||||||
// default, Istio will program all sidecar proxies in the mesh with the | ||||||
// inbound and outbound communication to the workload instance it is attached to. | ||||||
// `Sidecar` only applies to Sidecar mode. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
// By default, Istio will program all sidecar proxies in the mesh with the | ||||||
// necessary configuration required to reach every workload instance in the mesh, as | ||||||
// well as accept traffic on all the ports associated with the | ||||||
// workload. The `Sidecar` configuration provides a way to fine tune the set of | ||||||
|
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Original file line number | Diff line number | Diff line change | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
@@ -57,6 +57,11 @@ syntax = "proto3"; | |||||||||||||||||
// The source of traffic can also be matched in a routing rule. This allows routing | ||||||||||||||||||
// to be customized for specific client contexts. | ||||||||||||||||||
// | ||||||||||||||||||
// *Note for Ambient Users*: Support for `VirtualService` in Ambient mode is alpha, and | ||||||||||||||||||
// there are no plans to increase support. | ||||||||||||||||||
// Use [Gateway API](https://istio.io/latest/docs/tasks/traffic-management/ingress/gateway-api/#mesh-traffic) | ||||||||||||||||||
// for a stable traffic management API. | ||||||||||||||||||
// | ||||||||||||||||||
Comment on lines
+60
to
+64
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
perhaps? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. What about
I think "waypoints are configured using gateway api" is confusing since it suggests that they can only be configured using gwapi. Similarly "Alpha, and may be subject to change in future releases" suggests that support could become beta, or even unsupport, however "but will not be progressing it to" suggests that it will be alpha forever (which is what we want to say) |
||||||||||||||||||
// The following example on Kubernetes, routes all HTTP traffic by default to | ||||||||||||||||||
// pods of the reviews service with label "version: v1". In addition, | ||||||||||||||||||
// HTTP requests with path starting with /wpcatalog/ or /consumercatalog/ will | ||||||||||||||||||
|
@@ -818,6 +823,8 @@ message HTTPMatchRequest { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We say above that ambient mode doesn't support anything. How about:
Suggested change
? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Agreed. "support" is ambiguous There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. What about |
||||||||||||||||||
map<string, string> source_labels = 7; | ||||||||||||||||||
|
||||||||||||||||||
// Names of gateways where the rule should be applied. Gateway names | ||||||||||||||||||
|
@@ -859,6 +866,8 @@ message HTTPMatchRequest { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
string source_namespace = 13; | ||||||||||||||||||
|
||||||||||||||||||
// The human readable prefix to use when emitting statistics for this route. | ||||||||||||||||||
|
@@ -990,6 +999,8 @@ message L4MatchAttributes { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
map<string, string> source_labels = 4; | ||||||||||||||||||
|
||||||||||||||||||
// Names of gateways where the rule should be applied. Gateway names | ||||||||||||||||||
|
@@ -1003,6 +1014,8 @@ message L4MatchAttributes { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
string source_namespace = 6; | ||||||||||||||||||
} | ||||||||||||||||||
|
||||||||||||||||||
|
@@ -1034,6 +1047,8 @@ message TLSMatchAttributes { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
map<string, string> source_labels = 5; | ||||||||||||||||||
|
||||||||||||||||||
// Names of gateways where the rule should be applied. Gateway names | ||||||||||||||||||
|
@@ -1047,6 +1062,8 @@ message TLSMatchAttributes { | |||||||||||||||||
// | ||||||||||||||||||
// **Note:** This is not a runtime match, but is a selector; it filters which workloads the | ||||||||||||||||||
// VirtualService applies to. | ||||||||||||||||||
// | ||||||||||||||||||
// **Note:** Ambient mode does not support this field. | ||||||||||||||||||
string source_namespace = 7; | ||||||||||||||||||
} | ||||||||||||||||||
|
||||||||||||||||||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@craigbox I imagine we get into "this works for ingress but not ztunnel/waypoint" too right?