Help improve this page
To contribute to this user guide, choose the Edit this page on GitHub link that is located in the right pane of every page.
Create an ACK capability using the Console
This topic describes how to create an AWS Controllers for Kubernetes (ACK) capability using the AWS Management Console.
Create the ACK capability
-
Open the Amazon EKS console at https://console.aws.amazon.com/eks/home#/clusters
. -
Select your cluster name to open the cluster detail page.
-
Choose the Capabilities tab.
-
In the left navigation, choose AWS Controllers for Kubernetes (ACK).
-
Choose Create AWS Controllers for Kubernetes capability.
-
For IAM Capability Role:
-
If you already have an IAM Capability Role, select it from the dropdown
-
If you need to create a role, choose Create admin role
This opens the IAM console in a new tab with pre-populated trust policy and the
AdministratorAccessmanaged policy. You can unselect this policy and add other permissions if you prefer.After creating the role, return to the EKS console and the role will be automatically selected.
Important
The suggested
AdministratorAccesspolicy grants broad permissions and is intended to streamline getting started. For production use, replace this with a custom policy that grants only the permissions needed for the specific AWS services you plan to manage with ACK. For guidance on creating least-privilege policies, see Configure ACK permissions and Security considerations for EKS Capabilities.
-
-
Choose Create.
The capability creation process begins.
Verify the capability is active
-
On the Capabilities tab, view the ACK capability status.
-
Wait for the status to change from
CREATINGtoACTIVE. -
Once active, the capability is ready to use.
For information about capability statuses and troubleshooting, see Working with capability resources.
Verify custom resources are available
After the capability is active, verify that ACK custom resources are available in your cluster.
Using the console
-
Navigate to your cluster in the Amazon EKS console
-
Choose the Resources tab
-
Choose Extensions
-
Choose CustomResourceDefinitions
You should see a number of CRDs listed for AWS resources.
Using kubectl
kubectl api-resources | grep services.k8s.aws
You should see a number of APIs listed for AWS resources.
Note
The capability for AWS Controllers for Kubernetes will install a number of CRDs for a variety of AWS resources.
Next steps
-
ACK concepts - Understand ACK concepts and get started
-
Configure ACK permissions - Configure IAM permissions for other AWS services
-
Working with capability resources - Manage your ACK capability resource