---
title: "eks-minimal"
description: "A minimal example of using pulumi-eks"
url: "https://www.pulumi.com/dev/examples/aws-java-eks-minimal/"
image: "https://www.pulumi.com/assets/og/dev/examples/aws-java-eks-minimal.png"
---

# eks-minimal

A minimal example of using pulumi-eks

- Source on GitHub: https://github.com/pulumi/examples/tree/master/aws-java-eks-minimal

## Get started with this example

This example lives in the [pulumi/examples](https://github.com/pulumi/examples/tree/master/aws-java-eks-minimal) repo. Pull down just this directory to follow along:

```bash
git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
git -C pulumi-examples sparse-checkout set aws-java-eks-minimal
cd pulumi-examples/aws-java-eks-minimal
```

This example demonstrates consuming
[Pulumi AWS EKS Components](https://github.com/pulumi/pulumi-eks)
from Java.

The high-level Cluster component automatically provisions roles,
security groups and other necessary resources with good defaults,
making it easy to get started. For more information, checkout the
relevant
[Pulumi blog](https://www.pulumi.com/blog/easily-create-and-manage-aws-eks-kubernetes-clusters-with-pulumi)


## Running the example

1. Start a new stack:

    ```bash
    pulumi stack init dev
    ```

1. Configure your AWS region, for example:

    ```bash
    pulumi config set aws:region us-east-1
    ```

1. Deploy the example. Note it will take up to 10 minutes to provision
   the EKS cluster:

    ```bash
    pulumi up
    ```

1. Access the Kubernetes Cluster using `kubectl`.

   To access your new Kubernetes cluster using `kubectl`, we need to
   setup the `kubeconfig` file and download `kubectl`. We can leverage
   the Pulumi stack output in the CLI, as Pulumi facilitates exporting
   these objects for us.

    ```bash
    $ pulumi stack output kubeconfig --show-secrets > kubeconfig
    $ export KUBECONFIG=$PWD/kubeconfig
    $ kubectl version
    $ kubectl cluster-info
    $ kubectl get nodes
    ```