Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
86 changes: 84 additions & 2 deletions reference/fleet/running-on-eks-managed-by-fleet.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,92 @@ mapped_pages:
- https://www.elastic.co/guide/en/fleet/current/running-on-eks-managed-by-fleet.html
---

# Run Elastic Agent on Amazon EKS managed by Fleet [running-on-eks-managed-by-fleet]
# Configure Elastic Agent Add-On on Amazon EKS[configure-elastic-agent-on-eks]

Please follow the steps to run the {{agent}} on [Run {{agent}} on Kubernetes managed by {{fleet}}](/reference/fleet/running-on-kubernetes-managed-by-fleet.md) page.
Amazon EKS (Elastic Kubernetes Service) is a managed service that allows you to use Kubernetes on AWS without installing and operating your Kubernetes infrastructure.

Follow these steps to configure the Elastic Agent Add-On on Amazon EKS.

## What you need [_what_you_need]

* An existing Amazon EKS cluster. To deploy one, see [Create an Amazon EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).
* {{es}} for storing and searching your data, and {{kib}} for visualizing and managing it.

::::{tab-set}

:::{tab-item} {{ech}}

To get started quickly, spin up an [{{ech}}](https://www.elastic.co/cloud/elasticsearch-service) deployment. {{ech}} is available on AWS, GCP, and Azure. [Try it out for free](https://cloud.elastic.co/registration?page=docs&placement=docs-body).
:::

:::{tab-item} Self-managed

To install and run {{es}} and {{kib}}, see [Installing the {{stack}}](/deploy-manage/deploy/self-managed/installing-elasticsearch.md).
:::

::::

### Step 1: Create the Node group

You can create a managed node group with either of the following:

* [eksctl](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html#eksctl_create_managed_nodegroup)
* [AWS Management Console](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html#console_create_managed_nodegroup)

### Step 2: Select the Elastic Agent Add-On

To see all available add-ons, check the [AWS Add-ons](https://docs.aws.amazon.com/eks/latest/userguide/workloads-add-ons-available-eks.html). You can also view the most current list of available add-ons using `eksctl`, the AWS Management Console, or the AWS CLI.

### Step 3: Configure Elastic Agent Add-On

1. Choose the version of Elastic Agent desired.
2. Get the URL and enrollment token from the cluster the Elastic Agent needs to register to.
3. From the Elastic Agent EKS add-on, go to **Configuration values** to enter the relevant URL and token values from your cluster.

```
agent:
fleet:
enabled: true
url: <insert url from onboarding>
token: <insert enrollment token from onboarding>
```
Make sure the configuration override is selected in case there are conflicts.

### Step 4: Review and create

Review the data and add the Elastic Agent EKS add-on to your cluster.

Once created, you can see the Elastic Agent Add-on is **Active** on the AWS EKS console.
Elastic Agent runs as a daemonset, so it is present on each node.

### Step 5: View your data in {{kib}} [_step_6_view_your_data_in_kib]

When the Elastic Agent is Active, it appears in Fleet and its configuration is downloaded.

1. Launch {{kib}}:

::::{tab-set}

:::{tab-item} {{ech}}

1. [Log in](https://cloud.elastic.co/) to your {{ecloud}} account.
2. Navigate to the {{kib}} endpoint in your deployment.
:::

:::{tab-item} Self-managed

Point your browser to [http://localhost:5601](http://localhost:5601), replacing `localhost` with the name of the {{kib}} host.

:::

::::

2. To check if your {{agent}} is enrolled in {{fleet}}, go to **Management → {{fleet}} → Agents**.

:::{image} images/elastic-agent-fleet.png
:alt: {{agent}}s {{fleet}} page
:screenshot:
:::

## Important notes: [_important_notes_3]

Expand Down
Loading