---
name: new-app-argocd
description: Resolve "app novo não apareceu no ArgoCD" no lab. Use quando o aluno adicionou um app em gitops/apps/ e a Application não nasce, ou o sync dá PermissionDenied. Conduza como tutor — mostre a causa, não só o comando.
---

# App novo não apareceu no ArgoCD (lab — modo tutor)

Você é tutor (CLAUDE.md). Use o caso pra ensinar o padrão app-of-apps (Cap. 9) e o conceito de reconcile (Cap. 0). Não dê só o comando — faça o aluno entender por que.

## Quando usar

- Aluno: "adicionei o app no gitops mas não apareceu" / sync com PermissionDenied / `kubectl -n argocd get applications` sem o app

## Conceito primeiro (pergunte antes de mandar comando)

`PermissionDenied` no sync ≠ falta de permissão; quase sempre = a Application **ainda não foi gerada**. No lab a cadeia é: `gitops/app-of-apps.yaml` → observa `gitops/apps/` → cada arquivo vira uma Application. Faça o aluno recitar essa cadeia antes de seguir.

## Verifique nesta ordem

1. **Arquivo no git certo?**
   ```bash
   git log --oneline -2 -- gitops/apps/ && ls gitops/apps/
   ```
   O arquivo do app novo está commitado **e pushado** (o ArgoCD lê do remote)?
2. **repoURL certo?** Em `gitops/app-of-apps.yaml` e no arquivo do app — aponta pro repo/branch reais? (placeholder `SEU-USUARIO` trocado?)
3. **app-of-apps reconciliou?**
   ```bash
   kubectl -n argocd get applications
   argocd app get app-of-apps          # syncedRev == seu último commit?
   ```
   Git certo mas app não nasceu → reconcile não rodou. Ensine o conceito de `timeout.reconciliation` (no trabalho real costuma ser 1h!) e force:
   ```bash
   kubectl -n argocd annotate application app-of-apps argocd.argoproj.io/refresh=hard --overwrite
   ```

## Depois que aparece

`Synced/Degraded` = gitops OK, workload quebrado → skill `diagnose-platform` (elos 4–5). Faça o aluno separar "problema de gitops" de "problema do app" — é a lição central.

## Fecho (socrático)

Peça o aluno explicar: "por que PermissionDenied não era falta de permissão?" e "o que reconcile tem a ver com o Cap. 0?". Se ele responder, aprendeu.