Skip to content

Commit b387275

Browse files
a-hilalya-hilaly
authored
Merge pull request #2 from a-hilaly/eks-cap
2 parents e09f029 + 12ee947 commit b387275

File tree

5 files changed

+123
-14
lines changed

5 files changed

+123
-14
lines changed

‎website/docs/getting-started-eks.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
sidebar_position: 1
3+
title: EKS Capabilities (Managed)
4+
sidebar_label: Using EKS Capabilities
5+
---
6+
7+
# EKS Capabilities (Managed)
8+
9+
ACK is available as a fully managed EKS Capability. AWS handles controller installation, updates, and scaling for you - no Helm or manual installation required.
10+
11+
## Why Use EKS Capabilities?
12+
13+
- **Fully managed** - AWS handles controller lifecycle, updates, and scaling
14+
- **No Helm required** - Enable ACK directly through AWS CLI or eksctl
15+
- **Integrated with EKS** - Works seamlessly with other EKS capabilities like Argo CD and kro
16+
17+
## Getting Started
18+
19+
Follow the official AWS documentation to enable ACK on your EKS cluster:
20+
21+
<div className="row" style={{marginTop: '1.5rem', marginBottom: '1.5rem'}}>
22+
<div className="col col--4">
23+
<div className="card" style={{height: '100%'}}>
24+
<div className="card__header">
25+
<h3>Console</h3>
26+
</div>
27+
<div className="card__body">
28+
<p>Enable ACK from the EKS console with a few clicks.</p>
29+
<a href="https://docs.aws.amazon.com/eks/latest/userguide/ack-create-console.html" target="_blank" rel="noopener noreferrer" className="button button--primary button--block">View Console Guide →</a>
30+
</div>
31+
</div>
32+
</div>
33+
<div className="col col--4">
34+
<div className="card" style={{height: '100%'}}>
35+
<div className="card__header">
36+
<h3>AWS CLI</h3>
37+
</div>
38+
<div className="card__body">
39+
<p>Create an ACK capability using the AWS CLI.</p>
40+
<a href="https://docs.aws.amazon.com/eks/latest/userguide/ack-create-cli.html" target="_blank" rel="noopener noreferrer" className="button button--primary button--block">View AWS CLI Guide →</a>
41+
</div>
42+
</div>
43+
</div>
44+
<div className="col col--4">
45+
<div className="card" style={{height: '100%'}}>
46+
<div className="card__header">
47+
<h3>eksctl</h3>
48+
</div>
49+
<div className="card__body">
50+
<p>Create an ACK capability using eksctl.</p>
51+
<a href="https://docs.aws.amazon.com/eks/latest/userguide/ack-create-eksctl.html" target="_blank" rel="noopener noreferrer" className="button button--primary button--block">View eksctl Guide →</a>
52+
</div>
53+
</div>
54+
</div>
55+
</div>
56+
57+
For a complete overview of ACK as an EKS Capability, see the [AWS documentation](https://docs.aws.amazon.com/eks/latest/userguide/ack.html).
58+
59+
## After Installation
60+
61+
Once your ACK capability is active, you can start creating AWS resources using Kubernetes manifests. Check out these guides:
62+
63+
- [Create an ACK Resource](/docs/guides/create-resource) - Create your first AWS resource
64+
- [Core Concepts](/docs/concepts) - Understand how ACK works
65+
- [Available Controllers](/services) - Browse 50+ supported AWS services

‎website/docs/getting-started.md‎

Lines changed: 47 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,33 +5,71 @@ title: Getting Started
55

66
# Getting Started
77

8-
Get started with ACK by installing a controller using Helm. ACK works on any Kubernetes cluster including Amazon EKS, GKE, AKS, on-premises clusters, or local development environments.
8+
There are two ways to get started with ACK, depending on whether you're using Amazon EKS or running your own Kubernetes cluster.
9+
10+
## Choose Your Installation Method
911

1012
<div className="row" style={{marginTop: '2rem', marginBottom: '2rem'}}>
11-
<div className="col col--8 col--offset-2">
13+
<div className="col col--6">
14+
<div className="card" style={{border: '1px solid var(--ifm-color-emphasis-300)', boxShadow: '0 2px 8px rgba(0,0,0,0.1)', borderRadius: '12px'}}>
15+
<div className="card__header" style={{display: 'flex', alignItems: 'center', gap: '12px'}}>
16+
<img src="/docs/img/eks.png" alt="EKS" style={{width: '32px', height: '32px'}} />
17+
<h3 style={{margin: 0}}>EKS Capabilities (Managed)</h3>
18+
</div>
19+
<div className="card__body">
20+
<p><strong>Recommended for Amazon EKS users</strong></p>
21+
<p>Enable ACK controllers with one click in the EKS console. AWS manages the controller installation and upgrades for you.</p>
22+
<ul>
23+
<li>Fastest setup - no Helm or CLI required</li>
24+
<li>Automatic controller updates</li>
25+
<li>Access to all controllers - use what you need</li>
26+
<li>Auto-scaling and auto-tuning included</li>
27+
</ul>
28+
<a href="/docs/getting-started-eks" className="button button--primary button--block">Get Started with EKS Capabilities</a>
29+
</div>
30+
</div>
31+
</div>
32+
<div className="col col--6">
1233
<div className="card" style={{border: '1px solid var(--ifm-color-emphasis-300)', boxShadow: '0 2px 8px rgba(0,0,0,0.1)', borderRadius: '12px'}}>
1334
<div className="card__header" style={{display: 'flex', alignItems: 'center', gap: '12px'}}>
1435
<img src="/docs/img/helm-logo.svg" alt="Helm" style={{width: '32px', height: '32px'}} />
15-
<h3 style={{margin: 0}}>Install with Helm</h3>
36+
<h3 style={{margin: 0}}>Self-Managed Installation</h3>
1637
</div>
1738
<div className="card__body">
18-
<p>Install ACK controllers using Helm charts. This gives you full control over versions and configuration.</p>
39+
<p><strong>For any Kubernetes cluster</strong></p>
40+
<p>Install ACK controllers yourself using Helm. Works on EKS, GKE, AKS, on-premises clusters, or local development environments.</p>
1941
<ul>
42+
<li>Full control over versions and configuration</li>
2043
<li>Works on any Kubernetes 1.20+</li>
2144
<li>Access to all 50+ controllers</li>
22-
<li>Full control over versions and configuration</li>
2345
<li>Customize controller settings</li>
2446
</ul>
25-
<a href="/docs/docs/getting-started-helm" className="button button--primary button--block">Get Started with Helm</a>
47+
<a href="/docs/getting-started-helm" className="button button--primary button--block">Get Started with Helm</a>
2648
</div>
2749
</div>
2850
</div>
2951
</div>
3052

53+
## Which Method Should I Use?
54+
55+
**Use EKS Capabilities if:**
56+
57+
- You're running Amazon EKS
58+
- You want AWS to manage controller lifecycle
59+
- You want auto-scaling and auto-tuning capabilities
60+
- You prefer a managed experience
61+
62+
**Use Self-Managed Installation if:**
63+
64+
- You're running on GKE, AKS, or on-premises Kubernetes
65+
- You want full control over versions and configuration
66+
- You need to customize controller settings
67+
- You're developing or testing ACK controllers
68+
3169
## What's Next?
3270

33-
After installing your first controller, you can:
71+
After installing your first controller using either method, you can:
3472

35-
- **Explore Features**: Learn about [resource adoption](/guides/adoption), [cross-account management](/guides/cross-account), and [deletion policies](/guides/deletion-policy)
73+
- **Explore Features**: Learn about [resource adoption](/docs/guides/adoption), [cross-account management](/docs/guides/cross-account), and [deletion policies](/docs/guides/deletion-policy)
3674
- **Browse Controllers**: Check out the [full list of available controllers](/services)
37-
- **Understand Concepts**: Read about [CRDs, reconciliation, and architecture](/concepts)
75+
- **Understand Concepts**: Read about [CRDs, reconciliation, and architecture](/docs/concepts)

‎website/docs/installation.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ title: Installation
77

88
Detailed installation guide coming soon...
99

10-
For now, see the installation instructions in the [Self-Managed Installation](/getting-started-helm#step-1-install-the-dynamodb-controller) guide.
10+
For now, see the installation instructions in the [Self-Managed Installation](/docs/getting-started-helm#step-1-install-the-dynamodb-controller) guide or the [EKS Capabilities](/docs/getting-started-eks) guide.

‎website/docusaurus.config.ts‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,12 +73,12 @@ const config: Config = {
7373
// Social card for link previews (Twitter, Slack, etc.)
7474
image: "img/ack-social.png",
7575
announcementBar: {
76-
id: "under_development",
76+
id: "eks_capabilities_launch",
7777
content:
78-
'<div style="min-height: 60px !important; height: 60px !important; display: flex !important; align-items: center !important; justify-content: center !important; padding: 16px 20px !important; font-size: 16px; line-height: 1.6; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; text-rendering: optimizeLegibility; letter-spacing: 0.4px; font-family: -apple-system, BlinkMacSystemFont, \'Segoe UI\', Roboto, Oxygen, Ubuntu, sans-serif;">🚧 <strong style="font-weight: 600;">Under Development:</strong> This site will soon replace the <a target="_blank" rel="noopener noreferrer" href="https://aws-controllers-k8s.github.io/community" style="text-decoration: underline; font-weight: 600; margin-left: 8px; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;">legacy documentation →</a></div>',
78+
'<div style="min-height: 60px !important; height: 60px !important; display: flex !important; align-items: center !important; justify-content: center !important; padding: 16px 20px !important; font-size: 16px; line-height: 1.6; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; text-rendering: optimizeLegibility; letter-spacing: 0.4px; font-family: -apple-system, BlinkMacSystemFont, \'Segoe UI\', Roboto, Oxygen, Ubuntu, sans-serif;">✨ <strong style="font-weight: 600;">Exciting News:</strong> ACK is now available as an EKS Capability <a target="_blank" rel="noopener noreferrer" href="https://aws.amazon.com/eks/" style="text-decoration: underline; font-weight: 600; margin-left: 8px; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;">Learn more →</a></div>',
7979
backgroundColor: "#0D9488",
80-
textColor: "#ffffff",
81-
isCloseable: false,
80+
textColor: "#FFFFFF",
81+
isCloseable: true,
8282
},
8383
colorMode: {
8484
respectPrefersColorScheme: false,

‎website/sidebars.ts‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,12 @@ const sidebars: SidebarsConfig = {
2525
label: 'Installation',
2626
collapsed: false,
2727
items: [
28+
{
29+
type: 'doc',
30+
id: 'getting-started-eks',
31+
label: 'Using EKS Capabilities',
32+
className: 'sidebar-item-new',
33+
},
2834
{
2935
type: 'doc',
3036
id: 'getting-started-helm',

0 commit comments

Comments
 (0)