---
name: docker_volume_create
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func DockerVolumeCreate(name string) (string, error)"
description: "Crea un volume Docker con el nombre dado. Retorna el nombre del volume creado tal como lo confirma Docker."
tags: [docker, volume, create, infra, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [fmt, os/exec, strings]
params:
  - name: name
    desc: "nombre del volume Docker a crear"
output: "nombre del volume creado confirmado por Docker"
tested: true
tests: ["crea volume y retorna nombre", "idempotente si el volume ya existe"]
test_file_path: "functions/infra/docker_volume_create_test.go"
file_path: "functions/infra/docker_volume_create.go"
---

## Ejemplo

```go
volumeName, err := DockerVolumeCreate("postgres_data")
if err != nil {
    log.Fatal(err)
}
fmt.Println("Created volume:", volumeName)
// Created volume: postgres_data
```

## Notas

Ejecuta `docker volume create name`. Docker imprime el nombre del volume creado en stdout. Idempotente si el volume ya existe con el mismo nombre.
