Como publicar em homologação, validar e subir para produção

Quando a IA termina o trabalho no local, ele fica em Aguardando subir para homologação. Daí em diante são três passos, cada um com um botão no chamado: subir para homologação, validar e subir para produção. Cada passo pede a permissão certa.

Quem pode publicar

O admin da organização libera por pessoa em Membros, no menu do usuário:

• Pode subir para develop (homologação)
• Pode subir para main (produção)

Admin começa com as duas; funcionário, com nenhuma. Trocar o perfil de alguém refaz as duas marcações conforme o novo perfil. Veja como mudar o perfil de um membro. Para publicar um trabalho com IA, valem três regras juntas:

• Você é o dono do agente ou admin.
• Você tem a permissão do ambiente.
• O dono do agente também tem a permissão do ambiente.

Sem a permissão, o Claude trabalha e testa na máquina, mas não publica: o botão fica desativado, com o motivo logo abaixo.

Subir para homologação

1. 1
   Passo 1: No chamado, em Trabalho, clique em Subir para homologação e confirme.
2. 2
   Passo 2: O Claude junta a branch do chamado na develop, roda os testes de novo e faz o push.
3. 3
   Passo 3: O GitHub Actions publica e o painel mostra os passos em Deploys, com o link Abrir a Action no GitHub.
4. 4
   Passo 4: Deu certo? O trabalho vai para Aguardando validação.

Validar

Abra a homologação, confira o que foi pedido e escolha. Qualquer membro ativo da organização valida, pelo painel ou pelos botões do Telegram (com o Telegram ligado ao cadastro).

• Aprovar: libera a subida para produção.
• Pedir ajuste: conte o que precisa mudar. No Telegram, o bot pede o motivo como resposta à mensagem.

O texto do ajuste vira o complemento de um trabalho novo com a IA, no mesmo agente e na mesma branch. Se quem pediu pelo painel é o dono do agente ou um admin, o trabalho começa na hora. Nos outros casos, e sempre pelo Telegram, o pedido fica registrado e o dono do agente ou um admin clica em Iniciar o ajuste com IA.

Subir para produção

1. 1
   Passo 1: Com a validação aprovada, clique em Subir para produção e confirme.
2. 2
   Passo 2: O Claude cria uma branch de correção a partir da main, refaz só a mudança deste chamado, roda os testes e faz o push na main. Ele nunca junta a develop inteira na main.
3. 3
   Passo 3: Quando a Action termina bem, o trabalho fica como Concluída e o card vai para Concluído.

/subir homologacao 12
/subir producao 12

Quando o deploy falha

• A Action falhou: o trabalho fica como Falhou e volta para desenvolvimento, com o passo que quebrou. O trecho do log, em Log da Action, aparece para admins e para quem pode subir. Use Mandar a IA corrigir.
• Nenhuma Action em 10 minutos: confira se o push chegou ao GitHub e se o workflow dispara por push nessa branch.
• GitHub não conectado: o push conta como a publicação e o trabalho segue direto. Confira o ambiente antes de validar.

Trabalho manual? Suba pela sua máquina, com a etiqueta do chamado na mensagem do commit, como [acme-12]. Com o GitHub conectado, o painel liga as Actions com essa etiqueta ao chamado. A configuração do GitHub fica em Ambientes e GitHub Actions.