@@ -7,14 +7,15 @@ examples that can be helpful to demonstrate how the API can be used.
77
88In all cases, it's very important to bear in mind the [ roles and personas]
99used in the Gateway API. The use cases presented here are deliberately
10- described in terms of [ Ana] , [ Charlie] , and [ Ian] : they are the ones for whom the
11- API must be usable. (It's also important to remember that even though these
12- roles might be filled by the same person, especially in smaller organizations,
13- they all have distinct concerns that we need to consider separately.)
10+ described in terms of [ Ana] , [ Chihiro] , and [ Ian] : they are the ones for whom
11+ the API must be usable. (It's also important to remember that even though
12+ these roles might be filled by the same person, especially in smaller
13+ organizations, they all have distinct concerns that we need to consider
14+ separately.)
1415
1516[ roles and personas ] :/concepts/roles-and-personas
1617[ Ana ] :/concepts/roles-and-personas#ana
17- [ Charlie ] :/concepts/roles-and-personas#charlie
18+ [ Chihiro ] :/concepts/roles-and-personas#chihiro
1819[ Ian ] :/concepts/roles-and-personas#ian
1920
2021## The Use Cases
@@ -39,21 +40,21 @@ Kubernetes. Her application will be used by clients outside the cluster, and
3940while Ana has created the application, setting up the cluster is not in her
4041wheelhouse.
4142
42- 1 . Ana goes to Charlie to ask them to set up a cluster. Ana tells Charlie that
43+ 1 . Ana goes to Chihiro to ask them to set up a cluster. Ana tells Chihiro that
4344 her clients will expect her APIs to be available using URLs rooted at
4445 ` https://ana.application.com/ ` .
4546
46- 2 . Charlie goes to Ian and requests a cluster.
47+ 2 . Chihiro goes to Ian and requests a cluster.
4748
48493 . Ian provisions a cluster running a gateway controller with a [ GatewayClass]
4950 resource named ` basic-gateway-class ` . The gateway controller manages the
5051 infrastructure associated with routing traffic from outside the cluster to
5152 inside the cluster.
5253
53- 4 . Ian gives Charlie credentials to the new cluster, and tells Charlie that
54+ 4 . Ian gives Chihiro credentials to the new cluster, and tells Chihiro that
5455 they can use GatewayClass ` basic-gateway-class ` to set things up.
5556
56- 5 . Charlie applies a [ Gateway] named ` ana-gateway ` to the cluster, telling it
57+ 5 . Chihiro applies a [ Gateway] named ` ana-gateway ` to the cluster, telling it
5758 to listen on port 443 for TLS traffic, and providing it a TLS certificate
5859 with a Subject CN of ` ana.application.com ` . They associate this Gateway with the ` basic-gateway-class ` GatewayClass.
5960
@@ -63,10 +64,10 @@ wheelhouse.
6364 443, and starts watching for routing resources associated with
6465 ` ana-gateway ` .
6566
66- 7 . Charlie gets the IP address of ` ana-gateway ` and creates a DNS record
67+ 7 . Chihiro gets the IP address of ` ana-gateway ` and creates a DNS record
6768 outside the cluster for ` ana.application.com ` to match.
6869
69- 8 . Charlie tells Ana that she's good to go, using the Gateway named
70+ 8 . Chihiro tells Ana that she's good to go, using the Gateway named
7071 ` ana-gateway ` .
7172
72739 . Ana writes and applies [ HTTPRoute] resources to configure which URL paths
@@ -77,7 +78,7 @@ wheelhouse.
777810 . At this point, when requests arrive at the load balancer, they are routed
7879 to Ana's application according to her routing specification.
7980
80- This allows Charlie to enforce centralized policies [ such as
81+ This allows Chihiro to enforce centralized policies [ such as
8182TLS] ( /guides/tls#downstream-tls ) at the Gateway, while simultaneously allowing
8283Ana and her colleagues control over the application's [ routing
8384logic] ( /guides/http-routing ) and rollout plans (e.g. [ traffic splitting
@@ -98,20 +99,20 @@ Ana and her team are managing a storefront application in the `store`
9899Namespace, while Allison and her team are managing a website in the ` site `
99100Namespace.
100101
101- - Ian and Charlie work together to provide a cluster, ` GatewayClass ` , and
102+ - Ian and Chihiro work together to provide a cluster, ` GatewayClass ` , and
102103 ` Gateway ` , as above.
103104
104105- Ana and Allison independently deploy workloads and HTTPRoutes bound to the
105106 same ` Gateway ` resource.
106107
107- Again, this separation of concerns allows Charlie to enforce centralized
108+ Again, this separation of concerns allows Chihiro to enforce centralized
108109policies [ such as TLS] ( /guides/tls#downstream-tls ) can be enforced at the
109110Gateway. Meanwhile, Ana and Allison run their applications [ in their own
110111Namespaces] ( /guides/multiple-ns ) , but attach their Routes to the same shared
111112Gateway, allowing them to independently control their [ routing
112113logic] ( /guides/http-routing ) , [ traffic splitting
113114rollout] ( /guides/traffic-splitting ) , etc., while not worrying about the things
114- that Charlie and Ian are handling.
115+ that Chihiro and Ian are handling.
115116
116117[ HTTPRoute ] :/api-types/httproute
117118[ GatewayClass ] :/api-types/gatewayclass
@@ -134,7 +135,7 @@ protect her workload by rejecting calls to her workload with incorrect
134135URL paths, and by enforcing timeouts whenever anyone makes a request of her
135136workload.
136137
137- - Charlie and Ian have already provided a cluster with a running service mesh.
138+ - Chihiro and Ian have already provided a cluster with a running service mesh.
138139 Ana doesn't need to make any requests of them.
139140
140141- Ana writes an HTTPRoute that defines acceptable routes and timeouts and has
@@ -147,7 +148,7 @@ workload.
147148
148149In this case, the separation of concerns across roles allows Ana to take
149150advantage of the service mesh, with custom routing logic, without any
150- bottlenecks in requests to Charlie or Ian.
151+ bottlenecks in requests to Chihiro or Ian.
151152
152153[ east/west ] :/concepts/glossary#eastwest-traffic
153154[ GAMMA ] :/concepts/gamma/
@@ -165,7 +166,7 @@ This is effectively a combination of the [multiple applications behind a
165166single Gateway] ( #multiple-applications-behind-a-single-gateway ) and [ basic
166167east/west] ( #basic-eastwest-use-case ) use cases:
167168
168- - Charlie and Ian will provision a cluster, a [ GatewayClass] , and a [ Gateway] .
169+ - Chihiro and Ian will provision a cluster, a [ GatewayClass] , and a [ Gateway] .
169170
170171- Ana and Allison will deploy their applications in the appropriate
171172 Namespaces.
@@ -175,7 +176,7 @@ east/west](#basic-eastwest-use-case) use cases:
175176There are two very important changes in this scenario, though, since a mesh is
176177involved:
177178
178- 1 . If Charlie has deployed a [ gateway controller] that defaults to [ Service
179+ 1 . If Chihiro has deployed a [ gateway controller] that defaults to [ Service
179180 routing] , they will probably need to reconfigure it for [ endpoint routing] .
180181 (This is an ongoing area of work for [ GAMMA] , but the expectation is that
181182 endpoint routing will be recommended.)
@@ -186,7 +187,7 @@ involved:
186187 HTTPRoutes that bind to both the Gateway and a Service.
187188
188189As always, the ultimate point of separating concerns in this way is that it
189- permits Charlie to enforce centralized policies [ such as
190+ permits Chihiro to enforce centralized policies [ such as
190191TLS] ( /guides/tls#downstream-tls ) at the Gateway, while allowing Ana and
191192Allison to retain independent control of [ routing
192193logic] ( /guides/http-routing ) , [ traffic splitting
0 commit comments