# docker buildx debug build

**Descripción:** Inicia una construcción

**Uso:** `docker buildx debug build [OPTIONS] PATH | URL | -`

**Alias:** `docker build`, `docker builder build`, `docker image build`, `docker buildx b`



> [!NOTE]

> **Experimental**
>
> Este comando es experimental. Las funciones experimentales están destinadas a pruebas y comentarios, ya que su funcionalidad o diseño pueden cambiar entre versiones sin previo aviso o eliminarse por completo en una versión futura.
> 




## Descripción

Inicia una construcción


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--add-host` |  |  Añade un mapeo personalizado de host a IP (formato: `host:ip`) |

 | `--allow` |  |  Permite concesiones de privilegios adicionales (por ejemplo, `network.host`, `security.insecure`, `device`)<br> |

 | `--annotation` |  |  Añade una anotación a la imagen |

 | `--attest` |  |  Parámetros de atestación (formato: `type=sbom,generator=image`) |

 | `--build-arg` |  |  Establece variables en tiempo de construcción |

 | `--build-context` |  |  Contextos de construcción adicionales (por ejemplo, name=path) |

 | `--cache-from` |  |  Fuentes de caché externas (por ejemplo, `user/app:cache`, `type=local,src=ruta/al/directorio`)<br> |

 | `--cache-to` |  |  Destinos de exportación de caché (por ejemplo, `user/app:cache`, `type=local,dest=ruta/al/directorio`)<br> |

 | `--call` | `build` |  Establece el método para evaluar la construcción (`check`, `outline`, `targets`) |

 | `--cgroup-parent` |  |  Establece el cgroup primario para las instrucciones `RUN` durante la construcción |

 | `--check` |  |  Atajo para `--call=check` |

 | `-f`, `--file` |  |  Nombre del Dockerfile (predeterminado: `PATH/Dockerfile`) |

 | `--iidfile` |  |  Escribe el ID de la imagen en un archivo |

 | `--label` |  |  Establece los metadatos de una imagen |

 | `--load` |  |  Atajo para `--output=type=docker` |

 | `--metadata-file` |  |  Escribe los metadatos del resultado de la construcción en un archivo |

 | `--network` |  |  Establece el modo de red para las instrucciones `RUN` durante la construcción |

 | `--no-cache` |  |  No utiliza la caché al construir la imagen |

 | `--no-cache-filter` |  |  No almacena en caché las etapas especificadas |

 | `-o`, `--output` |  |  Destino de salida (formato: `type=local,dest=ruta`) |

 | `--platform` |  |  Establece la plataforma de destino para la construcción |

 | `--policy` |  |  Configuración de política (formato: `filename=ruta[,filename=ruta][,reset=true|false][,disabled=true|false][,strict=true|false][,log-level=nivel]`)<br> |

 | `--progress` | `auto` |  Establece el tipo de salida de progreso (`auto`, `none`, `plain`, `quiet`, `rawjson`, `tty`). Usa plain para mostrar la salida del contenedor<br> |

 | `--provenance` |  |  Atajo para `--attest=type=provenance` |

 | `--pull` |  |  Intenta siempre descargar (pull) todas las imágenes referenciadas |

 | `--push` |  |  Atajo para `--output=type=registry,unpack=false` |

 | `-q`, `--quiet` |  |  Suprime la salida de la construcción e imprime el ID de la imagen si tiene éxito |

 | `--sbom` |  |  Atajo para `--attest=type=sbom` |

 | `--secret` |  |  Secreto a exponer en la construcción (formato: `id=mysecret[,src=/local/secret]`)<br> |

 | `--shm-size` |  |  Tamaño de la memoria compartida para los contenedores de construcción |

 | `--ssh` |  |  Socket o claves del agente SSH a exponer en la construcción (formato: `default|<id>[=<socket>|<clave>[,<clave>]]`)<br> |

 | `-t`, `--tag` |  |  Identificador de imagen (formato: `[registry/]repository[:tag]`) |

 | `--target` |  |  Establece la etapa de construcción de destino a construir |

 | `--ulimit` |  |  Opciones de ulimit |