Busque em todas as páginas da documentação
Lançamentos internos da plataforma Go (módulos compartilhados, atualizações da toolchain Go, linhas de base de linters) falham quando os proprietários de serviços descobrem mudanças que quebram compatibilidade a partir de builds vermelhos de CI na segunda-feira de manhã.
Boas notas de lançamento devem ser como um lançamento de produto para engenheiros: o que mudou, quem deve agir, até quando e como obter ajuda.
Publique as notas antes que a mudança afete a CI padrão.
Comece com a data de vigência e as ações necessárias.
Documente mudanças de API que quebram compatibilidade com snippets de antes/depois.
Liste os comandos de verificação (go test, go fix, govulncheck).
Forneça horários de atendimento ou um canal Slack com proprietários nomeados.
Arquive as notas no repositório para auditoria e onboarding.
Esqueleto de nota de lançamento para um bump de versão principal de um módulo compartilhado.
# Release: github.com/acme/platform/auth/v3
**Versão:** v3.2.0
**Efetivo:** 2026-08-15 (CI impõe em `main`)
**Proprietário:** @platform-auth
## Ação necessária
1. Atualize `require github.com/acme/platform/auth/v3 v3.2.0`
2. Substitua `Verify(token)` por `Verify(ctx, token)`
3. Execute `go test ./...` e `golangci-lint run`
## Mudanças que quebram compatibilidade
- `AuthClient.Verify` agora requer `context.Context` (propagação de deadline)
## Migração
```go
// antes
ok, err := client.Verify(token)
// depois
ok, err := client.Verify(ctx, token)
**Quando usar isso:**
- Módulo interno compartilhado principal ou secundário com quebras de API
- Atualizações da toolchain Go em toda a organização
- Mudanças de configuração do `golangci-lint` que falham na CI
- Novos interceptadores ou middleware de autenticação obrigatórios
## Exemplo de Trabalho
Nota interna completa para upgrade do monorepo Go 1.26 + publicação de bibliotecas.
```markdown
# Lançamento da Plataforma: Toolchain Go 1.26 + libs/common/v2
**Efetivo:** 2026-09-01
**Portão de CI:** PRs devem passar em `go1.26.x` após 25 de agosto
**Proprietários:** @platform-toolchain, @platform-common
## Resumo
Todos os serviços devem compilar com Go 1.26.x. `libs/common/v2` adiciona helpers de logging estruturado; v1 depreciado.
## Ação necessária (cada equipe de serviço)
| Etapa | Comando / tarefa | Prazo |
|------|----------------|-----|
| Atualizar devcontainer / Go local | `go version` → 1.26.x | 20 de agosto |
| Atualizar diretiva de módulo | `go get go@1.26.0 && go mod tidy` | 25 de agosto |
| Modernizar | `go fix ./...` (executar duas vezes) | 25 de agosto |
| Atualizar biblioteca comum | `go get github.com/acme/libs/common/v2@v2.0.0` | 1 de setembro |
| Canary | Implantar 10% e monitorar p99 + CPU GC por 48h | 3 de setembro |
## Quebra: libs/common/v2
- Wrappers `log.Printf` removidos; use helpers `slog` em `common/slogx`
- Caminho de importação: `github.com/acme/libs/common/v2/slogx`
```go
// migração
import "github.com/acme/libs/common/v2/slogx"
slogx.Info(ctx, "invoice exported", "invoice_id", id)
go_gc_duration_seconds durante o canaryGOEXPERIMENT=nogreenteagc documentado no runbook (link)go test -race ./...
go vet ./...
govulncheck ./...P: Podemos ficar no 1.24 até o Q4? R: Não - a política de segurança exige 1.26.1 até 15 de setembro.
#go-platform | Horário de atendimento Quarta-feira 15:00 UTC | Runbook: docs/platform/go-1.26.md
**O que isso demonstra:**
- Data de vigência separada da data de imposição da CI
- Ações tabulares com prazos para acompanhamento do programa
- Mudanças que quebram compatibilidade incluem caminho de importação e snippet
- Notas de runtime conectam-se a partes interessadas de observabilidade que se importam
- Exceções de política respondidas diretamente no FAQ
## Mergulho Profundo
### Como Funciona
**Seções de notas de lançamento**
| Seção | Propósito |
| --- | --- |
| Cabeçalho | Versão, data de vigência, proprietários |
| Ação necessária | Passos numerados com prazos |
| Mudanças que quebram compatibilidade | API, comportamento, CI |
| Migração | Snippets de copiar e colar |
| Verificação | Comandos que espelham a CI |
| Suporte | Canal, horários, link do runbook |
**Camadas de público**
| Público | O que eles leem |
| --- | --- |
| Líder de serviço | Tabela de ações + prazos |
| IC atualizando | Snippets de migração + verificação |
| SRE | Notas de runtime, canary, rollback |
| PM | FAQ sobre impacto na programação |
**Checklist de distribuição**
1. Publique na newsletter de engenharia.
2. Fixe em `#go-platform` com @here na semana de vigência.
3. Abra o template de ticket de CI pré-preenchido com os passos.
4. Adicione uma entrada ao repositório de changelog da plataforma.
5. Apresente 5 minutos na reunião geral de engenharia para quebras importantes.
### Notas Go
```bash
# Entrada do Changelog no repositório docs/platform/CHANGELOG.md
## 2026-09-01 - Go 1.26 + common/v2
- AÇÃO: todos os módulos em go 1.26.x
- QUEBRA: migração common/v2 slogx
go work sync quando o monorepo usar workspaces.| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Apenas e-mail | Conjunto de consumidores pequeno (<5 equipes) | Toolchain em toda a organização |
| GitHub Release Automatizado | Módulo aberto com muitos usuários externos | Cultura interna mista de Slack |
| Walkthrough Loom | Grande mudança de DX quebradora semelhante a UI | Adição simples de API de uma linha |
| Apenas janela de depreciação | Remoções suaves | Bump imediato forçado por segurança |
Mínimo de duas semanas para mudanças que quebram compatibilidade.
Quatro semanas para saltos na toolchain Go que afetam todos os serviços.
Sim, em uma seção "Destaques" abaixo das ações.
Nunca enterre as ações abaixo do marketing de recursos.
docs/platform/releases/ em um repositório central mais arquivo Slack.
Link de mensagens de falha da CI quando possível.
Imposição da CI com ticket de escape que requer aprovação do EM e remediação datada.
As notas devem indicar o caminho exato de go get e a versão.
Link para regras de semver no apêndice.
A nota deve indicar que a diretiva retract foi adicionada e a versão mínima segura.
CC em lançamentos de toolchain ou conformidade que movem datas de recursos.
Pule atualizações de bibliotecas de patches rotineiras.
Baseado em data (2026-09-01-go-1.26) ou corresponder à tag do módulo.
Mantenha a consistência no índice do changelog.
Sim para mudanças de runtime e CI.
Link para a seção do runbook com GOEXPERIMENT ou passos de fixação de imagem.
Bots criam rascunhos a partir da diferença semver e do resumo de go fix.
Edições humanas para ações, datas e políticas.
Versões de Stack: Esta página foi escrita para Go 1.26.x (GC Green Tea padrão, modernizadores de
go fix- verifique o patch na compilação), chi (última - verifique na compilação), gin (última - verifique na compilação), echo (última - verifique na compilação), google.golang.org/grpc (última - verifique na compilação), sigs.k8s.io/controller-runtime (última - verifique na compilação), kubebuilder (última - verifique na compilação), tinygo (última - verifique os alvos de placa na compilação), wazero (última - verifique na compilação) e golangci-lint (última - verifique o conjunto de linters na compilação).
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026