Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AL2023 UserData Available Documentation #7749

Open
AbeOwlu opened this issue May 6, 2024 · 2 comments
Open

AL2023 UserData Available Documentation #7749

AbeOwlu opened this issue May 6, 2024 · 2 comments
Labels
kind/help Request for help

Comments

@AbeOwlu
Copy link

AbeOwlu commented May 6, 2024

What help do you need?

There isnt a clear wording in documentation that: "users NEED to create a launch template if custom userData (script) is required for Amazon Linux 2023"

  • overrideBootstrapCommand interface is no longer available.
  • Not sure how this UserData in nodebootsrap al23 is used, but the configuration below also is not valid
managedNodeGroups:
  - name: custAMIGroup
    ami: ami-079fcd733303590b9
    amiFamily: AL23
    userData: |
      MIME-Version: 1.0 
      Content-Type: multipart/mixed; boundary="BOUNDARY"      
      
      --BOUNDARY 
      Content-Type: text/x-shellscript; charset="us-ascii"

      #!/bin/bash
      echo "exec custom script here"
      
      --BOUNDARY--

      Content-Type: application/node.eks.aws      
      --- 
      apiVersion: node.eks.aws/v1alpha1 
      kind: NodeConfig 
      spec:
        cluster:
          apiServerEndpoint:
          certificateAuthority:
          cidr:
          name:

      --BOUNDARY--
While AL2023 implements the Bootstrapper interface, the underlying userdata will be entirely different from other AMI families. Specifically, AL2023 introduces a new node initialization process nodeadm that uses a YAML configuration schema, dropping the use of /etc/eks/bootstrap.sh script. For self-managed nodes, and for EKS-managed nodes based on custom AMIs, eksctl will populate userdata in the fashion below:
...
Required custom cloud-init scripts are no longer merged into a bootstrap.sh execution, and custom launch templates need to be defined to execute custom scripts on node bootstrap.
...
@AbeOwlu AbeOwlu added the kind/help Request for help label May 6, 2024
Copy link
Contributor

github-actions bot commented May 6, 2024

Hello AbeOwlu 👋 Thank you for opening an issue in eksctl project. The team will review the issue and aim to respond within 1-5 business days. Meanwhile, please read about the Contribution and Code of Conduct guidelines here. You can find out more information about eksctl on our website

@tanvp112
Copy link

Perhaps at least preBootstrapCommands can be added to the scripts to generate the final node config? https://github.com/eksctl-io/eksctl/blob/main/pkg/nodebootstrap/al2023.go#L55

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/help Request for help
Projects
None yet
Development

No branches or pull requests

2 participants