Clusters / Template

AWS EKS Cluster

Deploy a managed Kubernetes cluster on AWS EKS

Overview

AWS account with appropriate permissions. You must run the `cloud connect` command first to grant the platform secure access to your AWS account.

Category
Clusters
Source
clusters/aws/eks/new-vpc.yaml

Prerequisites & dependencies

  • Your AWS account ID is required. Get it with `aws sts get-caller-identity --query Account --output text`
  • You must run the cloud connect command first: `astroctl cloud aws connect --account-id <account-id> --cluster-name <cluster-name> --region <region>`

No dependencies are listed in the available catalog metadata. This is not a guarantee that none are required.

Source manifest

clusters/aws/eks/new-vpc.yaml

# EKS cluster in a new VPC
#
# AstroPulse creates the VPC, the EKS control plane and one managed node group.
#
# Before you apply:
#   1. Find your AWS account ID:
#        aws sts get-caller-identity --query Account --output text
#   2. Connect the account (once per account and region):
#        astroctl cloud aws connect --account-id <YOUR_AWS_ACCOUNT_ID> --cluster-name <YOUR_CLUSTER_NAME> --region <YOUR_REGION>
#
# Apply: astroctl infra k8s apply -f new-vpc.yaml --dry-run, then without --dry-run
# Docs:  https://astropulse.io/docs/latest/platform/cluster-pipeline/features/provisioner/managed/eks
apiVersion: platform.astropulse.io/v1
kind: K8sCluster
spec:
  clusterName: <YOUR_CLUSTER_NAME>
  provider: aws
  region: <YOUR_REGION>                # the region you connected, such as us-east-1
  provisioner:
    type: eks
    eks:
      accountId: "<YOUR_AWS_ACCOUNT_ID>"
      credentials:
        type: Dynamic
  clusterSpec:
    dataPlane:
      nodeGroups:
        - name: default-pool
          minNode: 1
          maxNode: 3
          instanceType: OnDemand       # OnDemand or Spot
          machineTypes:
            - t3.medium
          labels:
            environment: dev

Deployment guidance

Go straight to Console to create clusters, deploy applications, and manage supported resources. Templates and CLI commands are optional; not every GitHub manifest has an automatic import path.

Console — start directly

Open Console to create or connect infrastructure and deploy applications without running astroctl or copying this YAML first. This template may still require manual setup.

Open Console

astroctl

Get your AWS account ID

aws sts get-caller-identity --query Account --output text

Connect your AWS account

astroctl cloud aws connect --account-id <account-id> --cluster-name <YOUR_CLUSTER_NAME> --region us-east-1

Deploy the AWS EKS cluster

astroctl infra k8s apply -f clusters/aws/eks/new-vpc.yaml

Stream cluster creation progress

astroctl infra k8s progress stream <YOUR_CLUSTER_NAME>

Check cluster status

astroctl infra k8s get <YOUR_CLUSTER_NAME>

Generate kubeconfig for kubectl

astroctl infra k8s set-context <YOUR_CLUSTER_NAME>

Delete the AWS EKS cluster

astroctl infra k8s delete <YOUR_CLUSTER_NAME>

Review placeholders and permissions before running commands. Nothing executes from this page.

Get Started

Nova

Prefer to describe the goal? Ask Nova to review this example and help plan supported actions. Access, policy, and approvals still apply.