---
name: stop_app
kind: pipeline
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func StopApp(containerName string, removeImage bool) error"
description: "Para y elimina el contenedor de una app desplegada. Si removeImage es true elimina también la imagen Docker. containerName debe coincidir con el imageName usado en deploy_app."
tags: [docker, stop, remove, deploy, pipeline, infra, container, pendiente-usar]
uses_functions: [docker_stop_container_go_infra, docker_remove_container_go_infra, docker_remove_image_go_infra]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [fmt]
params:
  - name: containerName
    desc: "nombre del contenedor Docker a detener (coincide con imageName de deploy_app)"
  - name: removeImage
    desc: "si true elimina tambien la imagen Docker"
output: "nil si la app se detuvo exitosamente, error en caso contrario"
tested: false
tests: []
test_file_path: ""
file_path: "functions/infra/stop_app.go"
---

## Ejemplo

```go
// Parar contenedor sin eliminar la imagen (para relanzar rapido)
err := StopApp("myapp", false)

// Parar y limpiar todo
err = StopApp("myapp", true)
if err != nil {
    log.Fatal(err)
}
```

## Notas

Inverso de deploy_app. El contenedor se detiene con 10 segundos de gracia antes de SIGKILL. La imagen se busca como containerName:latest (convencion de deploy_app). Si solo se quiere parar sin limpiar, usar removeImage=false para conservar la imagen en cache local y acelerar el siguiente deploy.
