Lendo Notas de Lançamento Como um Tech Lead

Q: Como as notas de lançamento se relacionam com o govulncheck?

Notas de lançamento anunciam correções; govulncheck informa se caminhos de biblioteca padrão vulneráveis são alcançáveis em seus binários. Execute ambos durante a semana de atualização.

Q: Quais âncoras devo linkar nos tickets?

Âncoras https://go.dev/doc/go1.N#section e números de issue das notas. Evite linkar apenas posts de blog; as notas são canônicas.

Notas de lançamento são o registro de risco de atualização para o Go.

Esta cheatsheet transforma um documento de 30 páginas do Go 1.x em decisões que sua equipe pode agendar, testar e reverter.

Como Usar Esta Cheatsheet

Percorra de cima para baixo uma vez por versão menor de destino antes de escrever o ADR de atualização
Atribua um responsável por seção (runtime, crypto, ferramentas) quando vários serviços forem atualizados
Copie os itens marcados para Jira/Linear com links para âncoras de go.dev/doc/go1.N
Revise as notas de lançamento de patches mensalmente, mesmo ao pular versões menores

Mapa das Seções das Notas de Lançamento

Seção	O que extrair	Ação do SME
Introdução	Plataformas suportadas removidas	Atualize imagens base e runners de CI
Linguagem	Nova sintaxe, regras mais rígidas	Planeje o aumento da diretiva `go`
Ferramentas (`go` command)	Alterações em `go fix`, `go mod`, vet	Atualize scripts de CI
Runtime / GC	Coletor, scheduler, experimentos	Faça canary de p99 e CPU do GC
Compilador / Linker	Alocação de pilha, layout de seção	Reteste de `cgo`/ferramentas de análise estática
Biblioteca padrão	Comportamento que quebra compatibilidade, deprecações	Procure no codebase por pacotes afetados
Ports	Remoção de SO/arquitetura	Remova alvos de build EOL

Decisões de Linguagem e go.mod

