Skip to content

Commit a56acf2

Browse files
kumahq[bot]fabianrbz
authored andcommitted
chore(deps): update docs from repo source
Signed-off-by: kumahq[bot] <110050114+kumahq[bot]@users.noreply.github.com>
1 parent 2f6fb6f commit a56acf2

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

app/assets/mesh/raw/UPGRADE.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,40 @@ Make sure to also check the upgrade notes for the matching version of [Kuma](htt
77

88
## Upgrade to `2.13.x`
99

10+
### AWS IAM workload label validation for MeshIdentity
11+
12+
Starting with Kong Mesh `2.13.x`, AWS IAM role tags are validated against dataplane metadata labels (not inbound tags). When a `MeshIdentity` uses the `kuma.io/workload` label in its SPIFFE ID path template, the IAM role must include a matching `kuma.io/workload` tag.
13+
14+
**When this applies:**
15+
16+
This validation is only enforced when a `MeshIdentity` resource exists for the mesh AND its SPIFFE ID path template references the `kuma.io/workload` label (e.g., `{{ label "kuma.io/workload" }}`).
17+
18+
**Migration steps:**
19+
20+
1. For each Mesh with a `MeshIdentity` that uses `kuma.io/workload` in its SPIFFE ID path, add the `kuma.io/workload` tag to IAM roles:
21+
```
22+
kuma.io/workload: <workload-name>
23+
```
24+
25+
2. Ensure dataplanes have matching `kuma.io/workload` in metadata labels:
26+
- **Kubernetes**: Add to Pod labels (automatically synced to dataplane metadata)
27+
- **Universal**: Add to dataplane metadata labels:
28+
```yaml
29+
type: Dataplane
30+
mesh: default
31+
name: dp-1
32+
labels:
33+
kuma.io/workload: <workload-name>
34+
networking:
35+
address: 127.0.0.1
36+
inbound:
37+
- port: 8080
38+
tags:
39+
kuma.io/service: backend
40+
```
41+
42+
**Note:** Meshes without `MeshIdentity` resources or MeshIdentities that don't use `kuma.io/workload` in their SPIFFE ID path are not affected.
43+
1044
### OPA using `dynamicconfig` instead of xDS server
1145

1246
Starting with Kong Mesh `2.13.x`, the Open Policy Agent (OPA) integration uses the same mechanism for dynamic configuration as DNS and MeshMetrics.

0 commit comments

Comments
 (0)