fn_registry/functions/infra/go_build_binary.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
go_build_binary	function	go	infra	1.0.0	impure	func GoBuildBinary(projectDir, outputPath string, ldflags string, tags string) error	Compila un binario Go desde un directorio de proyecto. Si ldflags está vacío usa -s -w (strip debug). Si outputPath está vacío usa build/{dirname} dentro del projectDir. Ejecuta con CGO_ENABLED=0.	go build binary compile infra deploy pendiente-usar				false	error_go_core	fmt os os/exec path/filepath strings	name desc projectDir ruta del directorio Go (con main.go o go.mod) name desc outputPath ruta donde guardar el binario o vacio para usar build/{dirname} name desc ldflags flags de vinculacion Go o vacio para usar -s -w (strip) name desc tags build tags Go (ej: fts5,cgo)	nil si la compilacion fue exitosa, error en caso contrario	true	compila proyecto valido sin error outputPath vacio usa build/dirname por defecto ldflags vacio usa -s -w por defecto error si projectDir no existe	functions/infra/go_build_binary_test.go	functions/infra/go_build_binary.go

Ejemplo

// Compilar con opciones por defecto
err := GoBuildBinary("/home/user/apps/myapp", "", "", "")
// genera /home/user/apps/myapp/build/myapp

// Compilar con output y tags explícitos
err = GoBuildBinary("/home/user/apps/myapp", "/tmp/myapp-bin", "-s -w -X main.version=1.0", "fts5")
if err != nil {
    log.Fatal(err)
}

Notas

Usa CGO_ENABLED=0 para binarios estáticos compatibles con imágenes alpine. El flag -trimpath elimina rutas absolutas del binario para reproducibilidad. Los flags -s -w reducen el tamaño eliminando información de debug y la tabla de símbolos. Compatible con el flujo deploy_app que genera Dockerfile multi-stage.