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

An error occurred (InvalidKeyPair.Duplicate) when calling the CreateKeyPair operation: The keypair already exists

Pe scurt

În regiune există deja o pereche de chei cu acest nume. Folosește-o pe cea existentă (dacă ai fișierul .pem) sau alege alt nume; nu o șterge și recrea doar ca să treacă scriptul, pentru că pierzi accesul la serverele care o folosesc.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Numele perechilor de chei sunt unice într-o regiune. create-key-pair cu un nume deja folosit dă InvalidKeyPair.Duplicate.

Apare de obicei în scripturi rulate a doua oară. Mai e o capcană: dacă scriptul face create-key-pair ... > cheie.pem, shell-ul golește fișierul .pem înainte ca AWS să răspundă cu eroarea. Fișierul cu cheia privată ajunge gol, iar cheia nu poate fi descărcată din nou: AWS o dă o singură dată, la creare.

Ce faci:

  • dacă ai încă fișierul .pem corect, folosește perechea existentă (--key-name cheie-web la run-instances);
  • dacă nu, creează o pereche nouă, cu alt nume, și folosește-o la serverele noi.

Perechile sunt per regiune: aceeași cheie nu e vizibilă automat în altă regiune.

De ce apare: cauzele frecvente

1Scriptul creează cheia la fiecare rulare

Greșit
BASH
set -e
aws ec2 create-key-pair --key-name cheie-web --query KeyMaterial --output text > ~/cheie-web.pem
aws ec2 run-instances --key-name cheie-web ...
Corect
BASH
set -e
if ! aws ec2 describe-key-pairs --key-names cheie-web > /dev/null 2>&1; then
  aws ec2 create-key-pair --key-name cheie-web --query KeyMaterial --output text > ~/cheie-web.pem
  chmod 400 ~/cheie-web.pem
fi
aws ec2 run-instances --key-name cheie-web ...

Cheia se creează doar dacă lipsește, deci fișierul .pem existent nu mai e suprascris.

2Cheia există deja, creată de un coleg

Greșit
BASH
aws ec2 create-key-pair --key-name cheie-web
Corect
BASH
aws ec2 describe-key-pairs --key-names cheie-web
aws ec2 run-instances --key-name cheie-web ...

Folosește perechea existentă și cere-i colegului fișierul privat pe un canal sigur.

Repară tu

Repară eroarea, direct în pagină

Perechea cheie-web există deja (cu fișierul ~/cheie-web.pem). Scriptul ~/server.sh vrea s-o creeze din nou, dă InvalidKeyPair.Duplicate și se oprește înainte să pornească serverul web. Repară scriptul ca să creeze cheia doar dacă lipsește, rulează-l și păstrează fișierul .pem neatins.

Indiciu

Pune create-key-pair într-un if ! aws ec2 describe-key-pairs --key-names cheie-web > /dev/null 2>&1; then ... fi.

Alte forme ale mesajului

  • An error occurred (InvalidKeyPair.Duplicate) when calling the ImportKeyPair operation: The keypair 'cheie-web' already exists.

Cum o eviți pe viitor

  • Creează perechile de chei o singură dată, separat de scripturile care pornesc servere.
  • Păstrează fișierele .pem într-un loc sigur (manager de parole, vault), cu chmod 400.
  • În scripturi, testează existența cu describe-key-pairs înainte de create-key-pair.
  • Nu redirecționa > cheie.pem într-o comandă care poate eșua: scrie întâi într-un fișier temporar și mută-l doar dacă comanda reușește.

Întrebări frecvente

Pot descărca din nou cheia privată?

Nu. AWS păstrează doar cheia publică. Cheia privată ți-o dă o singură dată, la create-key-pair. Dacă ai pierdut-o, creează o pereche nouă.

Dacă șterg perechea, serverele existente se opresc?

Nu. Cheia publică e deja copiată pe server (în ~/.ssh/authorized_keys). Ștergerea perechii doar o scoate din lista EC2, deci n-o mai poți da serverelor noi.

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.