fn_registry/functions/infra/deploy_app.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
deploy_app	pipeline	go	infra	1.0.0	impure	func DeployApp(appDir string, imageName string, port int, envVars map[string]string) (string, error)	Orquesta el deploy completo de una app Go en Docker. Pasos: genera Dockerfile, lo escribe a disco, construye la imagen y lanza el contenedor en modo detach con port mapping. Retorna el container ID.	docker deploy go pipeline infra container	generate_dockerfile_go_infra write_dockerfile_go_infra docker_build_image_go_infra docker_run_container_go_infra			false	error_go_core	fmt	name desc appDir ruta del directorio de la app Go (contiene main.go) name desc imageName nombre de la imagen Docker a construir y contenedor a lanzar name desc port puerto a mapear (hostPort == containerPort) name desc envVars mapa de variables de entorno a pasar al contenedor	ID del contenedor Docker lanzado exitosamente	false			functions/infra/deploy_app.go

Ejemplo

containerID, err := DeployApp(
    "/home/user/apps/myapp",
    "myapp",
    8080,
    map[string]string{
        "DB_HOST": "postgres",
        "PORT":    "8080",
    },
)
if err != nil {
    log.Fatal(err)
}
fmt.Println("Contenedor lanzado:", containerID)

Notas

Pipeline de 4 pasos: generate_dockerfile (pura) → write_dockerfile → docker_build_image → docker_run_container. El nombre del contenedor e imagen coinciden con imageName. El port mapping es simetrico (hostPort == containerPort). Si cualquier paso falla, el pipeline retorna error con contexto del paso fallido. No hace rollback automatico — para limpiar usar stop_app.