Skip to content

PUBLISH_RC.md

Latest commit

 

History

History
160 lines (118 loc) · 4.83 KB

PUBLISH_RC.md

File metadata and controls

160 lines (118 loc) · 4.83 KB

Publicar RC 2026.01.04-rc1

Repositório: https://github.com/LogLine-Foundation/SIRP

✅ Pré-requisitos Concluídos

  • Artefato gerado: dist/sirp-unified-2026.01.04-rc1.zip (313M)
  • SHA256: 47871baa48c6c99d92840160fcf193cece245e10634052a4aeb6db87b2abdf60
  • Template de release notes atualizado
  • Workflows CI configurados
  • Sanity checks passados
  • .gitignore configurado (dist/ ignorado)

🚀 Comandos para Publicar

⚠️ IMPORTANTE: Guard Rail Obrigatório

NUNCA commitar o ZIP de 313MB (GitHub barra arquivos >100MB)

cd /Users/ubl-ops/sirp-unified

# Garantir que dist/ está no .gitignore
echo "dist/" >> .gitignore

# Remover do índice se já foi adicionado (sem deletar arquivo)
git rm -r --cached dist 2>/dev/null || true

# Commit do .gitignore
git add .gitignore
git commit -m "chore: ignore dist/ artifacts" || true

Opção 1: Automação Completa (Recomendado)

cd /Users/ubl-ops/sirp-unified

# 0. Guard rail obrigatório (IMPORTANTE!)
echo "dist/" >> .gitignore
git rm -r --cached dist 2>/dev/null || true
git add .gitignore
git commit -m "chore: ignore dist/ artifacts" || true

# 1. Inicializar git (se ainda não for repo)
git init
git add -A
git commit -m "chore(release): SIRP 2026.01.04-rc1" || true

# 2. Configurar remote
git remote add origin https://github.com/LogLine-Foundation/SIRP.git 2>/dev/null || true
git branch -M main

# 3. Criar tag
git tag -a "v2026.01.04-rc1" -m "SIRP 2026.01.04-rc1"

# 4. Push (workflow cria draft automaticamente)
git push -u origin main
git push --tags

# 5. Verificar Actions
# - Ir em: https://github.com/LogLine-Foundation/SIRP/actions
# - Workflow "Create Release Draft" deve criar draft automaticamente
# - Workflow "Validate SIRP Bundle" deve validar o tag

# 6. Anexar artefato ao draft (localmente, não vai pro git)
shasum -a 256 dist/sirp-unified-2026.01.04-rc1.zip
# Deve imprimir: 47871baa48c6c99d92840160fcf193cece245e10634052a4aeb6db87b2abdf60

gh release upload "v2026.01.04-rc1" dist/sirp-unified-2026.01.04-rc1.zip

# 7. Revisar e publicar
gh release view "v2026.01.04-rc1" --web
# Ou ir em: https://github.com/LogLine-Foundation/SIRP/releases
# Revisar draft "v2026.01.04-rc1" e publicar quando pronto

Opção 2: Manual (Sem Automação)

cd /Users/ubl-ops/sirp-unified

# 0. Guard rail obrigatório (IMPORTANTE!)
echo "dist/" >> .gitignore
git rm -r --cached dist 2>/dev/null || true
git add .gitignore
git commit -m "chore: ignore dist/ artifacts" || true

# 1-3. Mesmo processo acima

# 4. Push (sem criar release automaticamente)
git push -u origin main
git push --tags

# 5. Criar release draft manualmente (sem anexar ZIP ainda)
gh release create "v2026.01.04-rc1" \
  --draft \
  --title "SIRP 2026.01.04-rc1" \
  --notes-file RELEASE_NOTES_TEMPLATE.md

# 6. Anexar artefato ao draft (localmente)
shasum -a 256 dist/sirp-unified-2026.01.04-rc1.zip
gh release upload "v2026.01.04-rc1" dist/sirp-unified-2026.01.04-rc1.zip

# 7. Verificar CI
# - Ir em: https://github.com/LogLine-Foundation/SIRP/actions
# - Workflow "Validate SIRP Bundle" deve validar o tag

🔍 Verificações Pós-Publicação

1. Verificar CI

2. Verificar Release Draft

3. Revisar e Publicar

  • Revisar notas do release
  • Adicionar números de bench/smoke (quando disponíveis)
  • Publicar draft quando pronto

📝 Informações do Release

Tag: v2026.01.04-rc1
Artefato: dist/sirp-unified-2026.01.04-rc1.zip
SHA256: 47871baa48c6c99d92840160fcf193cece245e10634052a4aeb6db87b2abdf60
Tamanho: 313M
Status: Draft (aguardando publicação)

🎯 Proof of Done

Após seguir os passos acima, você deve ver:

  • Tag v2026.01.04-rc1 no repositório
  • Workflow "Validate SIRP Bundle" executou e ficou verde
  • Workflow "Create Release Draft" criou draft (se automação habilitada)
  • Release draft "v2026.01.04-rc1" em Releases
  • Artefato anexado ao draft
  • SHA256 nas notas do release

🔧 Troubleshooting

CI não dispara no tag

  • Verificar .github/workflows/validate.yml tem tags: ['v*']
  • Verificar se tag foi pushado corretamente: git ls-remote --tags origin

Release draft não foi criado automaticamente

  • Verificar se workflow .github/workflows/release-draft.yml existe
  • Verificar Actions para erros
  • Criar manualmente com gh release create

Erro de permissão no push

  • Verificar se tem acesso ao repositório
  • Verificar autenticação: gh auth status