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êOndeObservação
Nome completo, avatar, descriçãoSettings, Profile (Perfil) — /user/settingsO nome aparece nos commits e nas execuções.
E-mailSettings, Account — /user/settings/accountUse o e-mail da empresa. Notificações e recuperação de senha vão para ele.
Aparência / idiomaSettings, Appearance — /user/settings/appearanceTema claro ou escuro.
ChavesSettings, SSH / GPG keys — /user/settings/keysO Git por SSH está desligado: use HTTPS com token (item 4). A chave GPG só serve para assinar commits.
Segurança e 2FASettings, Security — /user/settings/securitySessõ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.

  1. Nome que diga onde ele vive, por exemplo pc-minha-maquina.
  2. Escopos mínimos para o dia a dia (do kit de entrada):
    EscopoNívelPara quê
    repositoryleitura e escritaclone, push, pull requests, execuções, logs, reexecutar. Só para ler, deixe leitura.
    issueleitura e escritaquestões e comentários em PR
    userleiturao kit conferir quem é você
    organizationleituralistar organizações e times
    notificationleituraavisos (MCP)
    packageleiturabaixar pacotes
  3. 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.
  4. 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-onPara quêSituação
ptestes leves, lint, jobs curtosno ar
mbuilds médios, suítes maioresno ar
gbuilds pesados, muita CPU ou memóriano ar
xgpico de fila: máquina de nuvem (spot), nunca para deployno ar criado por pedido, 1 instância por job; sobe em cerca de 65 s [medido 18/11]
xxgurgência ou quando o spot falha: nuvem sob demandano 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:

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.