Terraform部署Amazon Linux 2023：user_data脚本安装Kubectl失败排查

核心问题分析 #

你的脚本手动执行正常但user_data中失效，主要源于user_data执行环境与手动登录环境的差异，以及脚本本身的逻辑冗余：

• 执行身份差异：user_data默认以root身份运行，脚本中修改的是root的~/.bashrc，但后续登录实例用的是默认ec2-user，PATH配置对普通用户无效。
• 冗余的PATH配置：你已经将kubectl安装到/usr/local/bin（该路径默认在所有用户的PATH中），再复制到$HOME/bin并添加PATH属于重复操作，反而可能引发路径优先级问题。
• 缺少错误校验：脚本未对curl下载、文件校验步骤做错误检查，下载失败时会静默继续执行，导致后续步骤出错。
• 网络/依赖缺失：Amazon Linux 2023默认已预装curl，但如果实例处于受限网络环境，curl可能无法访问k8s镜像站，需确保实例有公网权限或配置VPC端点。

修正后的user_data脚本 #

以下脚本适配Amazon Linux 2023的user_data执行环境，确保kubectl全局可用，且重启后正常：

#!/bin/bash
set -euo pipefail  # 开启严格模式，出错即终止

echo "Installing Kubernetes kubectl ..."

# 下载稳定版kubectl及校验文件
KUBECTL_VERSION=$(curl -L -s https://dl.k8s.io/release/stable.txt)
curl -LO --retry 3 "https://dl.k8s.io/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl"
curl -LO --retry 3 "https://dl.k8s.io/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl.sha256"

# 校验文件完整性
echo "$(cat kubectl.sha256) kubectl" | sha256sum --check

# 安装到全局路径（所有用户可访问）
chmod +x kubectl
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

# 验证安装
kubectl version --client --short

# 清理临时文件
rm -f kubectl kubectl.sha256

额外说明 #

1. 同时安装Helm的扩展脚本：若需一并安装Helm，可在上述脚本后添加以下内容：

echo "Installing Helm ..."
curl -fsSL --retry 3 https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version --short

2. 无需修改.bashrc的原因：/usr/local/bin是Amazon Linux 2023所有用户的默认PATH路径，安装到该目录后，任何用户登录后都可直接使用kubectl，无需额外配置PATH。
3. 日志排查方法：若脚本仍失败，可查看user_data执行日志定位问题：cat /var/log/cloud-init-output.log，该日志会记录脚本执行的所有输出与错误信息。

内容的提问来源于stack exchange，提问作者David Sagang