Skip to content

Commit

Permalink
[AWS] Version updates - inclusion of 24.04 and eksctl version.
Browse files Browse the repository at this point in the history
Also aligned config.yaml file with AWS official documentation and other fixes (i.e. no
BootstrapOverride is needed)
  • Loading branch information
carlosbravoa authored Jan 24, 2025
1 parent fb85e4e commit b1e6f65
Showing 1 changed file with 31 additions and 15 deletions.
46 changes: 31 additions & 15 deletions aws/aws-how-to/kubernetes/deploy-ubuntu-cluster-with-eks-ami.rst
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
Deploy an Ubuntu EKS cluster
============================

This guide shows how to deploy an Ubuntu EKS cluster using an EKS AMI.
This guide shows how to deploy an Ubuntu EKS cluster using an official EKS AMI.

Prerequisites
-------------

You need:

- ``eksctl`` (version 0.190 or newer): Check the instructions to `install eksctl`_
- ``eksctl`` (version v0.201.0 or newer): Check the instructions to `install eksctl`_
- ``kubectl``: Check the instructions to `install kubectl`_


Expand All @@ -19,21 +19,37 @@ Create a ``config.yaml`` with the following content:

.. code-block:: yaml
---
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig
metadata:
name: your-cluster
region: us-east-1
name: my-cluster
region: region-code
version: '1.31'
iam:
withOIDC: true
nodeGroups:
- name: ng-cluster
instanceType: m5.large
amiFamily: Ubuntu2204
ami: ami-ubuntu
overrideBootstrapCommand: |
#!/bin/bash
/etc/eks/bootstrap.sh your-cluster
To use an Ubuntu specific AMI, set ``amiFamily`` to ``Ubuntu2004`` (for EKS version <= 1.29) or to ``Ubuntu2204`` (for EKS version >= 1.29). For Ubuntu nodes, the ``overrideBootstrapCommand`` is required for both managed and self-managed groups.
- name: ng-ubuntu
instanceType: m5.large
desiredCapacity: 3
amiFamily: Ubuntu2404
iam:
attachPolicyARNs:
- {arn-aws}iam::aws:policy/AmazonEKSWorkerNodePolicy
- {arn-aws}iam::aws:policy/AmazonEC2ContainerRegistryReadOnly
- {arn-aws}iam::aws:policy/AmazonSSMManagedInstanceCore
- {arn-aws}iam::aws:policy/AmazonEKS_CNI_Policy
ssh:
allow: true
publicKeyName: my-ec2-keypair-name
To use an Ubuntu specific AMI, set ``amiFamily`` to one of these choices:
- ``Ubuntu2004`` for EKS version <= 1.29
- ``Ubuntu2204`` for EKS version >= 1.29
- ``Ubuntu2404`` for EKS version >= 1.31

For further cluster customization, check out the `config file schema for eksctl`_

Expand All @@ -56,8 +72,8 @@ You can confirm the status of the nodes on your cluster using:
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
ip-xxx-xxx-xx-xxx.us-east-1.compute.internal Ready <none> 2m45s v1.30.x
ip-xxx-xxx-x-xx.us-east-1.compute.internal Ready <none> 2m45s v1.30.x
ip-xxx-xxx-xx-xxx.us-east-1.compute.internal Ready <none> 2m45s v1.31.x
ip-xxx-xxx-x-xx.us-east-1.compute.internal Ready <none> 2m45s v1.31.x
.. _`install eksctl`: https://eksctl.io/installation/
Expand Down

0 comments on commit b1e6f65

Please sign in to comment.