...
Eroare AWS · EC2: AMI, chei, security groups și SSH

An error occurred (InvalidUserData.Malformed) when calling the CreateLaunchTemplate operation: Invalid BASE64 encoding of user data.

Pe scurt

Î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 și create-launch-template-version: UserData stă î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

Greșit
BASH
{"ImageId": "ami-...", "InstanceType": "t3.micro",
 "UserData": "#!/bin/bash\ndnf install -y nginx"}
Corect
BASH
UD=$(base64 -w0 web.sh)
cat > lt.json <<EOF
{"ImageId": "$AMI", "InstanceType": "t3.micro", "UserData": "$UD"}
EOF

base64 -w0 produce o singură linie base64, exact forma cerută în JSON.

2base64 cu rânduri rupte

Greșit
BASH
UD=$(base64 web.sh)
Corect
BASH
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ă tu

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.

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 cu base64 -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

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.