Skip to content

Commit 5ffc9ac

Browse files
committed
docs: add AWS EKS troubleshooting guidance for permission errors
1 parent ad61192 commit 5ffc9ac

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/faqs.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,32 @@ roleRef:
5757
5858
The `USER_ACCOUNT` above should be your Google Cloud user email.
5959

60+
**For AWS EKS users:**
61+
62+
If you encounter a similar issue on AWS EKS, with an error message like:
63+
```
64+
Error from server (Forbidden): error when creating "test.yaml": admission webhook "vauth.kb.io" denied the request: arn:aws:iam::xxxxxx:user/xxxx is forbidden on namespace xxxxxx
65+
```
66+
You can create a `ClusterRoleBinding` to grant the necessary permissions to your IAM user or role. Ensure that you have a `ClusterRole` named `chaos-mesh-admin` with the required permissions, or adjust the `roleRef.name` accordingly.
67+
68+
```yaml
69+
apiVersion: rbac.authorization.k8s.io/v1
70+
kind: ClusterRoleBinding
71+
metadata:
72+
name: chaos-mesh-admin-binding
73+
subjects:
74+
- kind: User
75+
name: arn:aws:iam::<AWS_ACCOUNT_ID>:user/<USERNAME> # Replace with your IAM user ARN
76+
# For IAM Roles (e.g., EC2 instance roles):
77+
# name: arn:aws:iam::<AWS_ACCOUNT_ID>:role/<ROLE_NAME>
78+
apiGroup: rbac.authorization.k8s.io
79+
roleRef:
80+
kind: ClusterRole
81+
name: chaos-mesh-admin # Ensure this ClusterRole exists and has appropriate permissions
82+
apiGroup: rbac.authorization.k8s.io
83+
```
84+
Replace `<AWS_ACCOUNT_ID>` and `<USERNAME>` (or `<ROLE_NAME>`) with your specific AWS account ID and IAM user name (or role name).
85+
6086
### Daemon throws an error similar to `version 1.41 is too new. The maximum supported API version is 1.39`
6187

6288
This indicates that the maximum API version that the Docker daemon can accept is `1.39`, but the client in `chaos-daemon` uses `1.41` by default. You can choose the following options to solve this problem:

0 commit comments

Comments
 (0)