Adding EKS Cluster Auth Example

examples/aws-provider/README.md

@@ -41,6 +41,35 @@ kubectl apply -f managed-resources/vpc.yaml
 kubectl get VPC aws-provider-vpc
 ```
 
+## Authenticate with an existing EKS Cluster using AWS Provider
+
+The following shows an example of how to authenticate and retrieve `kubeconfig` from an existing remote EKS Cluster using AWS Provider
+
+```shell
+kubectl apply -f managed-resources/eks-clusterauth.yaml
+
+# Verify the resource. When authentication is complete, you should see READY: True in the output
+kubectl get clusterauths.eks.aws.upbound.io
+NAME                               READY   SYNCED   EXTERNAL-NAME                      AGE
+eks-x86-us-east-2-1-28-blueprint   True    True     eks-x86-us-east-2-1-28-blueprint   11d
+
+# Verify if the secret has pulled the `kubeconfig` of a remote cluster to management cluster.
+
+kubectl describe secret eks-x86-us-east-2-1-28-eks-connection -n upbound-system
+Name:         eks-x86-us-east-2-1-28-eks-connection
+Namespace:    upbound-system
+Labels:       <none>
+Annotations:  <none>
+
+Type:  connection.crossplane.io/v1alpha1
+
+Data
+====
+clusterCA:   1107 bytes
+endpoint:    72 bytes
+kubeconfig:  4314 bytes
+```
+
 ## Crossplane Kubernetes Provider
 
 The following example shows the creation of Namespace with Crossplane Kuberentes provider