Como usar o dsgit
Passo a passo por pessoa, do primeiro acesso ao runner certo para o seu workflow. Os blocos têm botão Copiar. Nenhum token aparece nesta página: onde o comando pede token, ele vem do cofre de credenciais do seu sistema.
Quer que a sua IA aprenda tudo isto de uma vez? Veja Contexto para a sua IA: textos prontos para colar, como pegar as suas chaves e o kit de entrada. Manuais completos (pede login): manual para a IA e manual da infraestrutura.
Legenda. em preparo = ainda não existe ou não foi conferido; o texto diz o que falta e não traz comando inventado. conferido = visto no dsgit ou no kit de entrada (ver a nota de cada item). Os nomes de menu do dsgit aparecem em inglês para contas novas; o português vem entre parênteses.
1. Primeiro acesso
O endereço é https://dsgit.dsmarketing.com.br. Sem login não se vê nada (login obrigatório); o cadastro aberto está desligado.
Login com Google conferido
Na tela de entrada há o botão do Google. Valem as contas dos domínios da empresa liberados para o dsgit. Se o e-mail da conta Google for o mesmo de uma conta local já criada, o dsgit entra nessa conta (vínculo automático); senão cria uma conta nova, sem permissão em nenhuma organização, e o administrador precisa adicioná-la.
Conta local conferido
O administrador cria a conta e passa o usuário. A senha precisa ter no mínimo 12 caracteres, com maiúscula, minúscula e número. Troque-a no primeiro login: avatar, Settings (Configurações), Account (Conta), bloco da senha.
Recuperar a senha por e-mail conferido
Na tela de entrada use “Forgot password” (esqueci a senha), ou vá direto a /user/forgot_password. O envio usa o Amazon SES. Enquanto a conta do SES estiver em modo de teste, o e-mail só chega para endereços do domínio verificado da empresa; para os demais, peça a troca da senha ao administrador. O e-mail cadastrado no dsgit precisa ser uma caixa que existe.
Segundo fator (2FA), opcional conferido
Settings, Security (Segurança), Two-factor authentication (TOTP) ou chave de segurança. Hoje é opcional. Quando o administrador tornar o 2FA obrigatório, quem não tiver cadastrado perde acesso à tela e à API até cadastrar; por isso cadastre antes.
2. Perfil conferido
| O quê | Onde | Observação |
|---|---|---|
| Nome completo, avatar, descrição | Settings, Profile (Perfil) — /user/settings | O nome aparece nos commits e nas execuções. |
Settings, Account — /user/settings/account | Use o e-mail da empresa. Notificações e recuperação de senha vão para ele. | |
| Aparência / idioma | Settings, Appearance — /user/settings/appearance | Tema claro ou escuro. |
| Chaves | Settings, SSH / GPG keys — /user/settings/keys | O Git por SSH está desligado: use HTTPS com token (item 4). A chave GPG só serve para assinar commits. |
| Segurança e 2FA | Settings, Security — /user/settings/security | Sessões, 2FA, contas vinculadas (Google). |
3. Token pessoal
O token é a sua senha para Git, API, CLI e MCP. Crie em Settings, Applications (Aplicações), Generate new token — /user/settings/applications conferido.
- Nome que diga onde ele vive, por exemplo
pc-minha-maquina. - Escopos mínimos para o dia a dia (do kit de entrada):
Escopo Nível Para quê repositoryleitura e escrita clone, push, pull requests, execuções, logs, reexecutar. Só para ler, deixe leitura. issueleitura e escrita questões e comentários em PR userleitura o kit conferir quem é você organizationleitura listar organizações e times notificationleitura avisos (MCP) packageleitura baixar pacotes - Restringir por repositório: no mesmo formulário o campo de acesso a repositórios tem as opções All (todos), Public only e Specific repositories (repo-specific) conferido. Para token de automação use “específicos” e marque só os repositórios necessários.
- Copie o token: ele aparece uma única vez.
Nunca cole o token em arquivo, em repositório, em chat, em variável de ambiente permanente nem em página. Guarde-o no cofre de credenciais do sistema (itens 4 e 5 fazem isso). Se vazar, apague-o na mesma tela e gere outro. Não use escopos de administração nem escrita em user/organization.
4. Git por HTTPS
Usuário = o seu login do dsgit; senha = o token. O cofre de credenciais guarda para você, e o Git não pergunta de novo.
Clonar
git clone https://dsgit.dsmarketing.com.br/<dono>/<repositorio>.git
Cofre de credenciais só para este host conferido (é o que o kit faz)
Windows (Git for Windows já traz o Gerenciador de Credenciais):
git config --global credential.https://dsgit.dsmarketing.com.br.helper manager git config --global credential.https://dsgit.dsmarketing.com.br.username SEU_LOGIN
macOS: troque manager por osxkeychain. Linux: use git-credential-libsecret se existir. Na primeira operação o Git pede a senha: cole o token. O jeito mais simples é o kit de entrada (item 5), que faz tudo isso e confere.
Rodando atrás da VPN da Under em túnel completo o dsgit não abre; use a VPN dividida.
5. CLI (kit de entrada) conferido no LEIAME do kit kit publicado na Central
O kit de entrada pode ser baixado em Chaves e kit da sua máquina (a pasta onboarding do projeto tem a mesma coisa). Ele instala a CLI tea, o servidor MCP e o comando dsgit, guarda o token no cofre e roda um autoteste. Rodar de novo é seguro.
Windows (PowerShell):
.\entrar.ps1 # se o Windows bloquear: powershell -ExecutionPolicy Bypass -File .\entrar.ps1
Linux, macOS ou Git Bash:
bash entrar.sh
O token é pedido sem eco. No fim o autoteste deve mostrar 5 linhas PASS e 0 FAIL. Para repetir: dsgit teste. Depois, num terminal novo:
dsgit-prs [dono/repo] # pull requests abertos dsgit-runs [dono/repo] # execuções do Actions (o #N é o número usado abaixo) dsgit-log N [dono/repo] [etapa] dsgit-rerun N [dono/repo] dsgit-api /user # API direta tea pulls create # CLI tea (login dsgit) tea repos ls
Sem argumento de repositório, os comandos usam o repositório da pasta atual. tea actions runs não funciona com o Forgejo 17: use dsgit-runs e dsgit-log. Desfazer tudo: bash sair.sh (ou .\sair.ps1) e apagar o token em Settings, Applications.
6. Servidor MCP no Claude Code conferido no kit
O kit registra o servidor dsgit no Claude Code em escopo de usuário; o token é lido do cofre a cada início, nunca fica no arquivo de configuração. Para conferir e listar as ferramentas:
claude mcp get dsgit dsgit mcp --cli list
Se o Claude Code não estava instalado quando você rodou o kit, instale e rode o kit de novo. No Windows, na primeira vez, o kit compila o servidor (4 a 8 minutos, cerca de 75 MB).
7. Shell: alias e funções conferido no kit
O kit põe no seu perfil um bloco marcado entre # >>> dsgit e # <<< dsgit <<<, que ajusta o PATH e cria dsgit-prs, dsgit-runs, dsgit-log, dsgit-rerun e dsgit-api (alias no bash e no zsh; funções no PowerShell). Não edite dentro do bloco; sair o remove. Abra um terminal novo depois de rodar o kit, ou:
source ~/.bashrc
8. Escolher o runner no workflow
O workflow fica em .forgejo/workflows/. O runner é escolhido por rótulo em runs-on. Quanto maior o rótulo, mais potente e mais caro; comece pelo menor que dá conta.
| runs-on | Para quê | Situação |
|---|---|---|
p | testes leves, lint, jobs curtos | no ar |
m | builds médios, suítes maiores | no ar |
g | builds pesados, muita CPU ou memória | no ar |
xg | pico de fila: máquina de nuvem (spot), nunca para deploy | no ar criado por pedido, 1 instância por job; sobe em cerca de 65 s [medido 18/11] |
xxg | urgência ou quando o spot falha: nuvem sob demanda | no ar criado por pedido, 1 instância por job [medido 18/11] |
A situação real, por rótulo, está em Filas (contadores públicos).
Exemplo mesmo formato do workflow de prova de vida dos runners
name: testes
on:
push:
branches: [main]
workflow_dispatch:
jobs:
testes:
runs-on: m
timeout-minutes: 15
steps:
- uses: actions/checkout@v4
- run: echo "rodando no runner m"Rótulo estavel: os runners p, m e g também têm o rótulo estavel (máquinas que não somem no meio do job); o xg nunca. É o que o deploy deve usar. A forma de pedir os dois ao mesmo tempo na lista de runs-on não foi testada aqui: confira num workflow de teste antes de usar.
Pedir xg ou xxg: funciona com runs-on: [dsgit, xg] ou pela entrada runner do disparo manual [medido 18/11]; pela etiqueta do PR não testado. O Forgejo não troca o rótulo de um job que já está na fila, então o pedido tem de chegar antes de o job existir (etiqueta runner:xg ou runner:xxg no PR, ou entrada do disparo manual). A expressão no runs-on ainda precisa ser validada no Forgejo 17.
9. Etiqueta de projeto (centro de custo) no ar
Regra definida: todo job é registrado com um projeto. O padrão é a organização do repositório. Para cobrar de outro projeto, crie no repositório a variável de Actions DSGIT_PROJETO com o nome do projeto (repositório, Settings, Actions, Variables). Quem lê essa variável é o distribuidor (no ar, modo automático): ele grava o projeto, o card e o custo estimado de cada execução e etiqueta as máquinas da AWS. Não coloque segredo nela.
10. Urgência no ar
Urgência faz o distribuidor escolher o caminho mais rápido, não o mais barato [medido 18/11]. Enquanto o Quadro de cards não fala com o dsgit, o efeito vem de:
- branch
hotfix/<assunto>(amaintambém conta como alta); - etiqueta
urgenteno pull request; - priorização manual da execução.
O distribuidor não reordena a fila do Forgejo: ele liga o runner mais rápido que existir (ou cria XG/XXG, dentro do teto de US$ 9 por dia).
11. O que está travado no piloto
Retrato de 18/11/2026, tirado dos registros do projeto; confira a data e as pendências do projeto antes de contar com algo daqui.
- Runners
xgexxgexistem, mas só sobem sob pedido ou fila cheia e dentro do teto de US$ 9 por dia; omdesliga sozinho quando ocioso e religa em cerca de 2 minutos. - Deploy real continua travado: a única exceção é o deploy de teste do projeto
dsgit/teste-ambiente, em bucket S3 de teste. - Recuperar senha por e-mail funciona para o domínio da empresa; para outros domínios não funciona: a AWS negou a saída do SES do modo de teste.
- 2FA obrigatório está desligado de propósito, para não travar a automação; será ligado depois que as contas cadastrarem o segundo fator.
- A VPN própria do dsgit existe (4 pares); o uso pessoal de ponta a ponta ainda não foi provado.
- Os repositórios de documentação não rodam Actions (desligado por decisão).
- Manuais completos e um README por componente estão em
dsgit/docsedsgit/infra(privados: peça acesso à equipe de infraestrutura).