Versão efetiva do Go: Observe novos recursos controlados pela diretiva go (por exemplo, new(expr) em 1.26).
Tags de build: Verifique as necessidades de //go:build go1.N para arquivos que ainda não estão prontos para serem atualizados em todo o módulo.
Verificação de tipo mais rígida: Mudanças em literais compostos e restrições genéricas podem falhar no CI sem alterações de runtime.
Política de atraso de biblioteca: Decida se as libs/* compartilhadas permanecerão uma versão menor atrás das services/*.
Mapeamento do Modernizer: Liste quais analisadores de go fix se aplicam (go tool fix help).

Checklist de Runtime e GC

Mudança padrão do GC: Go 1.26 habilita o Green Tea GC; espere um perfil de CPU do GC diferente.
Opt-outs de GOEXPERIMENT: Registre o comando de rollback nogreenteagc; observe o cronograma de remoção (1.27).
Sobrecarga de cgo: 1.26 reduz a linha de base da chamada cgo em ~30%; revise os serviços com CGO_ENABLED=1.
Segurança do Heap: Base do heap aleatória em 64 bits; observe se ferramentas externas analisam core dumps.
Perfil de vazamento de Goroutine: GOEXPERIMENT=goroutineleakprofile opcional para experimentos em staging.
runtime/metrics: Novas métricas do scheduler em /sched/* para dashboards.

Checklist de Ferramentas e CI

Reescrita de go fix: Trate como etapa obrigatória; execute duas vezes em monorepos.
Adições de go vet: Novos analisadores falham no CI mesmo quando o código compilou na toolchain antiga.
Padrão go mod init: Novos módulos podem ter go padrão para N-1; alinhe explicitamente com a política da organização.
Comandos removidos: por exemplo, go tool doc removido em 1.26; corrija docs e scripts.
Requisito de Bootstrap: Construir Go 1.26 requer Go 1.24.6+; atualize as imagens de engenharia de release.
Padrão da UI do pprof: O padrão do gráfico de chama pode mudar os fluxos de trabalho do operador, não o comportamento do aplicativo.

Crypto, net/http e Segurança

Item	Exemplo 1.26	Teste
Padrões TLS	KEX híbrido PQ ativado por padrão	Suite de handshake de cliente legado
crypto/rand	Ignora leitores `rand` personalizados	Testes determinísticos usam `cryptotest`
url.Parse	Regras de dois pontos mais rígidas no host	URLs de configuração com hosts incomuns
ReverseProxy	`Director` depreciado em favor de `Rewrite`	Audite o código do gateway
Redirecionamentos de mux http	307 em vez de 301 para barra final	Caminhos sensíveis a cache e SEO

Comandos de Busca na Biblioteca Padrão

# Pacotes que você usa que aparecem nas notas de lançamento - exemplo de grep
rg -l 'net/http/httputil|crypto/tls|encoding/json' --glob '*.go'
 
# Símbolos depreciados mencionados nas notas
rg 'ReverseProxy\.Director|interface\{\}' --glob '*.go'
 
# GODEBUG no repositório
rg 'GODEBUG' --glob '*.{go,sh,yml,env*}'

Tabela de Portões de Atualização

Portão	Critérios de aprovação	Responsável
G0 Leitura	Rascunho do ADR com seções marcadas	Tech lead
G1 Build	`go test -race ./...` em todos os módulos	Equipes de serviço
G2 Modernização	`go fix` commitado, `go vet` limpo	Plataforma
G3 Staging	24h de observação, GC e p99 dentro do orçamento	SRE
G4 Canary	5-10% do tráfego, orçamento de erro verde	SRE + lead
G5 Promoção	Remover substituições temporárias de GOEXPERIMENT	Tech lead

Rastreador de GODEBUG e Deprecação (Modelo)

Chave GODEBUG	Padrão em 1.26	Alvo de remoção
`tls10server`	off (mínimo TLS 1.2)	Go 1.27
`urlstrictcolons`	on	rollback com `=0`
`gotypesalias`	Alias de tipos sempre	Go 1.27
`cryptocustomrand`	off	restauração temporária com `=1`

Cartão de Rollback (Preencher Antes do Canary)

# Reverter tag da imagem
kubectl set image deploy/api api=api:go1.25.6
 
# Rollback apenas de GC (mesmo binário Go 1.26)
GOEXPERIMENT=nogreenteagc ./api
 
# Rollback de linguagem (requer reconstrução)
# go.mod: go 1.25.0 && go mod tidy && reconstruir

FAQs

Quanto tempo deve levar a leitura das notas de lançamento?

60-90 minutos para uma versão menor se você for responsável por vários serviços.

Leia a introdução e as portas primeiro, depois leia profundamente runtime, crypto e os pacotes que você importa.

As notas de patch exigem o mesmo processo?

Leia as notas de patch para CVEs de segurança e correções críticas de runtime.

O checklist completo é geralmente apenas para versões menores, a menos que o patch mencione seus pacotes.

E se não tivermos cgo?

Ainda leia as seções de runtime/GC e crypto/TLS.

Serviços com CGO_ENABLED=0 continuam afetados pelo GC e pelos padrões de crypto/tls.

Quem deve ser o responsável pelo PR do go fix?

Plataforma ou um campeão de atualização rotativo.

Divida por analisador em repositórios grandes para manter a carga de revisão gerenciável.

Como as notas de lançamento se relacionam com o govulncheck?

Notas de lançamento anunciam correções; govulncheck informa se caminhos de biblioteca padrão vulneráveis são alcançáveis em seus binários.

Execute ambos durante a semana de atualização.

Devemos atualizar apenas pelo Green Tea GC?

Frequentemente sim para serviços com uso intensivo de CPU, após validação em canary.

É uma mudança de performance, não uma razão para pular testes funcionais.

Quais âncoras devo linkar nos tickets?

Âncoras https://go.dev/doc/go1.N#section e números de issue das notas.

Evite linkar apenas posts de blog; as notas são canônicas.

Como rastrear propostas ainda abertas?

Verifique itens interessantes das notas em relação ao status do go.dev/issue.

Propostas rejeitadas explicam recursos que não chegarão em breve.

Quando é razoável pular uma versão menor?

Quando os patches de segurança são backportados e as mudanças de runtime não afetam seu perfil.

Documente a dívida aceita no ADR com data de revisão.

A leitura das notas substitui o benchmarking?

Não.

As notas dizem o que medir; canaries provam isso para suas cargas de trabalho.

Relacionados

Destaques do Go 1.26 - mergulho profundo na versão menor atual
Planejando Atualizações de Versão do Go em um Monorepo - playbook de execução
A Promessa de Compatibilidade do Go 1 em Prática - o que as notas não quebrarão
Noções Básicas de Lançamentos do Go - guia de comandos
Melhores Práticas de Histórico e Lançamentos do Go - hábitos de equipe

Links Externos Relacionados

Go Blog (Oficial) - Anúncios oficiais, mergulhos profundos e notas de lançamento.
Site Oficial / Documentação do Go - Hub principal de documentação.
r/golang (Reddit) - Discussões da comunidade, notícias e ajuda.
Learning Go (2nd Edition) - Jon Bodner.
The Go Programming Language (ebook) - Donovan & Kernighan.

Versões de Stack: Esta página foi escrita para Go 1.26.x (padrão Green Tea GC, modernizadores go fix - verifique o patch na compilação), chi (última versão - verifique na compilação), gin (última versão - verifique na compilação), echo (última versão - verifique na compilação), google.golang.org/grpc (última versão - verifique na compilação), sigs.k8s.io/controller-runtime (última versão - verifique na compilação), kubebuilder (última versão - verifique na compilação), tinygo (última versão - verifique os alvos de placa na compilação), wazero (última versão - verifique na compilação) e golangci-lint (última versão - verifique o conjunto de linters na compilação).

Esta cheatsheet transforma um documento de 30 páginas do Go 1.x em decisões que sua equipe pode agendar, testar e reverter.

Como Usar Esta Cheatsheet

Percorra de cima para baixo uma vez por versão menor de destino antes de escrever o ADR de atualização
Atribua um responsável por seção (runtime, crypto, ferramentas) quando vários serviços forem atualizados
Copie os itens marcados para Jira/Linear com links para âncoras de go.dev/doc/go1.N
Revise as notas de lançamento de patches mensalmente, mesmo ao pular versões menores

Mapa das Seções das Notas de Lançamento

Seção	O que extrair	Ação do SME
Introdução	Plataformas suportadas removidas	Atualize imagens base e runners de CI
Linguagem	Nova sintaxe, regras mais rígidas	Planeje o aumento da diretiva `go`
Ferramentas (`go` command)	Alterações em `go fix`, `go mod`, vet	Atualize scripts de CI
Runtime / GC	Coletor, scheduler, experimentos	Faça canary de p99 e CPU do GC
Compilador / Linker	Alocação de pilha, layout de seção	Reteste de `cgo`/ferramentas de análise estática
Biblioteca padrão	Comportamento que quebra compatibilidade, deprecações	Procure no codebase por pacotes afetados
Ports	Remoção de SO/arquitetura	Remova alvos de build EOL

Decisões de Linguagem e go.mod

Versão efetiva do Go: Observe novos recursos controlados pela diretiva go (por exemplo, new(expr) em 1.26).
Tags de build: Verifique as necessidades de //go:build go1.N para arquivos que ainda não estão prontos para serem atualizados em todo o módulo.
Verificação de tipo mais rígida: Mudanças em literais compostos e restrições genéricas podem falhar no CI sem alterações de runtime.
Política de atraso de biblioteca: Decida se as libs/* compartilhadas permanecerão uma versão menor atrás das services/*.
Mapeamento do Modernizer: Liste quais analisadores de go fix se aplicam (go tool fix help).

Checklist de Runtime e GC

Mudança padrão do GC: Go 1.26 habilita o Green Tea GC; espere um perfil de CPU do GC diferente.
Opt-outs de GOEXPERIMENT: Registre o comando de rollback nogreenteagc; observe o cronograma de remoção (1.27).
Sobrecarga de cgo: 1.26 reduz a linha de base da chamada cgo em ~30%; revise os serviços com CGO_ENABLED=1.
Segurança do Heap: Base do heap aleatória em 64 bits; observe se ferramentas externas analisam core dumps.
Perfil de vazamento de Goroutine: GOEXPERIMENT=goroutineleakprofile opcional para experimentos em staging.
runtime/metrics: Novas métricas do scheduler em /sched/* para dashboards.

Checklist de Ferramentas e CI

Reescrita de go fix: Trate como etapa obrigatória; execute duas vezes em monorepos.
Adições de go vet: Novos analisadores falham no CI mesmo quando o código compilou na toolchain antiga.
Padrão go mod init: Novos módulos podem ter go padrão para N-1; alinhe explicitamente com a política da organização.
Comandos removidos: por exemplo, go tool doc removido em 1.26; corrija docs e scripts.
Requisito de Bootstrap: Construir Go 1.26 requer Go 1.24.6+; atualize as imagens de engenharia de release.
Padrão da UI do pprof: O padrão do gráfico de chama pode mudar os fluxos de trabalho do operador, não o comportamento do aplicativo.

Crypto, net/http e Segurança

Item	Exemplo 1.26	Teste
Padrões TLS	KEX híbrido PQ ativado por padrão	Suite de handshake de cliente legado
crypto/rand	Ignora leitores `rand` personalizados	Testes determinísticos usam `cryptotest`
url.Parse	Regras de dois pontos mais rígidas no host	URLs de configuração com hosts incomuns
ReverseProxy	`Director` depreciado em favor de `Rewrite`	Audite o código do gateway
Redirecionamentos de mux http	307 em vez de 301 para barra final	Caminhos sensíveis a cache e SEO

Comandos de Busca na Biblioteca Padrão

# Pacotes que você usa que aparecem nas notas de lançamento - exemplo de grep
rg -l 'net/http/httputil|crypto/tls|encoding/json' --glob '*.go'
 
# Símbolos depreciados mencionados nas notas
rg 'ReverseProxy\.Director|interface\{\}' --glob '*.go'
 
# GODEBUG no repositório
rg 'GODEBUG' --glob '*.{go,sh,yml,env*}'

Tabela de Portões de Atualização

Portão	Critérios de aprovação	Responsável
G0 Leitura	Rascunho do ADR com seções marcadas	Tech lead
G1 Build	`go test -race ./...` em todos os módulos	Equipes de serviço
G2 Modernização	`go fix` commitado, `go vet` limpo	Plataforma
G3 Staging	24h de observação, GC e p99 dentro do orçamento	SRE
G4 Canary	5-10% do tráfego, orçamento de erro verde	SRE + lead
G5 Promoção	Remover substituições temporárias de GOEXPERIMENT	Tech lead

Rastreador de GODEBUG e Deprecação (Modelo)

Chave GODEBUG	Padrão em 1.26	Alvo de remoção
`tls10server`	off (mínimo TLS 1.2)	Go 1.27
`urlstrictcolons`	on	rollback com `=0`
`gotypesalias`	Alias de tipos sempre	Go 1.27
`cryptocustomrand`	off	restauração temporária com `=1`

Cartão de Rollback (Preencher Antes do Canary)

# Reverter tag da imagem
kubectl set image deploy/api api=api:go1.25.6
 
# Rollback apenas de GC (mesmo binário Go 1.26)
GOEXPERIMENT=nogreenteagc ./api
 
# Rollback de linguagem (requer reconstrução)
# go.mod: go 1.25.0 && go mod tidy && reconstruir

FAQs

Quanto tempo deve levar a leitura das notas de lançamento?

60-90 minutos para uma versão menor se você for responsável por vários serviços.

Leia a introdução e as portas primeiro, depois leia profundamente runtime, crypto e os pacotes que você importa.

As notas de patch exigem o mesmo processo?

Leia as notas de patch para CVEs de segurança e correções críticas de runtime.

O checklist completo é geralmente apenas para versões menores, a menos que o patch mencione seus pacotes.

E se não tivermos cgo?

Ainda leia as seções de runtime/GC e crypto/TLS.

Serviços com CGO_ENABLED=0 continuam afetados pelo GC e pelos padrões de crypto/tls.

Quem deve ser o responsável pelo PR do go fix?

Plataforma ou um campeão de atualização rotativo.

Divida por analisador em repositórios grandes para manter a carga de revisão gerenciável.

Como as notas de lançamento se relacionam com o govulncheck?

Notas de lançamento anunciam correções; govulncheck informa se caminhos de biblioteca padrão vulneráveis são alcançáveis em seus binários.

Execute ambos durante a semana de atualização.

Devemos atualizar apenas pelo Green Tea GC?

Frequentemente sim para serviços com uso intensivo de CPU, após validação em canary.

É uma mudança de performance, não uma razão para pular testes funcionais.

Quais âncoras devo linkar nos tickets?

Âncoras https://go.dev/doc/go1.N#section e números de issue das notas.

Evite linkar apenas posts de blog; as notas são canônicas.

Como rastrear propostas ainda abertas?

Verifique itens interessantes das notas em relação ao status do go.dev/issue.

Propostas rejeitadas explicam recursos que não chegarão em breve.

Quando é razoável pular uma versão menor?

Quando os patches de segurança são backportados e as mudanças de runtime não afetam seu perfil.

Documente a dívida aceita no ADR com data de revisão.

A leitura das notas substitui o benchmarking?

Não.

As notas dizem o que medir; canaries provam isso para suas cargas de trabalho.

Relacionados

Destaques do Go 1.26 - mergulho profundo na versão menor atual
Planejando Atualizações de Versão do Go em um Monorepo - playbook de execução
A Promessa de Compatibilidade do Go 1 em Prática - o que as notas não quebrarão
Noções Básicas de Lançamentos do Go - guia de comandos
Melhores Práticas de Histórico e Lançamentos do Go - hábitos de equipe

Links Externos Relacionados

Go Blog (Oficial) - Anúncios oficiais, mergulhos profundos e notas de lançamento.
Site Oficial / Documentação do Go - Hub principal de documentação.
r/golang (Reddit) - Discussões da comunidade, notícias e ajuda.
Learning Go (2nd Edition) - Jon Bodner.
The Go Programming Language (ebook) - Donovan & Kernighan.

Versões de Stack: Esta página foi escrita para Go 1.26.x (padrão Green Tea GC, modernizadores go fix - verifique o patch na compilação), chi (última versão - verifique na compilação), gin (última versão - verifique na compilação), echo (última versão - verifique na compilação), google.golang.org/grpc (última versão - verifique na compilação), sigs.k8s.io/controller-runtime (última versão - verifique na compilação), kubebuilder (última versão - verifique na compilação), tinygo (última versão - verifique os alvos de placa na compilação), wazero (última versão - verifique na compilação) e golangci-lint (última versão - verifique o conjunto de linters na compilação).

Lendo Notas de Lançamento Como um Tech Lead

Buscar na documentação

Lendo Notas de Lançamento Como um Tech Lead