Como conectar o GitHub e configurar os Ambientes

Na página Ambientes, o admin da organização cadastra os repositórios, informa o endereço de cada ambiente e conecta o GitHub. Com isso, o painel acompanha cada GitHub Actions de deploy: passos, duração e o log do que falhou. Todos os membros veem a página; só o admin configura.

Para abrir, use o menu do usuário, no topo do painel, e escolha Ambientes. A página tem as abas Homologação, Produção, Actions, GitHub e Conexões.

1. Conectar o GitHub

O Benflow só lê o GitHub. Quem publica é o push do dev, pela máquina dele. Por isso a conexão usa um token fine-grained somente leitura. No GitHub:

1. 1
   Passo 1: Abra Settings, Developer settings, Personal access tokens, Fine-grained tokens e clique em Generate new token.
2. 2
   Passo 2: Em Resource owner, escolha a organização dona dos repositórios. Se ela exigir aprovação, um dono da organização aprova o token.
3. 3
   Passo 3: Em Repository access, marque Only select repositories e escolha só os repositórios usados no Benflow.
4. 4
   Passo 4: Em Permissions, Repository permissions, deixe como Read-only: Actions, Contents, Metadata e Pull requests. Nada além disso.
5. 5
   Passo 5: Em Expiration, escolha a validade e anote a data para trocar o token antes de vencer.
6. 6
   Passo 6: Clique em Generate token e copie.

Depois, no Benflow:

1. 1
   Passo 1: Em Ambientes, aba GitHub, clique em Editar conexão e repositórios.
2. 2
   Passo 2: Em Como o painel lê o GitHub, escolha Token de leitura (fine-grained) e cole o token em Token do GitHub.
3. 3
   Passo 3: Em Repositórios, clique em Adicionar repositório, preencha Repositório 1 como dono/nome (por exemplo, acme/app) e informe em Workflow de deploy o nome do arquivo que faz o deploy, que fica na pasta .github/workflows. Repita para cada repositório.
4. 4
   Passo 4: Clique em Salvar conexão e depois em Testar conexão.

O token fica guardado e nunca volta para a tela: o painel mostra só o final dele e a Conta conectada. O Testar conexão confere, em cada repositório, a leitura, as branches e se o workflow dispara por push. Também dá para escolher Sem conexão: o push continua sendo a publicação, mas o painel não acompanha a Action.

2. Configurar Homologação e Produção

1. 1
   Passo 1: Abra a aba Homologação e clique em Editar Homologação.
2. 2
   Passo 2: Deixe a Branch como develop em Homologação e main em Produção: é nelas que a IA publica. O campo aceita outro nome, mas a Equipe IA sempre faz o push na develop e na main.
3. 3
   Passo 3: Em URL do app, informe o endereço que as pessoas abrem para validar. Ele vira o link do ambiente no quadro.
4. 4
   Passo 4: Em URL de saúde, informe um endereço que responde quando o sistema está no ar. O Benflow confere a cada 2 minutos e fica verde quando a resposta tem status abaixo de 500.
5. 5
   Passo 5: Se quiser, escreva uma Observação e clique em Salvar Homologação. Repita na aba Produção.

on:
  push:
    branches: [develop, main]

O que o painel mostra

• Em Homologação e Produção: se o ambiente está No ar, o Último deploy por repositório e os Chamados neste ambiente.
• Em Actions: as Actions recentes, com filtro por ambiente, os passos e o log de cada run. O log aparece para admins e para quem pode subir para develop ou main.
• Em Conexões: uma lista do que está certo e do que precisa de atenção.

Depois de cada push, o painel acompanha a Action daquele commit. Se nenhuma Action aparecer em 10 minutos, o deploy fica como Sem Action e o trabalho, como Falhou. Se a Action falhar, o trabalho volta para desenvolvimento com o passo que quebrou. Veja como publicar e validar.