Recupere uma imagem sobrescrita do portfólio

AWSBeginner
Pratique Agora

Introdução

Recupere uma capa sobrescrita com versões S3 e confira a imagem correta no site real.

Conclua o laboratório de S3 privado. Este ambiente novo traz um site autorizado para três capas e projects.json. Você ativa e cria versões, sem recursos ou credenciais anteriores.

Relação com certificação

Certificação Tarefas Prática
AWS Certified Cloud Practitioner (CLF-C02) Task 3.6 Preservar e recuperar conteúdo com versionamento S3.

Visão geral

Recupere uma capa sobrescrita com versões S3 e confira a imagem correta no site real.

Preserve uma versão correta

Nesta etapa, você ativará versões e guardará o ID da capa AURA correta.

Abra o site pelo AWS View: AURA mostra produtos de skincare. Carregue identificadores e confira o bucket:

cd /home/labex/project
source website.env
echo "$PORTFOLIO_BUCKET"

S3 Versioning guarda várias versões sob a mesma chave. A leitura normal retorna a atual; VersionId escolhe uma versão específica. Ative no bucket:

aws s3api put-bucket-versioning \
  --bucket "$PORTFOLIO_BUCKET" \
  --versioning-configuration Status=Enabled

A atualização não gera saída. Leia a configuração e confirme Status=Enabled:

aws s3api get-bucket-versioning --bucket "$PORTFOLIO_BUCKET"

Objetos existentes mantêm null; ativar versões não cria novos IDs retroativamente. Envie AURA novamente para criar uma versão nomeada. put-object envia --body; $(...) guarda o VersionId escolhido por --query e --output text:

--content-type image/webp identifica uma imagem WebP. Copie todo o bloco: a barra invertida final continua o comando.

ORIGINAL_VERSION=$(aws s3api put-object \
  --bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
  --body portfolio-assets/images/aura-brand.webp --content-type image/webp \
  --query VersionId --output text)
echo "$ORIGINAL_VERSION"

O ID identifica a versão, não bucket ou chave. Mantenha Terminal aberto: ORIGINAL_VERSION será usado na etapa 3. Atualize; AURA continua correta porque o arquivo é o mesmo.

O novo ambiente contém seu site e quatro objetos privados; os identificadores variam.

Observe a atualização errada

Nesta etapa, você enviará uma capa incorreta e verá o resultado real.

aura-draft.webp contém o disco ECHO e simula escolher o arquivo errado para AURA. A mesma chave recebe uma nova versão atual, preservando a correta anterior:

aws s3api put-object \
  --bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
  --body aura-draft.webp --content-type image/webp \
  --query VersionId --output text

O comando mostra o VersionId do rascunho. Atualize: AURA mostra um disco com a mesma etiqueta. FORMA e ECHO mantêm suas imagens.

Ponto de controle real do laboratório; seus identificadores podem variar.

Confira só o histórico AURA. --query filtra a chave e seleciona VersionId e IsLatest; --output table facilita a comparação:

aws s3api list-object-versions \
  --bucket "$PORTFOLIO_BUCKET" \
  --query 'Versions[?Key==`"images/aura-brand.webp"`].{VersionId:VersionId,IsLatest:IsLatest}' \
  --output table

Espere três linhas: null e duas versões novas. IsLatest=True marca o rascunho servido; ORIGINAL_VERSION permanece disponível. Ordem e IDs variam. A recuperação está no S3, além de manter uma cópia local.

Recupere a imagem anterior

Nesta etapa, você recuperará a versão correta e enviará seus bytes como nova capa atual.

get-object baixa o objeto. --version-id escolhe ORIGINAL_VERSION, não o rascunho; recovered-aura.webp é o arquivo local:

aws s3api get-object \
  --bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
  --version-id "$ORIGINAL_VERSION" recovered-aura.webp

Após baixar, a CLI mostra metadados. Confira o VersionId guardado; ainda não precisa interpretar cada checksum. Verifique depois o conteúdo.

Compare com o original correto. Sem saída de cmp e com o prompt de volta, os bytes coincidem:

cmp portfolio-assets/images/aura-brand.webp recovered-aura.webp

Baixar sozinho não altera o site. Envie o arquivo recuperado à mesma chave para criar uma nova versão atual:

aws s3api put-object \
  --bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
  --body recovered-aura.webp --content-type image/webp \
  --query VersionId --output text

Atualize: AURA volta ao skincare. FORMA, ECHO e projects.json não mudam. Leia o histórico novamente:

Ponto de controle real do laboratório; seus identificadores podem variar.

aws s3api list-object-versions \
  --bucket "$PORTFOLIO_BUCKET" \
  --query 'Versions[?Key==`"images/aura-brand.webp"`].{VersionId:VersionId,IsLatest:IsLatest}' \
  --output table

Quatro versões AURA permanecem. A restaurada tem IsLatest=True; o rascunho fica no histórico, mas não é atual. O site foi recuperado sem perder as mudanças.

Resumo

Você ativou versões, guardou a correta, observou um envio errado e restaurou os bytes anteriores como versão atual. Site e histórico confirmaram a recuperação; os outros materiais não mudaram.

Referências oficiais: S3 Versioning, retrieving object versions.