Skip to content

Commit 82e175c

Browse files
authored
Merge pull request #4496 from rochabr/eks-podidentity
Including EKS Pod Identity documentation
2 parents efcd9fb + c7fab15 commit 82e175c

File tree

2 files changed

+13
-5
lines changed

2 files changed

+13
-5
lines changed

daprdocs/content/en/developing-applications/integrations/AWS/authenticating-aws.md

+12-4
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,16 @@ In production scenarios, it is recommended to use a solution such as:
3434

3535
If running on AWS EKS, you can [link an IAM role to a Kubernetes service account](https://docs.aws.amazon.com/eks/latest/userguide/create-service-account-iam-policy-and-role.html), which your pod can use.
3636

37-
All of these solutions solve the same problem: They allow the Dapr runtime process (or sidecar) to retrive credentials dynamically, so that explicit credentials aren't needed. This provides several benefits, such as automated key rotation, and avoiding having to manage secrets.
37+
All of these solutions solve the same problem: They allow the Dapr runtime process (or sidecar) to retrieve credentials dynamically, so that explicit credentials aren't needed. This provides several benefits, such as automated key rotation, and avoiding having to manage secrets.
3838

3939
Both Kiam and Kube2IAM work by intercepting calls to the [instance metadata service](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html).
4040

41+
### Setting Up Dapr with AWS EKS Pod Identity
42+
43+
EKS Pod Identities provide the ability to manage credentials for your applications, similar to the way that Amazon EC2 instance profiles provide credentials to Amazon EC2 instances. Instead of creating and distributing your AWS credentials to the containers or using the Amazon EC2 instance’s role, you associate an IAM role with a Kubernetes service account and configure your Pods to use the service account.
44+
45+
To see a comprehensive example on how to authorize pod access to AWS Secrets Manager from EKS using AWS EKS Pod Identity, [follow the sample in this repository](https://github.com/dapr/samples/tree/master/dapr-eks-podidentity).
46+
4147
### Use an instance profile when running in stand-alone mode on AWS EC2
4248

4349
If running Dapr directly on an AWS EC2 instance in stand-alone mode, you can use instance profiles.
@@ -84,7 +90,6 @@ On Windows, the environment variable needs to be set before starting the `dapr`
8490

8591
{{< /tabs >}}
8692

87-
8893
### Authenticate to AWS if using AWS SSO based profiles
8994

9095
If you authenticate to AWS using [AWS SSO](https://aws.amazon.com/single-sign-on/), some AWS SDKs (including the Go SDK) don't yet support this natively. There are several utilities you can use to "bridge the gap" between AWS SSO-based credentials and "legacy" credentials, such as:
@@ -111,7 +116,7 @@ AWS_PROFILE=myprofile awshelper daprd...
111116
<!-- windows -->
112117
{{% codetab %}}
113118

114-
On Windows, the environment variable needs to be set before starting the `awshelper` command, doing it inline (like in Linxu/MacOS) is not supported.
119+
On Windows, the environment variable needs to be set before starting the `awshelper` command; doing it inline (like in Linux/MacOS) is not supported.
115120

116121
{{% /codetab %}}
117122

@@ -123,4 +128,7 @@ On Windows, the environment variable needs to be set before starting the `awshel
123128

124129
## Related links
125130

126-
For more information, see [how the AWS SDK (which Dapr uses) handles credentials](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials).
131+
- For more information, see [how the AWS SDK (which Dapr uses) handles credentials](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials).
132+
- [EKS Pod Identity Documentation](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html)
133+
- [AWS SDK Credentials Configuration](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials)
134+
- [Set up an Elastic Kubernetes Service (EKS) cluster](https://docs.dapr.io/operations/hosting/kubernetes/cluster/setup-eks/)

daprdocs/content/en/operations/hosting/kubernetes/cluster/setup-eks.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ This guide walks you through installing an Elastic Kubernetes Service (EKS) clus
6666
1. Create the cluster by running the following command:
6767
6868
```bash
69-
eksctl create cluster -f cluster.yaml
69+
eksctl create cluster -f cluster-config.yaml
7070
```
7171

7272
1. Verify the kubectl context:

0 commit comments

Comments
 (0)