An error occurred (InvalidUserData.Malformed) when calling the CreateLaunchTemplate operation: Invalid BASE64 encoding of user data.
În launch template, UserData trebuie dat codificat base64, nu ca text. Codifică scriptul cu base64 -w0 web.sh și pune rezultatul în câmpul UserData. La run-instances --user-data file://web.sh, CLI-ul face singur codificarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
User data este scriptul pe care instanța îl rulează la prima pornire (instalează nginx, copiază fișiere). EC2 îl primește prin API codificat base64. Cine face codificarea depinde de comandă:
aws ec2 run-instances --user-data file://web.sh: CLI-ul codifică singur, deci dai textul scriptului;create-launch-templateșicreate-launch-template-version:UserDatastă în JSON-ul--launch-template-data, iar CLI-ul îl trimite cum e, deci trebuie să fie deja base64.
Când pui textul scriptului (#!/bin/bash ...) direct în launch template, EC2 încearcă să-l decodifice, găsește caractere care nu există în base64 (#, !, spații) și răspunde cu InvalidUserData.Malformed.
Greșeala inversă (base64 dat la run-instances) nu dă eroare: instanța primește un script codificat de două ori, care nu rulează.
De ce apare: cauzele frecvente
1Scriptul pus ca text în launch template
{"ImageId": "ami-...", "InstanceType": "t3.micro",
"UserData": "#!/bin/bash\ndnf install -y nginx"}UD=$(base64 -w0 web.sh)
cat > lt.json <<EOF
{"ImageId": "$AMI", "InstanceType": "t3.micro", "UserData": "$UD"}
EOFbase64 -w0 produce o singură linie base64, exact forma cerută în JSON.
2base64 cu rânduri rupte
UD=$(base64 web.sh)UD=$(base64 -w0 web.sh)
# pe macOS: UD=$(base64 -i web.sh)Fără -w0, base64 din Linux rupe rândurile la 76 de caractere, iar rândurile noi strică JSON-ul sau codificarea.
Repară eroarea, direct în pagină
Launch template-ul web-lt trebuie să pornească servere care instalează nginx din scriptul ~/web.sh. Scriptul ~/lt.sh pune textul lui web.sh direct în UserData și dă Invalid BASE64 encoding of user data. Repară ~/lt.sh ca UserData să fie codificat base64 și rulează-l.
Indiciu
UD=$(base64 -w0 ~/web.sh), apoi "UserData": "$UD" în lt.json.
Reparația
Codifică scriptul cu base64 -w0:
cat > ~/lt.sh <<'XEOF'
AMI=$(aws ssm get-parameter --name /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64 --query Parameter.Value --output text)
UD=$(base64 -w0 ~/web.sh)
cat > ~/lt.json <<EOF
{"ImageId": "$AMI", "InstanceType": "t3.micro", "UserData": "$UD"}
EOF
aws ec2 create-launch-template --launch-template-name web-lt --launch-template-data file://$HOME/lt.json
XEOF
bash ~/lt.shDe ce merge
În --launch-template-data, câmpul UserData trebuie să fie deja base64, iar textul #!/bin/bash... conține caractere care nu există în base64, deci EC2 l-a respins. Cu base64 -w0 ~/web.sh obții scriptul codificat pe o singură linie, iar launch template-ul web-lt se creează: fiecare server pornit din el decodifică scriptul și instalează nginx.
Alte forme ale mesajului
An error occurred (InvalidUserData.Malformed) when calling the CreateLaunchTemplateVersion operation: Invalid BASE64 encoding of user data.An error occurred (InvalidParameterValue) when calling the RunInstances operation: Invalid BASE64 encoding of user data.
Cum o eviți pe viitor
- Ține scriptul de user data într-un fișier separat (
web.sh) și codifică-l la nevoie cubase64 -w0. - La
run-instances, folosește--user-data file://web.sh(fără codificare manuală). - Verifică launch template-ul după creare:
aws ec2 describe-launch-template-versions --launch-template-name web-lt --query 'LaunchTemplateVersions[0].LaunchTemplateData.UserData' --output text | base64 -d.
Întrebări frecvente
De ce run-instances codifică singur, iar launch template-ul nu?
La run-instances, --user-data este un parametru separat, pe care CLI-ul îl tratează special. În launch template, UserData e doar un câmp în JSON-ul --launch-template-data, pe care CLI-ul îl trimite nemodificat.
Cât de mare poate fi user data?
Maximum 16 KB înainte de codificarea base64. Pentru scripturi mai mari, pune scriptul în S3 și descarcă-l din user data.
Erori înrudite
An error occurred (InvalidAMIID.NotFound) when calling the RunInstances operation: The image id '[ami-0abcdef1234567890]' does not exist ID-ul AMI din comandă nu există în regiunea în care lansezi: AMI-urile sunt regionale, iar ID-urile copiate din tutoriale sunt de obicei din altă regiune sau vechi. Ia ID-ul curent din SSM (/aws/service/ami-amazon-linux-latest/...) sau cu describe-images, în regiunea ta. Error parsing parameter '--tagging': Invalid JSON: Expecting property name enclosed in double quotes: line 1 column 2 (char 1) Valoarea dată unui parametru de tip structură (direct sau din file://) nu e JSON valid: ghilimele simple, virgulă după ultimul element, acoladă lipsă. CLI-ul îți arată linia și coloana; repară JSON-ul (verifică-l cu jq .) și rulează din nou. An error occurred (ParameterNotFound) when calling the GetParameter operation: Parametrul cerut din SSM Parameter Store nu există în regiunea curentă: numele e scris greșit sau parametrul e în altă regiune. Pentru AMI-ul Amazon Linux 2023, calea completă este /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64. Învață AWS de la zero, cu exerciții la fiecare lecție
Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
