Skip to content

Inicio-de-aula.md

Latest commit

 

History

History
217 lines (140 loc) · 7.54 KB

Inicio-de-aula.md

File metadata and controls

217 lines (140 loc) · 7.54 KB
Raw

01.1 - Ritual de início de aula (Preparando Credenciais)

Todo laboratório começa com o mesmo ritual: sincronizar o fork (puxar novos labs que o professor publicou) e renovar as credenciais da AWS Academy (elas expiram a cada 4 horas). Este arquivo é a referência curta que você reabre antes de cada aula.

Warning

Pré-requisitos — confira antes de começar:

  • Setup inicial concluído (01 - Setup). Se nunca fez, pare e faça antes.
  • Fork do repositório existe na sua conta GitHub.
  • Codespaces já criado (mesmo que desligado — você vai reabrir, não criar novo).

O que você vai fazer: sincronizar seu fork, reabrir o Codespaces, iniciar uma nova sessão do Learner Lab e colar credenciais novas. Tempo estimado: 3-5 minutos.

Tip

Se você já fez este ritual na aula de HOJE, pode pular direto para o lab. As credenciais duram 4 horas — só recomeça se passou disso ou se o aws s3 ls começou a falhar.

Mapa do ritual

# Parte O que acontece
1 Sincronizar fork Pegar labs novos do repo original.
2 Reabrir Codespaces Subir o ambiente e dar git pull.
3 Iniciar Learner Lab Start Lab na AWS Academy e esperar a bolinha verde.
4 Renovar credenciais Colar AWS Details → CLI em ~/.aws/credentials e testar com aws s3 ls.

Parte 1 - Sincronizar fork

Resultado esperado desta parte

Fork do repo na sua conta alinhado com o upstream (repositório original), com quaisquer labs novos disponíveis.

  1. Acesse seu fork do repositório em github.com (na sua conta, não na conta vamperst).

  2. Clique em Sync fork (meio da tela, perto do botão Code). Se aparecer Update branch, clique nele para sincronizar.

Note

Se aparecer This branch is not behind the upstream, está tudo OK — não há labs novos para puxar. Siga para a Parte 2.

Checkpoint

  • Fork sincronizado (ou já estava em dia com o upstream).

Parte 2 - Reabrir Codespaces

Resultado esperado desta parte

Codespaces rodando com o terminal aberto, repositório local atualizado via git pull.

  1. Acesse github.com/codespaces.

  2. Clique no Codespaces que você criou no setup (derivado de fiap-cloud-engineering). Se estiver Stopped, ele vai reiniciar automaticamente — leva ~30 segundos.

  1. No terminal do Codespaces, atualize o repositório local para puxar o que você sincronizou no GitHub na Parte 1:
git pull origin main

Checkpoint

  • Codespaces aberto e funcional.
  • git pull rodou sem conflito (normalmente retorna Already up to date. ou lista de arquivos atualizados).
⚠ Se der erro: Your local changes would be overwritten by merge

Você tem alterações locais não commitadas. Se são alterações que você quer preservar, faça git stash, depois git pull, depois git stash pop. Se são lixo de um lab anterior, faça git checkout . para descartá-las antes do pull.

Parte 3 - Iniciar o Learner Lab

Resultado esperado desta parte

Sessão do AWS Academy Learner Lab iniciada, com a bolinha verde ao lado de AWS e credenciais temporárias disponíveis em AWS Details.

  1. Acesse AWS Academy e entre no curso AWS Academy Learner Lab que o professor informou.

  1. Na lateral esquerda, clique em Módulos.

  1. Clique em Iniciar os laboratórios de aprendizagem da AWS Academy.

  1. Clique em Start Lab e aguarde a bolinha ao lado de AWS ficar verde (leva 1-3 min).

Checkpoint

  • Bolinha AWS verde no topo da página.
  • Sessão de 4 horas iniciada.

Parte 4 - Renovar credenciais no Codespaces

Resultado esperado desta parte

Arquivo ~/.aws/credentials no Codespaces com credenciais novas, e aws s3 ls respondendo sem erro.

  1. Na aba do AWS Academy, clique em AWS Details no canto superior direito.

  1. Na seção AWS CLI, clique em Show e copie todo o bloco de credenciais.

  1. No Codespaces, abra o arquivo de credenciais:
code ~/.aws/credentials
  1. Cole o conteúdo copiado, substituindo tudo que já estava lá (as credenciais antigas). Salve com Ctrl+S ou Cmd+S.

  1. Teste — este é o checkpoint final do ritual:
aws s3 ls

Saída esperada: pelo menos uma linha com seu bucket base-config-<SEU_RM>.

Checkpoint

  • aws s3 ls responde sem erro.
  • Bucket base-config-<SEU_RM> aparece na listagem.
⚠ Se der erro: Unable to locate credentials ou ExpiredToken

As credenciais novas não foram salvas corretamente. Verifique:

  1. O arquivo ~/.aws/credentials tem exatamente o bloco [default] colado da AWS Details (não [Academy] ou outro profile).
  2. Você salvou o arquivo com Ctrl+S/Cmd+S.
  3. A sessão do Learner Lab está com a bolinha verde (se ficou amarela no meio do caminho, faça End Lab e Start Lab de novo).

Pronto

Ambiente armado, credenciais frescas, pronto para o lab do dia. Agora vá direto para a URL do laboratório que o professor indicou no começo da aula.

Caution

Ao final da aula, desligue o Codespaces em github.com/codespaces → 3 pontinhos → Stop Codespace. Isso preserva suas 120h/mês gratuitas do plano estudante.

💡 Como pedir ajuda se travou

Antes de abrir issue ou chamar o professor, colete:

  1. Em qual parte (1, 2, 3 ou 4) travou.
  2. A mensagem de erro literal (copie e cole).
  3. O que aws sts get-caller-identity retorna (se chegou na Parte 4).
  4. Se a bolinha do Learner Lab está verde, amarela ou vermelha.

Canais, em ordem:

  1. Issues deste repositório — preferido, cria histórico pesquisável.
  2. Email do professor com os 4 itens acima.
  3. Na sala de aula, durante o laboratório.