Skip to content

Commit d729b6b

Browse files
committed
Charlie is now Chihiro.
Signed-off-by: [email protected]
1 parent 2eb2361 commit d729b6b

File tree

5 files changed

+32
-31
lines changed

5 files changed

+32
-31
lines changed

site-src/concepts/api-overview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ This document provides an overview of Gateway API.
77
There are 3 primary roles in Gateway API, as described in [roles and personas]:
88

99
- **Ian** (he/him): Infrastructure Provider
10-
- **Charlie** (they/them): Cluster Operator
10+
- **Chihiro** (they/them): Cluster Operator
1111
- **Ana** (she/her): Application Developer
1212

1313
[roles and personas]:/concepts/roles-and-personas
@@ -176,7 +176,7 @@ different relationships that Gateways and Routes can have:
176176

177177
### Example
178178

179-
[Charlie] has deployed a Gateway `shared-gw` in the `infra` Namespace to be
179+
[Chihiro] has deployed a Gateway `shared-gw` in the `infra` Namespace to be
180180
used by different application teams for exposing their applications outside
181181
the cluster. Teams A and B (in Namespaces `A` and `B` respectively) attach
182182
their Routes to this Gateway. They are unaware of each other and as long as
@@ -190,7 +190,7 @@ Namespace.
190190
<!-- source: https://docs.google.com/presentation/d/1neBkFDTZ__vRoDXIWvAcxk2Pb7-evdBT6ykw_frf9QQ/edit?usp=sharing -->
191191
![route binding](/images/gateway-route-binding.png)
192192

193-
[Charlie]:/concepts/roles-and-personas#charlie
193+
[Chihiro]:/concepts/roles-and-personas#Chihiro
194194

195195
### How it Works
196196

site-src/concepts/roles-and-personas.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ The Gateway API defines three roles and personas:
3737
will often work for a cloud provider (AWS, Azure, GCP, ...) or for a PaaS
3838
provider.
3939

40-
* **Charlie**<a name="charlie"></a> (they/them) is a _cluster operator_,
40+
* **Chihiro**<a name="Chihiro"></a> (they/them) is a _cluster operator_,
4141
responsible for managing clusters to ensure that they meet the needs of
42-
their several users. Charlie will typically be concerned with policies,
42+
their several users. Chihiro will typically be concerned with policies,
4343
network access, application permissions, etc. Again, they are beholden to no
4444
single user of any cluster; rather, they need to make sure that the clusters
4545
serve all users as needed.
@@ -60,7 +60,7 @@ Depending on the environment, multiple roles can map to the same user:
6060
and may actually happen in a small startup running Kubernetes on bare metal.
6161

6262
- A more typical small startup would use clusters from a cloud provider. In
63-
this situation, Ana and Charlie may be embodied in the same person, with Ian
63+
this situation, Ana and Chihiro may be embodied in the same person, with Ian
6464
being an employee (or automated process!) within the cloud provider.
6565

6666
- In a much larger organization, we would expect each persona above to be

site-src/concepts/security-model.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Gateway API has 3 primary API resources:
1818
There are 3 primary roles in Gateway API, as described in [roles and personas]:
1919

2020
- **Ian** (he/him): Infrastructure Provider
21-
- **Charlie** (they/them): Cluster Operator
21+
- **Chihiro** (they/them): Cluster Operator
2222
- **Ana** (she/her): Application Developer
2323

2424
[roles and personas]:/concepts/roles-and-personas

site-src/concepts/use-cases.md

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,15 @@ examples that can be helpful to demonstrate how the API can be used.
77

88
In all cases, it's very important to bear in mind the [roles and personas]
99
used 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
3940
while Ana has created the application, setting up the cluster is not in her
4041
wheelhouse.
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

4849
3. 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

7273
9. Ana writes and applies [HTTPRoute] resources to configure which URL paths
@@ -77,7 +78,7 @@ wheelhouse.
7778
10. 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
8182
TLS](/guides/tls#downstream-tls) at the Gateway, while simultaneously allowing
8283
Ana and her colleagues control over the application's [routing
8384
logic](/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`
9899
Namespace, while Allison and her team are managing a website in the `site`
99100
Namespace.
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
108109
policies [such as TLS](/guides/tls#downstream-tls) can be enforced at the
109110
Gateway. Meanwhile, Ana and Allison run their applications [in their own
110111
Namespaces](/guides/multiple-ns), but attach their Routes to the same shared
111112
Gateway, allowing them to independently control their [routing
112113
logic](/guides/http-routing), [traffic splitting
113114
rollout](/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
134135
URL paths, and by enforcing timeouts whenever anyone makes a request of her
135136
workload.
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

148149
In this case, the separation of concerns across roles allows Ana to take
149150
advantage 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
165166
single Gateway](#multiple-applications-behind-a-single-gateway) and [basic
166167
east/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:
175176
There are two very important changes in this scenario, though, since a mesh is
176177
involved:
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

188189
As 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
190191
TLS](/guides/tls#downstream-tls) at the Gateway, while allowing Ana and
191192
Allison to retain independent control of [routing
192193
logic](/guides/http-routing), [traffic splitting

site-src/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -151,9 +151,9 @@ The roles used for the Gateway API's design are defined by three personas:
151151
to serve multiple tenants. He is not beholden to any single tenant; rather,
152152
he worries about all of them collectively.
153153

154-
- **Charlie** (they/them) is a _cluster operator_. Their role is to manage a
154+
- **Chihiro** (they/them) is a _cluster operator_. Their role is to manage a
155155
single cluster, ensuring that it meets the needs of its several users.
156-
Again, Charlie is beholden to no single user of their cluster; they need to
156+
Again, Chihiro is beholden to no single user of their cluster; they need to
157157
make sure that the cluster serves all of them as needed.
158158

159159
- **Ana** (she/her) is an _application developer_. Ana is in a unique position
@@ -165,7 +165,7 @@ The roles used for the Gateway API's design are defined by three personas:
165165
(These three are discussed in more detail in [Roles and
166166
Personas](/concepts/roles-and-personas).)
167167

168-
It should be clear that while Ana, Charlie, and Ian do not necessarily see
168+
It should be clear that while Ana, Chihiro, and Ian do not necessarily see
169169
eye-to-eye about everything, they need to work together to keep things running
170170
smoothly. This is the core challenge of the Gateway API in a nutshell.
171171

@@ -177,7 +177,7 @@ and implementations while remaining a portable and standard API.
177177

178178
The use cases presented are deliberately cast in terms of the roles presented
179179
above. Ultimately the Gateway API is meant for use by humans, which means that
180-
it must fit the uses to which each of Ana, Charlie, and Ian will put it.
180+
it must fit the uses to which each of Ana, Chihiro, and Ian will put it.
181181

182182
[use-cases]:/concepts/use-cases
183183

0 commit comments

Comments
 (0)