Resumen de aspectos destacados de Git y GitHub

Cada viñeta destacada de las 9 páginas de esta sección, recopilada en una sola página y agrupada por la página de la que proviene.

Git para equipos de Go

• Las etiquetas de Git en su rama predeterminada se convierten en lanzamientos semver para go get
• Los hashes de commit generan pseudoversiones cuando no existen etiquetas de Git
• Los cambios olvidados en go.sum o las etiquetas de Git incorrectas interrumpen las compilaciones posteriores
• Los cherry-picks y los rebase cambian los hashes de commit, lo que afecta a las pseudoversiones
• Firme las etiquetas de Git para verificar la integridad del lanzamiento antes de que el proxy de módulos las almacene en caché
• Utilice retract en go.mod para evitar etiquetas de Git incorrectas sin reescribir el historial

Conceptos básicos de Git para proyectos de Go

• La URL de clonación coincide con la resolución de go get; verifique con go test inmediatamente
• Las diferencias de go.mod y go.sum revelan cambios en las dependencias; haga commit con los cambios de código
• Utilice nombres de rama cortos con un solo cambio lógico; haga rebase con frecuencia para evitar conflictos
• Haga commit de _test.go con código; evite hacer commit de binarios o perfiles de prueba
• go mod tidy elimina los require no utilizados y agrega los indirectos faltantes; la CI debe validar
• Utilice --ff-only al extraer main; vuelva a ejecutar go mod tidy después de resolver go.sum

Estrategias de ramificación y flujo basado en tronco

• Mantenga main siempre listo para lanzar con ramas de características de corta duración fusionadas con frecuencia
• Ejecute go test, go vet y go mod tidy en cada push para detectar problemas antes de la fusión
• Haga rebase de las ramas de características sobre main antes de fusionar para detectar conflictos tempranamente
• Divida las ramas de características en PR más pequeños para evitar conflictos de go.sum y archivos generados
• Restrinja el force-push solo a las ramas personales para evitar romper los PR abiertos
• Reserve ramas de lanzamiento de larga duración solo para backports de versiones principales admitidas

Rebase, Cherry-Pick y Worktrees

• Rebase reescribe SHAs, cambiando las pseudoversiones de los módulos de Go para los commits sin etiquetar
• Cherry-pick copia commits individuales para backports limpios en lugar del historial completo de merge
• Los worktrees permiten ejecuciones paralelas de go test en diferentes ramas desde un solo repositorio
• Utilice git push --force-with-lease para evitar sobrescribir silenciosamente el trabajo de los compañeros de equipo
• Coordine los rebase en ramas compartidas, haga rebase libremente solo en características personales

GitHub Actions para repositorios de Go

• GitHub Actions ejecuta go test, lint y verificaciones de módulos en cada push y PR
• Alinee la CI con el nivel mínimo de la cadena de herramientas del módulo usando go-version-file en lugar de codificarlo
• Almacene en caché los archivos go.sum anidados en repositorios mult Módulo para acelerar las descargas de módulos
• Los trabajos de lint separados se ejecutan en paralelo con las pruebas sin bloquear el inicio de las pruebas
• Los pushes de etiquetas activan trabajos de lanzamiento utilizando goreleaser después de que las pruebas pasen
• Para módulos privados, configure GOPRIVATE y configure git con un token PAT con ámbito

Revisión de código con PR de GitHub

• Mantenga las solicitudes de extracción por debajo de 400 líneas; divida por paquete o indicador de función para evitar detener el tronco
• Revise los cambios en la API exportada y las actualizaciones de versión de go.mod para evaluar el impacto de compatibilidad en los consumidores del módulo
• Verifique el envoltorio de errores con %w, el ciclo de vida de goroutines, la cancelación de contexto y las carreras de datos
• Requiera pruebas basadas en tablas que cubran las rutas de error con el indicador -race antes de aprobar
• Examine rápidamente las funciones exportadas no probadas en las diferencias para evitar aprobar sin revisar las CI verdes
• Inspeccione los cambios masivos de go.sum para detectar intercambios de cadena de suministro o adiciones de peso transitivo

Etiquetas firmadas y lanzamientos de módulos de Go

• Etiquete los lanzamientos con semver (v1.2.3) en su rama predeterminada para controlar las versiones de los módulos de Go
• Firme las etiquetas con git tag -s para verificar la autenticidad e integridad del lanzamiento
• Los aumentos de versión principal requieren la ruta /v2 en las importaciones de módulos y etiquetas v2.0.0 coincidentes
• El versionado semántico de importaciones mantiene v0/v1 en example.com/lib pero v2+ en example.com/lib/v2
• Retracte los lanzamientos incorrectos en go.mod para advertir a los consumidores sin eliminar el historial
• Las etiquetas firmadas autentican las referencias de VCS, no los archivos; go.sum y sumdb manejan el hash de contenido

Patrones de Git de Monorepo con go work

• Utilice go.work localmente para reemplazar las directivas replace entre módulos en los archivos go.mod confirmados
• GOWORK=off simula la experiencia de los consumidores de módulos
• Evite replace en go.mod para rutas locales, ya que interrumpe go get para usuarios externos
• Etiquete y ejecute CI para cada módulo explícitamente para que los proxies y los consumidores resuelvan las versiones correctas
• Una sola etiqueta para módulos no relacionados significa que los consumidores no pueden fijarlos de forma independiente
• Confirme go.work cuando todo el equipo comparta la disposición del espacio de trabajo

Mejores prácticas de Git y GitHub

• Nunca fusione en trunk sin que la CI verifique go test y tidy
• Mantenga main listo para lanzar pasando las pruebas y las verificaciones de module tidy
• Utilice ramas de características de corta duración para minimizar los conflictos de go.sum
• Confirme go.mod y go.sum juntos con los cambios de código de dependencia
• Envíe etiquetas explícitamente con git push origin v1.2.3 no por defecto
• Utilice rutas de importación /v2 al realizar cambios incompatibles en la API

3730363230327c3030356f6967637c6f692e73656469756765646f63