# Notas de la versión de Docker Engine versión 28
Esta página describe los cambios más recientes, adiciones, problemas conocidos y correcciones para la versión 28 de Docker Engine.
Para obtener más información sobre:
- Características depreciadas y eliminadas, consulta [Características del motor depreciadas](/engine/deprecated/).
- Cambios en la API del motor, consulta el [Historial de versiones de la API del motor](/reference/api/engine/version-history/).
## 28.5.2
2025-11-05
Para obtener una lista completa de las solicitudes de extracción (pull requests) y los cambios en esta versión, consulta los hitos (milestones) correspondientes en GitHub:
- [docker/cli, hito 28.5.2](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.5.2)
- [moby/moby, hito 28.5.2](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.5.2)
> [!CAUTION]
> Esta versión contiene correcciones para tres vulnerabilidades de seguridad de alta gravedad en runc:
> - [CVE-2025-31133](https://github.com/opencontainers/runc/security/advisories/GHSA-9493-h29p-rfm2)
> - [CVE-2025-52565](https://github.com/opencontainers/runc/security/advisories/GHSA-qw9x-cqr3-wc7r)
> - [CVE-2025-52881](https://github.com/opencontainers/runc/security/advisories/GHSA-cgrx-mc8f-2prm)
>
> Las tres vulnerabilidades permiten en última instancia (a través de diferentes métodos) escapes completos del contenedor al eludir las restricciones de runc para escribir en archivos `/proc` arbitrarios.
### Correcciones de errores y mejoras
- dockerd-rootless.sh: si slirp4netns no está instalado, intentar usar pasta (passt). [moby/moby#51162](https://github.com/moby/moby/pull/51162)
### Actualizaciones de empaquetado
- Actualizar BuildKit a [v0.25.2](https://github.com/moby/buildkit/releases/tag/v0.25.2). [moby/moby#51398](https://github.com/moby/moby/pull/51398)
- Actualizar el entorno de ejecución de Go a [1.24.9](https://go.dev/doc/devel/release#go1.24.9). [moby/moby#51387](https://github.com/moby/moby/pull/51387), [docker/cli#6613](https://github.com/docker/cli/pull/6613)
- Actualizar runc a [v1.3.3](https://github.com/opencontainers/runc/releases/tag/v1.3.3). [moby/moby#51394](https://github.com/moby/moby/pull/51394)
### Depreciaciones
- SDK de Go: cli/command/image/build: depreciar `DefaultDockerfileName`, `DetectArchiveReader`, `WriteTempDockerfile`, `ResolveAndValidateContextPath`. Estas utilidades solo se utilizaban internamente y se eliminarán en la próxima versión. [docker/cli#6610](https://github.com/docker/cli/pull/6610)
- SDK de Go: cli/command/image/build: depreciar la utilidad `IsArchive`. [docker/cli#6560](https://github.com/docker/cli/pull/6560)
- SDK de Go: opts: depreciar `ValidateMACAddress`. [docker/cli#6560](https://github.com/docker/cli/pull/6560)
- SDK de Go: opts: depreciar `ListOpts.Delete()`. [docker/cli#6560](https://github.com/docker/cli/pull/6560)
## 28.5.1
2025-10-08
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.5.1](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.5.1)
- [moby/moby, hito 28.5.1](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.5.1)
### Correcciones de errores y mejoras
- Actualizar BuildKit a v0.25.1. [moby/moby#51137](https://github.com/moby/moby/pull/51137)
- Actualizar el entorno de ejecución de Go a [1.24.8](https://go.dev/doc/devel/release#go1.24.8). [moby/moby#51133](https://github.com/moby/moby/pull/51133), [docker/cli#6541](https://github.com/docker/cli/pull/6541)
### Depreciaciones
- api/types/image: InspectResponse: depreciar los campos `Parent` y `DockerVersion`. [moby/moby#51105](https://github.com/moby/moby/pull/51105)
- api/types/plugin: depreciar el campo `Config.DockerVersion`. [moby/moby#51110](https://github.com/moby/moby/pull/51110)
## 28.5.0
2025-10-02
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.5.0](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.5.0)
- [moby/moby, hito 28.5.0](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.5.0)
> [!WARNING]
> **Depreciación de Raspberry Pi OS de 32 bits (armhf)**
>
> Docker Engine v28 será la última versión principal compatible con Raspberry Pi OS de 32 bits (armhf).
> A partir de Docker Engine v29, las nuevas versiones principales **ya no proporcionarán paquetes** para Raspberry Pi OS de 32 bits (armhf).
>
> #### Opciones de migración
> - **ARM de 64 bits:** Instalar los paquetes Debian `arm64` (totalmente soportados).
> - **ARM de 32 bits (v7):** Instalar los paquetes Debian `armhf` (dirigidos a CPUs ARMv7).
>
> **Nota:** Los dispositivos más antiguos basados en la arquitectura ARMv6 ya no son compatibles con los paquetes oficiales, incluyendo:
> - Raspberry Pi 1 (Modelo A/B/A+/B+)
> - Raspberry Pi Zero y Zero W
### Correcciones de errores y mejoras
- No imprimir advertencias en `docker info` por enlaces simbólicos rotos en directorios de plugins de la CLI. [docker/cli#6476](https://github.com/docker/cli/pull/6476)
- Corregir un pánico durante `stats` en un evento con `Actor.ID` vacío. [docker/cli#6471](https://github.com/docker/cli/pull/6471)
### Actualizaciones de empaquetado
- Eliminar soporte para conjuntos de cifrado CBC heredados. [docker/cli#6474](https://github.com/docker/cli/pull/6474)
- Actualizar BuildKit a [v0.25.0](https://github.com/moby/buildkit/releases/tag/v0.25.0). [moby/moby#51075](https://github.com/moby/moby/pull/51075)
- Actualizar la sintaxis de Dockerfile a [v1.19.0](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.19.0). [moby/moby#51075](https://github.com/moby/moby/pull/51075)
### Redes
- Eliminar la advertencia inofensiva sobre la eliminación de `endpoint_count` del almacén de datos. [moby/moby#51064](https://github.com/moby/moby/pull/51064)
- Corregir un error que causaba que los plugins de IPAM no se cargaran en Windows. [moby/moby#51035](https://github.com/moby/moby/pull/51035)
### API
- Depreciar el soporte para la contabilidad TCP de memoria del kernel (`KernelMemoryTCP`). [moby/moby#51067](https://github.com/moby/moby/pull/51067)
- Corregir que `GET containers/{name}/checkpoints` devuelva `null` en lugar de una matriz JSON vacía cuando no hay puntos de control (checkpoints). [moby/moby#51052](https://github.com/moby/moby/pull/51052)
### SDK de Go
- cli-plugins/plugin: Run: permitir personalizar la CLI. [docker/cli#6481](https://github.com/docker/cli/pull/6481)
- cli/command: añadir la opción `WithUserAgent`. [docker/cli#6477](https://github.com/docker/cli/pull/6477)
### Depreciaciones
- SDK de Go: cli/command: depreciar `DockerCli.Apply`. Este método ya no se utiliza y se eliminará en la próxima versión si no quedan usos. [docker/cli#6497](https://github.com/docker/cli/pull/6497)
- SDK de Go: cli/command: depreciar `DockerCli.ContentTrustEnabled`. Este método ya no se utiliza y se eliminará en la próxima versión. [docker/cli#6495](https://github.com/docker/cli/pull/6495)
- SDK de Go: cli/command: depreciar `DockerCli.DefaultVersion`. Este método ya no se utiliza y se eliminará en la próxima versión. [docker/cli#6491](https://github.com/docker/cli/pull/6491)
- SDK de Go: cli/command: depreciar la utilidad `ResolveDefaultContext`. [docker/cli#6529](https://github.com/docker/cli/pull/6529)
- SDK de Go: cli/command: depreciar las opciones `WithContentTrustFromEnv` y `WithContentTrust`. Estas opciones se utilizaban internamente y se eliminarán en la próxima versión. [docker/cli#6489](https://github.com/docker/cli/pull/6489)
- SDK de Go: cli/manifest/store: depreciar `IsNotFound()`. [docker/cli#6514](https://github.com/docker/cli/pull/6514)
- SDK de Go: templates: depreciar la función `NewParse()`. [docker/cli#6469](https://github.com/docker/cli/pull/6469)
## 28.4.0
2025-09-03
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.4.0](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.4.0)
- [moby/moby, hito 28.4.0](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.4.0)
### Nuevas características
- Permitir que la CLI de Docker establezca la variable de entorno `GODEBUG` cuando el par clave-valor (`"GODEBUG":"..."`) existe dentro de los metadatos del contexto de docker. [docker/cli#6399](https://github.com/docker/cli/pull/6399)
### Correcciones de errores y mejoras
- Añadir completado de la terminal para `docker pull` y `docker image pull`. [docker/cli#6420](https://github.com/docker/cli/pull/6420)
- Corregir una regresión en la v28.3.3 que podía causar un pánico al ejecutar `docker push` si el cliente no enviaba una cabecera `X-Registry-Auth`. [moby/moby#50738](https://github.com/moby/moby/pull/50738)
- Windows: Solucionar potencialmente un problema con el error "acceso denegado" al descargar imágenes. [moby/moby#50871](https://github.com/moby/moby/pull/50871)
- Almacén de imágenes de containerd: Corregir que `docker history` fallara con `snapshot X does not exist` al llamarlo en una imagen no nativa que fue compilada localmente. [moby/moby#50875](https://github.com/moby/moby/pull/50875)
- Almacén de imágenes de containerd: Corregir que `docker image prune` emita los eventos correctos `untag` y `delete` y liste solo los resúmenes raíz de las imágenes eliminadas en lugar de cada blob. [moby/moby#50837](https://github.com/moby/moby/pull/50837)
- Eliminar el prompt de inicio de sesión interactivo de `docker push` y `docker pull` después de un fallo causado por la falta de autenticación. [docker/cli#6256](https://github.com/docker/cli/pull/6256)
### Actualizaciones de empaquetado
- Actualizar BuildKit a [v0.24.0](https://github.com/moby/buildkit/releases/tag/v0.24.0). [moby#50888](https://github.com/moby/moby/pull/50888)
- Actualizar el entorno de ejecución de Go a [1.24.7](https://go.dev/doc/devel/release#go1.24.6). [moby/moby#50889](https://github.com/moby/moby/pull/50889), [docker/cli#6422](https://github.com/docker/cli/pull/6422)
- Actualizar `runc` a [v1.3.0](https://github.com/opencontainers/runc/releases/tag/v1.3.0). [moby/moby#50699](https://github.com/moby/moby/pull/50699)
- Actualizar containerd (solo binarios estáticos) a [v1.7.28](https://github.com/containerd/containerd/releases/tag/v1.7.28). [moby/moby#50700](https://github.com/moby/moby/pull/50700)
### Redes
- Corregir un problema que podía causar un reinicio lento del contenedor al realizar la restauración en vivo. [moby/moby#50829](https://github.com/moby/moby/pull/50829)
### API
- Actualizar el mensaje de depreciación para el campo `AuthConfig.Email`. [moby/moby#50797](https://github.com/moby/moby/pull/50797)
### SDK de Go
- Depreciar el paquete profiles que se migró a [github.com/moby/profiles](https://github.com/moby/profiles). [moby/moby#50513](https://github.com/moby/moby/pull/50513)
### Depreciaciones
- Depreciar el manejo especial para valores entrecomillados para las banderas de línea de comandos `--tlscacert`, `--tlscert` y `--tlskey`. [docker/cli#6291](https://github.com/docker/cli/pull/6291)
- Marcar las variables de entorno de enlaces heredados (`DOCKER_KEEP_DEPRECATED_LEGACY_LINKS_ENV_VARS`) como depreciadas en la v28.4 y programadas para su eliminación en la v30.0. [docker/cli#6309](https://github.com/docker/cli/pull/6309)
- SDK de Go: Depreciar el campo `NetworkSettingsBase.Bridge`, la estructura `NetworkSettingsBase`, todos los campos de `DefaultNetworkSettings` y la estructura `DefaultNetworkSettings`. [moby/moby#50839](https://github.com/moby/moby/pull/50839)
- SDK de Go: api/types: `build.CacheDiskUsage`, `container.DiskUsage`, `images.DiskUsage` y `volumes.DiskUsage` están ahora depreciados y se eliminarán en la próxima versión principal. [moby/moby#50768](https://github.com/moby/moby/pull/50768)
- SDK de Go: cli-plugins/manager: depreciar `ReexecEnvvar`. [docker/cli#6411](https://github.com/docker/cli/pull/6411)
- SDK de Go: cli-plugins/manager: depreciar los alias de anotación (`CommandAnnotationPlugin`, `CommandAnnotationPluginVendor`, `CommandAnnotationPluginVersion`, `CommandAnnotationPluginInvalid`, `CommandAnnotationPluginCommandPath`) en favor de sus equivalentes en `cli-plugins/manager/metadata`. [docker/cli#6298](https://github.com/docker/cli/pull/6298)
- SDK de Go: cli-plugins/manager: depreciar los alias de metadatos (`NamePrefix`, `MetadataSubcommandName`, `HookSubcommandName`, `Metadata`, `ReexecEnvvar`) en favor de sus equivalentes en `cli-plugins/manager/metadata`. [docker/cli#6269](https://github.com/docker/cli/pull/6269)
- SDK de Go: cli-plugins/manager: eliminar la interfaz `Candidate`, que era solo para uso interno. [docker/cli#6269](https://github.com/docker/cli/pull/6269)
- SDK de Go: cli-plugins/manager: eliminar la función `NewPluginError`, que era solo para uso interno. [docker/cli#6269](https://github.com/docker/cli/pull/6269)
- SDK de Go: cli-plugins/manager: eliminar la constante depreciada `ResourceAttributesEnvvar`. [docker/cli#6269](https://github.com/docker/cli/pull/6269)
- SDK de Go: cli/command/builder: depreciar `NewBuilderCommand` y `NewBakeStubCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/builder: depreciar `NewPruneCommand`. [docker/cli#6343](https://github.com/docker/cli/pull/6343)
- SDK de Go: cli/command/checkpoint: depreciar `NewCheckpointCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/checkpoint: depreciar `NewFormat`, `FormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/completion: depreciar `NoComplete`. [docker/cli#6405](https://github.com/docker/cli/pull/6405)
- SDK de Go: cli/command/completion: eliminar el depreciado `ValidArgsFn`. [docker/cli#6259](https://github.com/docker/cli/pull/6259)
- SDK de Go: cli/command/config: depreciar `NewConfigCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/config: depreciar `NewFormat`, `FormatWrite`, `InspectFormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/config: depreciar `RunConfigCreate`, `CreateOptions`, `RunConfigInspect`, `InspectOptions`, `RunConfigList`, `ListOptions`, `RunConfigRemove` y `RemoveOptions`. [docker/cli#6369](https://github.com/docker/cli/pull/6369)
- SDK de Go: cli/command/container: depreciar `NewBuildCommand`, `NewPullCommand`, `NewPushCommand`, `NewImagesCommand`, `NewImageCommand`, `NewHistoryCommand`, `NewImportCommand`, `NewLoadCommand`, `NewRemoveCommand`, `NewSaveCommand`, `NewTagCommand`, `NewPruneCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/container: depreciar `NewDiffFormat`, `DiffFormatWrite`. Estas funciones se utilizaron solo internamente y se eliminarán en la próxima versión. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/container: depreciar `NewRunCommand`, `NewExecCommand`, `NewPsCommand`, `NewContainerCommand`, `NewAttachCommand`, `NewCommitCommand`, `NewCopyCommand`, `NewCreateCommand`, `NewDiffCommand`, `NewExportCommand`, `NewKillCommand`, `NewLogsCommand`, `NewPauseCommand`, `NewPortCommand`, `NewRenameCommand`, `NewRestartCommand`, `NewRmCommand`, `NewStartCommand`, `NewStatsCommand`, `NewStopCommand`, `NewTopCommand`, `NewUnpauseCommand`, `NewUpdateCommand`, `NewWaitCommand`, `NewPruneCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/context: depreciar `NewContextCommand`. This function will be removed in the next release. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/context: depreciar `RunCreate` y `CreateOptions`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/context: depreciar `RunExport` y `ExportOptions`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/context: depreciar `RunImport`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/context: depreciar `RunRemove` y `RemoveOptions`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/context: depreciar `RunUpdate` y `UpdateOptions`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/context: depreciar `RunUse`. [docker/cli#6403](https://github.com/docker/cli/pull/6403)
- SDK de Go: cli/command/image: depreciar la utilidad `AuthResolver`. [docker/cli#6357](https://github.com/docker/cli/pull/6357)
- SDK de Go: cli/command/image: depreciar `NewHistoryFormat`, `HistoryWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/manifest: depreciar `NewManifestCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/network: depreciar `NewFormat`, `FormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/network: depreciar `NewNetworkCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/node: depreciar `NewFormat`, `FormatWrite`, `InspectFormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/node: depreciar `NewNodeCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/plugin: depreciar `NewFormat`, `FormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/plugin: depreciar `NewPluginCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/registry: depreciar `NewLoginCommand`, `NewLogoutCommand`, `NewSearchCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/registry: depreciar `NewSearchFormat`, `SearchWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/registry: depreciar la constante `OauthLoginEscapeHatchEnvVar`. [docker/cli#6413](https://github.com/docker/cli/pull/6413)
- SDK de Go: cli/command/secret: depreciar `NewFormat`, `FormatWrite`, `InspectFormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/secret: depreciar `NewSecretCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/service: depreciar `NewFormat`, `InspectFormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/service: depreciar `NewServiceCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/stack: depreciar `NewStackCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/stack: depreciar `RunList`, `RunServices`. [docker/cli#6391](https://github.com/docker/cli/pull/6391)
- SDK de Go: cli/command/swarm: depreciar `NewSwarmCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/system: depreciar `NewVersionCommand`, `NewInfoCommand`, `NewSystemCommand`, `NewEventsCommand`, `NewInspectCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/task: depreciar `NewTaskFormat`, `FormatWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/trust: depreciar `NewTrustCommand`. Esta función se eliminará en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command/trust: depreciar `SignedTagInfo`, `SignerInfo`, `NewTrustTagFormat`, `NewSignerInfoFormat`, `TagWrite`, `SignerInfoWrite`. [docker/cli#6341](https://github.com/docker/cli/pull/6341)
- SDK de Go: cli/command/volume: depreciar `NewVolumeCommand`, `NewPruneCommand`. Estas funciones se eliminarán en la próxima versión. [docker/cli#6312](https://github.com/docker/cli/pull/6312)
- SDK de Go: cli/command: eliminar las utilidades `AddTrustSigningFlags`, `AddTrustVerificationFlags` y `AddPlatformFlag`, que se utilizaban solo internamente. [docker/cli#6311](https://github.com/docker/cli/pull/6311)
- SDK de Go: cli/command: eliminar la utilidad depreciada `ConfigureAuth`. [docker/cli#6257](https://github.com/docker/cli/pull/6257)
- SDK de Go: cli/command: eliminar la utilidad depreciada `CopyToFile`. [docker/cli#6257](https://github.com/docker/cli/pull/6257)
- SDK de Go: cli/config/types: actualizar el mensaje de depreciación para el campo `AuthConfig.Email`. [docker/cli#6392](https://github.com/docker/cli/pull/6392)
- SDK de Go: cli: depreciar las utilidades `VisitAll`, `DisableFlagsInUseLine`. Estas utilidades se utilizaron solo internamente y se eliminarán en la próxima versión. [docker/cli#6276](https://github.com/docker/cli/pull/6276)
- SDK de Go: cli: eliminar la utilidad `HasCompletionArg`. Esta utilidad solo se utilizaba internamente. [docker/cli#6276](https://github.com/docker/cli/pull/6276)
- SDK de Go: depreciar `cli/command.RegistryAuthenticationPrivilegedFunc`. [docker/cli#6256](https://github.com/docker/cli/pull/6256)
- SDK de Go: depreciar cli/command/stack/formatter. [docker/cli#6391](https://github.com/docker/cli/pull/6391)
- SDK de Go: depreciar cli/command/stack/loader. [docker/cli#6391](https://github.com/docker/cli/pull/6391)
- SDK de Go: depreciar cli/command/stack/options. [docker/cli#6391](https://github.com/docker/cli/pull/6391)
- SDK de Go: depreciar cli/command/stack/swarm. [docker/cli#6391](https://github.com/docker/cli/pull/6391)
- SDK de Go: opts: depreciar `NewNamedListOptsRef`, `NewNamedMapOpts`, `NamedListOpts`, `NamedMapOpts` y `NamedOption`. Estos tipos y funciones ya no se utilizan y se eliminarán en la próxima versión. [docker/cli#6292](https://github.com/docker/cli/pull/6292)
- SDK de Go: opts: depreciar `ParseEnvFile` en favor de `kvfile.Parse`. [docker/cli#6381](https://github.com/docker/cli/pull/6381)
- SDK de Go: opts: depreciar `QuotedString`. Esta utilidad ya no se utiliza y se eliminará en la próxima versión. [docker/cli#6275](https://github.com/docker/cli/pull/6275)
- SDK de Go: opts: depreciar la utilidad `ValidateHost`. Esta función ya no se utiliza y se eliminará en la próxima versión. [docker/cli#6280](https://github.com/docker/cli/pull/6280)
- SDK de Go: pkg/jsonmessage: depreciar los campos `JSONMessage.From`, `JSONMessage.Time` y `JSONMessage.TimeNano`, ya que la API ya no los devuelve para mensajes de progreso. Utiliza el tipo `events.Message` en su lugar para deserializar la respuesta de `/events`. [moby/moby#50762](https://github.com/moby/moby/pull/50762)
- SDK de Go: el paquete cli/registry/client está depreciado y se eliminará en la próxima versión. [docker/cli#6313](https://github.com/docker/cli/pull/6313)
## 28.3.3
2025-07-29
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.3.3](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.3.3)
- [moby/moby, hito 28.3.3](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.3.3)
### Seguridad
Esta versión corrige un problema por el cual, después de una recarga de firewalld, los puertos publicados del contenedor podían ser accesibles directamente desde la red local, incluso cuando estaban destinados a ser accesibles solo a través de una dirección loopback. [CVE-2025-54388](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2025-54388) / [GHSA-x4rx-4gw3-53p4](https://github.com/moby/moby/security/advisories/GHSA-x4rx-4gw3-53p4) / [moby/moby#50506](https://github.com/moby/moby/pull/50506).
### Actualizaciones de empaquetado
- Actualizar Buildx a [v0.26.1](https://github.com/docker/buildx/releases/tag/v0.26.1). [docker/docker-ce-packaging#1230](https://github.com/docker/docker-ce-packaging/pull/1230)
- Actualizar Compose a [v2.39.1](https://github.com/docker/compose/releases/tag/v2.39.1). [docker/docker-ce-packaging#1234](https://github.com/docker/docker-ce-packaging/pull/1234)
- Actualizar el plugin Docker Model CLI a [v0.1.36](https://github.com/docker/model-cli/releases/tag/v0.1.36). [docker/docker-ce-packaging#1233](https://github.com/docker/docker-ce-packaging/pull/1233)
## 28.3.2
2025-07-09
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.3.2](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.3.2)
- [moby/moby, hito 28.3.2](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.3.2)
### Correcciones de errores y mejoras
- Corregir que `--use-api-socket` no funcionara correctamente al dirigirse a un daemon remoto. [docker/cli#6157](https://github.com/docker/cli/pull/6157)
- Corregir que se imprimieran logs de "otel error" perdidos si el log de depuración está activado. [docker/cli#6160](https://github.com/docker/cli/pull/6160)
- Entrecomillar los argumentos de SSH al conectarse a un daemon remoto a través de una conexión SSH para evitar una expansión inesperada. [docker/cli#6147](https://github.com/docker/cli/pull/6147)
- Advertir cuando `DOCKER_AUTH_CONFIG` está establecido durante `docker login` y `docker logout`. [docker/cli#6163](https://github.com/docker/cli/pull/6163)
### Actualizaciones de empaquetado
- Actualizar Compose a [v2.38.2](https://github.com/docker/compose/releases/tag/v2.38.2). [docker/docker-ce-packaging#1225](https://github.com/docker/docker-ce-packaging/pull/1225)
- Actualizar el plugin Docker Model CLI a [v0.1.33](https://github.com/docker/model-cli/releases/tag/v0.1.33). [docker/docker-ce-packaging#1227](https://github.com/docker/docker-ce-packaging/pull/1227)
- Actualizar el entorno de ejecución de Go a 1.24.5. [moby/moby#50354](https://github.com/moby/moby/pull/50354)
## 28.3.1
2025-07-02
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.3.1](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.3.1)
- [moby/moby, hito 28.3.1](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.3.1)
### Actualizaciones de empaquetado
- Actualizar BuildKit a [v0.23.2](https://github.com/moby/buildkit/releases/tag/v0.23.2). [moby/moby#50309](https://github.com/moby/moby/pull/50309)
- Actualizar Compose a [v2.38.1](https://github.com/docker/compose/releases/tag/v2.38.1). [docker/docker-ce-packaging#1221](https://github.com/docker/docker-ce-packaging/pull/1221)
- Actualizar Model a v0.1.32, que añade soporte para la nueva clave de nivel superior `models:` en Docker Compose. [docker/docker-ce-packaging#1222](https://github.com/docker/docker-ce-packaging/pull/1222)
## 28.3.0
2025-06-24
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.3.0](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.3.0)
- [moby/moby, hito 28.3.0](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.3.0)
### Nuevas características
- Añadir soporte para GPUs AMD en `docker run --gpus`. [moby/moby#49952](https://github.com/moby/moby/pull/49952)
- Utilizar `DOCKER_AUTH_CONFIG` como almacén de credenciales. [docker/cli#6008](https://github.com/docker/cli/pull/6008)
### Correcciones de errores y mejoras
- Asegurar que el estado del contenedor en la base de datos del daemon (utilizada por la API [/containers/json](https://docs-docker.esdocu.com/reference/api/engine/version/v1.49/#tag/Container/operation/ContainerList)) esté al día cuando el contenedor se detiene utilizando la API [/containers/{id}/stop](https://docs-docker.esdocu.com/reference/api/engine/version/v1.49/#tag/Container/operation/ContainerStop) (antes de la respuesta de la API). [moby/moby#50136](https://github.com/moby/moby/pull/50136)
- Corregir que `docker image inspect` omita campos vacíos. [moby/moby#50135](https://github.com/moby/moby/pull/50135)
- Corregir que `docker images --tree` no marque las imágenes como en uso cuando el almacén de imágenes de containerd está desactivado. [docker/cli#6140](https://github.com/docker/cli/pull/6140)
- Corregir que `docker pull/push` se cuelgue en modo no interactivo cuando se requiere autenticación, debido a la solicitud de credenciales de inicio de sesión. [docker/cli#6141](https://github.com/docker/cli/pull/6141)
- Corregir una posible fuga de recursos cuando un nodo sale de un Swarm. [moby/moby#50115](https://github.com/moby/moby/pull/50115)
- Corregir un problema por el cual un prompt de inicio de sesión en `docker pull` mostraba sugerencias específicas de Docker Hub al iniciar sesión en otros registros. [docker/cli#6135](https://github.com/docker/cli/pull/6135)
- Corregir un problema por el cual todas las tareas nuevas en el Swarm podían quedar atascadas en el estado PENDING para siempre después de escalar un servicio con preferencias de ubicación. [moby/moby#50211](https://github.com/moby/moby/pull/50211)
- Eliminar un comando de nivel superior `docker remove` oculto y no documentado que se introdujo accidentalmente en Docker 23.0. [docker/cli#6144](https://github.com/docker/cli/pull/6144)
- Validar la configuración de registry-mirrors como parte de `dockerd --validate` y mejorar los mensajes de error para espejos no válidos. [moby/moby#50240](https://github.com/moby/moby/pull/50240)
- `dockerd-rootless-setuptool.sh`: Corregir el script para que no regrese silenciosamente sin mensaje de error cuando no se cumplen los requisitos del sistema subuid/subgid. [moby/moby#50059](https://github.com/moby/moby/pull/50059)
- Almacén de imágenes de containerd: Corregir que `docker push` no cree una etiqueta en el repositorio remoto. [moby/moby#50199](https://github.com/moby/moby/pull/50199)
- Almacén de imágenes de containerd: Mejorar el manejo de errores devueltos por el servidor de tokens durante `docker pull/push`. [moby/moby#50176](https://github.com/moby/moby/pull/50176)
### Actualizaciones de empaquetado
- Permitir personalizar el nombre del servicio de containerd para OpenRC. [moby/moby#50156](https://github.com/moby/moby/pull/50156)
- Actualizar BuildKit a [v0.23.1](https://github.com/moby/buildkit/releases/tag/v0.23.1). [moby/moby#50243](https://github.com/moby/moby/pull/50243)
- Actualizar Buildx a [v0.25.0](https://github.com/docker/buildx/releases/tag/v0.25.0). [docker/docker-ce-packaging#1217](https://github.com/docker/docker-ce-packaging/pull/1217)
- Actualizar Compose a [v2.37.2](https://github.com/docker/compose/releases/tag/v2.37.2). [docker/docker-ce-packaging#1219](https://github.com/docker/docker-ce-packaging/pull/1219)
- Actualizar el plugin Docker Model CLI a [v0.1.30](https://github.com/docker/model-cli/releases/tag/v0.1.30). [docker/docker-ce-packaging#1218](https://github.com/docker/docker-ce-packaging/pull/1218)
- Actualizar el entorno de ejecución de Go a [1.24.4](https://go.dev/doc/devel/release#go1.24.4). [docker/docker-ce-packaging#1213](https://github.com/docker/docker-ce-packaging/pull/1213), [moby/moby#50153](https://github.com/moby/moby/pull/50153), [docker/cli#6124](https://github.com/docker/cli/pull/6124)
### Redes
- Revertir los cambios relacionados con Swarm añadidos en las compilaciones 28.2.x, debido a una regresión reportada en https://github.com/moby/moby/issues/50129. [moby/moby#50169](https://github.com/moby/moby/pull/50169)
* Revertir: Corregir un problema por el cual `docker network inspect --verbose` a veces podía bloquear el daemon (https://github.com/moby/moby/pull/49937).
* Revertir: Corregir un problema por el cual la dirección IP del balanceador de carga para una red overlay no se liberaba en ciertos casos si el Swarm carecía de una red de ingreso (ingress) (https://github.com/moby/moby/pull/49948).
* Revertir: Mejorar la confiabilidad de NetworkDB en clusters ocupados y redes con pérdidas (https://github.com/moby/moby/pull/49932).
* Revertir: Mejoras en la confiabilidad y la velocidad de convergencia de NetworkDB (https://github.com/moby/moby/pull/49939).
- Corregir un problema que podía causar que fallara el inicio del contenedor, o conducir a mapeos de puertos UDP fallidos, cuando algunos puertos del contenedor están mapeados a `0.0.0.0` y otros están mapeados a direcciones específicas del host. [moby/moby#50054](https://github.com/moby/moby/pull/50054)
- La respuesta de `network inspect` para una red overlay ahora reporta que `EnableIPv4` es true. [moby/moby#50147](https://github.com/moby/moby/pull/50147)
- Windows: Mejorar el tiempo de inicio del daemon en casos donde el host tiene redes de tipo `"Mirrored"`. [moby/moby#50155](https://github.com/moby/moby/pull/50155)
- Windows: Asegurar que `docker system prune` y `docker network prune` solo eliminen redes creadas por Docker. [moby/moby#50154](https://github.com/moby/moby/pull/50154)
### API
- Actualizar la versión de la API a 1.51. [moby/moby#50145](https://github.com/moby/moby/pull/50145)
- `GET /images/json` ahora establece el valor del campo `Containers` para todas las imágenes al recuento de contenedores que usan la imagen. [moby/moby#50146](https://github.com/moby/moby/pull/50146)
### Depreciaciones
- Los campos de configuración de imagen vacíos/nulos en la respuesta `GET /images/{name}/json` ahora están depreciados y se eliminarán en la v29.0. [docker/cli#6129](https://github.com/docker/cli/pull/6129)
- api/types/container: depreciar `ExecOptions.Detach`. Este campo no se utiliza y se eliminará en una versión futura. [moby/moby#50219](https://github.com/moby/moby/pull/50219)
- pkg/idtools: depreciar `IdentityMapping` y `Identity.Chown`. [moby/moby#50210](https://github.com/moby/moby/pull/50210)
## 28.2.2
2025-05-30
Para obtener una lista completa de las solicitudes de extracción (pull requests) y los cambios en esta versión, consulta los hitos (milestones) correspondientes en GitHub:
- [docker/cli, hito 28.2.2](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.2.2)
- [moby/moby, hito 28.2.2](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.2.2)
### Bug fixes and enhancements
- Almacén de imágenes de containerd: Corregir una regresión que causaba que `docker build --push` fallara. Esto revierte [la corrección](https://github.com/moby/moby/pull/49702) para que `docker build` no persistiera las imágenes sobrescritas como huérfanas (dangling). [moby/moby#50105](https://github.com/moby/moby/pull/50105)
### Redes
- Al crear la cadena de iptables `DOCKER-USER`, no añadir una regla `RETURN` explícita, permitiendo a los usuarios añadir además de insertar sus propias reglas. Las reglas existentes no se eliminan al actualizar, pero no se reemplazarán después de un reinicio. [moby/moby#50098](https://github.com/moby/moby/pull/50098)
## 28.2.1
2025-05-29
### Actualizaciones de empaquetado
- Corregir una regresión de empaquetado en la [v28.2.0](https://github.com/moby/moby/releases/tag/v28.2.0) que impedía la creación del grupo/usuario `docker` en instalaciones nuevas. [docker-ce-packaging#1209](https://github.com/docker/docker-ce-packaging/issues/1209)
## 28.2.0
2025-05-28
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.2.0](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.2.0)
- [moby/moby, hito 28.2.0](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.2.0)
> [!NOTE]
> Los paquetes de RHEL no están disponibles actualmente y se publicarán más adelante.
### Nuevas características
- Añadir `{{.Platform}}` como opción de formato para `docker ps` para mostrar la plataforma de la imagen que el contenedor está ejecutando. [docker/cli#6042](https://github.com/docker/cli/pull/6042)
- Añadir soporte para rutas padre relativas (`../`) en los orígenes de montaje bind cuando se utiliza `docker run/create` con las opciones `-v/--volume` o `--mount type=bind`. [docker/cli#4966](https://github.com/docker/cli/pull/4966)
- CDI está ahora activado por defecto. [moby/moby#49963](https://github.com/moby/moby/pull/49963)
- Mostrar los dispositivos CDI descubiertos en `docker info`. [docker/cli#6078](https://github.com/docker/cli/pull/6078)
- `docker image rm`: añadir la opción `--platform` para eliminar una variante de imágenes multiplataforma. [docker/cli#6109](https://github.com/docker/cli/pull/6109)
- Almacén de imágenes de containerd: Soporte inicial de BuildKit para compilar imágenes de contenedor de Windows en Windows (requiere activación explícita con `DOCKER_BUILDKIT=1`). [moby/moby#49740](https://github.com/moby/moby/pull/49740)
### Correcciones de errores y mejoras
- Añadir una nueva opción de logs para el controlador de logs fluentd (`fluentd-write-timeout`), que permite especificar los tiempos de espera de escritura para las conexiones de fluentd. [moby/moby#49911](https://github.com/moby/moby/pull/49911)
- Añadir soporte para `DOCKER_AUTH_CONFIG` para la opción experimental `--use-api-socket`. [docker/cli#6019](https://github.com/docker/cli/pull/6019)
- Corregir que `docker exec` esperara durante 10 segundos si se especificaba un usuario o grupo no existente. [moby/moby#49868](https://github.com/moby/moby/pull/49868)
- Corregir que `docker swarm init` ignorara la opción `cacert` de `--external-ca`. [docker/cli#5995](https://github.com/docker/cli/pull/5995)
- Corregir un problema por el cual la CLI no guardaba correctamente el archivo de configuración (`~/.docker/config.json`) si era un enlace simbólico relativo. [docker/cli#5282](https://github.com/docker/cli/pull/5282)
- Corregir que los contenedores con política `--restart always` utilizando dispositivos CDI fallaran al iniciarse tras el reinicio del daemon. [moby/moby#49990](https://github.com/moby/moby/pull/49990)
- Corregir el completado en la terminal para completar solo algunas banderas una vez, aunque se puedan establecer varias veces. [docker/cli#6030](https://github.com/docker/cli/pull/6030)
- Corregir el error `plugin does not implement PluginAddr interface` para los controladores Swarm CSI. [moby/moby#49961](https://github.com/moby/moby/pull/49961)
- Mejorar los mensajes de error de `docker login` para opciones no válidas. [docker/cli#6036](https://github.com/docker/cli/pull/6036)
- Asegurar que el estado del terminal se restaure si la CLI se termina a la fuerza. [docker/cli#6058](https://github.com/docker/cli/pull/6058)
- Actualizar el perfil seccomp predeterminado para que coincida con libseccomp v2.6.0. Las nuevas llamadas al sistema son: `listmount`, `statmount`, `lsm_get_self_attr`, `lsm_list_modules`, `lsm_set_self_attr`, `mseal`, `uretprobe`, `riscv_hwprobe`, `getxattrat`, `listxattrat`, `removexattrat` y `setxattrat`. Esto evita que los contenedores reciban errores EPERM al utilizarlas. [moby/moby#50077](https://github.com/moby/moby/pull/50077)
- `docker inspect`: añadir completado en la terminal, mejorar la descripción de la bandera para `--type` y mejorar la validación. [docker/cli#6052](https://github.com/docker/cli/pull/6052)
- Almacén de imágenes de containerd: Habilitar el recolector de basura de BuildKit por defecto. [moby/moby#49899](https://github.com/moby/moby/pull/49899)
- Almacén de imágenes de containerd: Corregir que `docker build` no persistiera las imágenes sobrescritas como huérfanas (dangling). [moby/moby#49702](https://github.com/moby/moby/pull/49702)
- Almacén de imágenes de containerd: Corregir que `docker system df` reportara una cantidad negativa de espacio recuperable. [moby/moby#49707](https://github.com/moby/moby/pull/49707)
- Almacén de imágenes de containerd: Corregir solicitudes `PUT` duplicadas al subir una imagen multiplataforma. [moby/moby#49949](https://github.com/moby/moby/pull/49949)
### Actualizaciones de empaquetado
- Eliminar los paquetes de Ubuntu 20.04 "Focal" al llegar al final de su vida útil. [docker/docker-ce-packaging#1200](https://github.com/docker/docker-ce-packaging/pull/1200)
- Corregir la ubicación de instalación para las páginas man de `docker-ce` basadas en RPM. [docker/docker-ce-packaging#1203](https://github.com/docker/docker-ce-packaging/pull/1203)
- Actualizar BuildKit a [v0.22.0](https://github.com/moby/buildkit/releases/tag/v0.22.0). [moby/moby#50046](https://github.com/moby/moby/pull/50046)
- Actualizar Buildx a [v0.24.0](https://github.com/docker/buildx/releases/tag/v0.24.0). [docker/docker-ce-packaging#1205](https://github.com/docker/docker-ce-packaging/pull/1205)
- Actualizar Compose a [v2.36.2](https://github.com/docker/compose/releases/tag/v2.36.2). [docker/docker-ce-packaging#1208](https://github.com/docker/docker-ce-packaging/pull/1208)
- Actualizar el entorno de ejecución de Go a [1.24.3](https://go.dev/doc/devel/release#go1.24.3). [docker/docker-ce-packaging#1192](https://github.com/docker/docker-ce-packaging/pull/1192), [docker/cli#6060](https://github.com/docker/cli/pull/6060), [moby/moby#49174](https://github.com/moby/moby/pull/49174)
### Redes
- Añadir la opción de red bridge `"com.docker.network.bridge.trusted_host_interfaces"`, que acepta una lista de nombres de interfaz separados por dos puntos. Estas interfaces tienen acceso directo a los puertos publicados en las direcciones IP del contenedor. [moby/moby#49832](https://github.com/moby/moby/pull/49832)
- Añadir la opción del daemon `"allow-direct-routing"` para desactivar el filtrado de paquetes de fuera del host dirigidos directamente a los contenedores. [moby/moby#49832](https://github.com/moby/moby/pull/49832)
- No mostrar las opciones de red `com.docker.network.enable_ipv4` o `com.docker.network.enable_ipv6` en la salida del inspect si han sido anuladas por `EnableIPv4` o `EnableIPv6` en la solicitud de creación de red. [moby/moby#49866](https://github.com/moby/moby/pull/49866)
- Corregir un problema que podía causar que fallara la eliminación de la red después del reinicio del daemon, con el error "has active endpoints" listando nombres de endpoint vacíos. [moby/moby#49901](https://github.com/moby/moby/pull/49901)
- Corregir un problema por el cual `docker network inspect --verbose` a veces podía bloquear el daemon. [moby/moby#49937](https://github.com/moby/moby/pull/49937)
- Corregir un problema por el cual la dirección IP del balanceador de carga para una red overlay no se liberaba en ciertos casos si al Swarm le faltaba una red de ingreso. [moby/moby#49948](https://github.com/moby/moby/pull/49948)
- Mejorar la confiabilidad de NetworkDB en clusters ocupados y redes con pérdidas. [moby/moby#49932](https://github.com/moby/moby/pull/49932)
- Mejoras en la confiabilidad y la velocidad de convergencia de NetworkDB. [moby/moby#49939](https://github.com/moby/moby/pull/49939)
### API
- `DELETE /images/{name}` admite ahora un parámetro de consulta `platforms`. Acepta un array de objetos OCI Platform codificados en JSON, lo que permite seleccionar plataformas específicas de las cuales eliminar contenido. [moby/moby#49982](https://github.com/moby/moby/pull/49982)
- `GET /info` incluye ahora un campo `DiscoveredDevices`. Se trata de un array de objetos `DeviceInfo`, cada uno de los cuales proporciona detalles sobre un dispositivo descubierto por un controlador de dispositivos. [moby/moby#49980](https://github.com/moby/moby/pull/49980)
### SDK de Go
- `api/types/container`: añadir `ContainerState` y constantes para el estado del contenedor. [moby/moby#49965](https://github.com/moby/moby/pull/49965)
- `api/types/container`: cambiar `Summary.State` a `ContainerState`. [moby/moby#49991](https://github.com/moby/moby/pull/49991)
- `api/types/container`: definir el tipo `HealthStatus` para constantes de estado de salud. [moby/moby#49876](https://github.com/moby/moby/pull/49876)
- `api/types`: depreciar `BuildResult`, `ImageBuildOptions`, `ImageBuildOutput`, `ImageBuildResponse`, `BuilderVersion`, `BuilderV1` y `BuilderBuildKi`, que se movieron a `api/types/build`. [moby/moby#50025](https://github.com/moby/moby/pull/50025)
### Depreciaciones
- API: Depreciado: `GET /images/{name}/json` ya no devuelve los siguientes campos: `Config`, `Hostname`, `Domainname`, `AttachStdin`, `AttachStdout`, `AttachStderr`, `Tty`, `OpenStdin`, `StdinOnce`, `Image`, `NetworkDisabled` (ya se omite a menos que esté establecido), `MacAddress` (ya se omite a menos que esté establecido), `StopTimeout` (ya se omite a menos que esté establecido). Estos campos adicionales se incluyeron en la respuesta debido a un detalle de implementación pero no formaban parte de la Configuración de la imagen, se marcaron como depreciados en la versión de API v1.46 y ahora se omiten. [moby/moby#48457](https://github.com/moby/moby/pull/48457)
- SDK de Go: Depreciado: `builder/remotecontext.Rel()`. Esta función era necesaria en versiones anteriores de Go, pero ahora puede reemplazarse por `filepath.Rel()`. [moby/moby#49843](https://github.com/moby/moby/pull/49843)
- SDK de Go: api/types: depreciar `BuildCachePruneOptions` en favor de `api/types/builder.CachePruneOptions`. [moby/moby#50015](https://github.com/moby/moby/pull/50015)
- SDK de Go: api/types: depreciar `BuildCachePruneReport` en favor de `api/types/builder.CachePruneReport`. [moby/moby#50015](https://github.com/moby/moby/pull/50015)
- SDK de Go: api/types: depreciar `NodeListOptions`, `NodeRemoveOptions`, `ServiceCreateOptions`, `ServiceUpdateOptions`, `RegistryAuthFromSpec`, `RegistryAuthFromPreviousSpec`, `ServiceListOptions`, `ServiceInspectOptions` y `SwarmUnlockKeyResponse` que se movieron a `api/types/swarm`. [moby/moby#50027](https://github.com/moby/moby/pull/50027)
- SDK de Go: api/types: depreciar `SecretCreateResponse`, `SecretListOptions`, `ConfigCreateResponse`, `ConfigListOptions` que se movieron a `api/types/swarm`. [moby/moby#50024](https://github.com/moby/moby/pull/50024)
- SDK de Go: client: depreciar `IsErrNotFound`. [moby/moby#50012](https://github.com/moby/moby/pull/50012)
- SDK de Go: container: depreciar `IsValidHealthString` en favor de `api/types/container.ValidateHealthStatus`. [moby/moby#49893](https://github.com/moby/moby/pull/49893)
- SDK de Go: container: depreciar `StateStatus`, `WaitCondition` y las constantes relacionadas `WaitConditionNotRunning`, `WaitConditionNextExit` y `WaitConditionRemoved` en favor de sus equivalentes en `api/types/container`. [moby/moby#49874](https://github.com/moby/moby/pull/49874)
- SDK de Go: opts: depreciar `ListOpts.GetAll` en favor de `ListOpts.GetSlice`. [docker/cli#6032](https://github.com/docker/cli/pull/6032)
- Eliminar el marcador de posición de formato depreciado `IsAutomated` de `docker search`. [docker/cli#6091](https://github.com/docker/cli/pull/6091)
- Eliminar alternativa para descargar imágenes del registro no conforme con OCI `docker.pkg.github.com`. [moby/moby#50094](https://github.com/moby/moby/pull/50094)
- Eliminar el soporte para descargar imágenes heredadas v2, esquema 1 y eliminar la variable de entorno `DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE`. [moby/moby#50036](https://github.com/moby/moby/pull/50036), [moby/moby#42300](https://github.com/moby/moby/pull/42300)
- Los campos `BridgeNfIptables` y `BridgeNfIp6tables` en la respuesta `GET /info` se depreciaron en la API v1.48 y ahora se omiten en la API v1.50. [moby/moby#49904](https://github.com/moby/moby/pull/49904)
- errdefs: Depreciar `errdefs.FromStatusCode`. Utilizar `errhttp.ToNative` de containerd en su lugar. [moby/moby#50030](https://github.com/moby/moby/pull/50030)
## 28.1.1
2025-04-18
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.1.1](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.1.1)
- [moby/moby, hito 28.1.1](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.1.1)
### Correcciones de errores y mejoras
- Corregir que `dockerd-rootless-setuptool.sh` reportara incorrectamente la falta de `iptables`. [moby/moby#49833](https://github.com/moby/moby/pull/49833)
- Almacén de imágenes de containerd: Corregir una posible caída del daemon al usar `docker load` con imágenes de la plataforma incorrecta. [moby/moby#49835](https://github.com/moby/moby/pull/49835)
### Actualizaciones de empaquetado
- Actualizar Go runtime a [1.23.6](https://go.dev/doc/devel/release#go1.23.6) (estaba en 1.23.5 en la versión 28.1.0). [moby/moby#49393](https://github.com/moby/moby/pull/49393), [docker/cli#5795](https://github.com/docker/cli/pull/5795)
## 28.1.0
2025-04-09
Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
- [docker/cli, hito 28.1.0](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.1.0)
- [moby/moby, hito 28.1.0](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.1.0)
### Correcciones de errores y mejoras
- Añadir la dirección de loopback IPv6 como un registro no seguro por defecto. [moby/moby#48540](https://github.com/moby/moby/pull/48540)
- Añadir soporte para scripts de completado generados por Cobra para `dockerd`. [moby/moby#49339](https://github.com/moby/moby/pull/49339)
- Corregir fallos en las consultas DNS cuando los contenedores se inician a través del auto-inicio de `systemd` en el arranque. [moby/moby#48812](https://github.com/moby/moby/pull/48812)
- Corregir que el modo Docker Swarm ignorara `volume.subpath`. [docker/cli#5833](https://github.com/docker/cli/pull/5833)
- Corregir que `docker export` continuara la exportación después de cancelar la operación. [moby/moby#49265](https://github.com/moby/moby/pull/49265)
- Corregir que `docker export` no liberara la capa de escritura del contenedor tras un fallo. [moby/moby#48517](https://github.com/moby/moby/pull/48517)
- Corregir que `docker images --tree` truncara innecesariamente nombres de imágenes largos cuando hay varios nombres disponibles. [docker/cli#5757](https://github.com/docker/cli/pull/5757)
- Corregir un error por el cual un contenedor con un nombre que coincide con el ID de otro contenedor no se restaura al iniciar el daemon. [moby/moby#48669](https://github.com/moby/moby/pull/48669)
- Corregir un problema que impedía que algunas direcciones IPv6 mostradas por `docker ps` estuvieran correctamente entre corchetes. [docker/cli#5468](https://github.com/docker/cli/pull/5468)
- Corregir un error que impedía cancelar las descargas de imágenes durante `docker run`. [docker/cli#5645](https://github.com/docker/cli/pull/5645)
- Corregir el manejo de errores al ejecutar el daemon como un servicio de Windows para evitar salidas incorrectas. [moby/moby#48518](https://github.com/moby/moby/pull/48518)
- Corregir un problema que causaba que la salida de `docker run` fuera inconsistente cuando se utilizaba `--attach stdout` o `--attach stderr` frente a `stdin`. `docker run --attach stdin` ahora sale si el contenedor sale. [docker/cli#5662](https://github.com/docker/cli/pull/5662)
- Corregir la configuración rootless de Docker con `subid` respaldado por módulos NSS. [moby/moby#49036](https://github.com/moby/moby/pull/49036)
- Los scripts de completado generados a partir de la CLI ahora muestran descripciones junto a cada sugerencia de comando/bandera. [docker/cli#5756](https://github.com/docker/cli/pull/5756)
- Las direcciones IPv6 que muestra `docker ps` en las asociaciones de puertos están ahora entre corchetes. [docker/cli#5363](https://github.com/docker/cli/pull/5363)
- Implementar el método de validación de puertos para Compose. [docker/cli#5524](https://github.com/docker/cli/pull/5524)
- Mejorar la salida de error para banderas no válidas en la línea de comandos. [docker/cli#5233](https://github.com/docker/cli/pull/5233)
- Mejorar los errores al fallar el inicio de un contenedor utilizando el espacio de nombres de red de otro contenedor. [moby/moby#49367](https://github.com/moby/moby/pull/49367)
- Mejorar el manejo de errores de API no válidos que podían dar como resultado que se mostrara un mensaje de error vacío. [moby/moby#49373](https://github.com/moby/moby/pull/49373)
- Mejorar la salida y la consistencia para (sub)comandos desconocidos y argumentos no válidos. [docker/cli#5234](https://github.com/docker/cli/pull/5234)
- Mejorar la validación de `exec-opts` en la configuración del daemon. [moby/moby#48979](https://github.com/moby/moby/pull/48979)
- Actualizar el manejo de la bandera `--gpus=0` para que sea consistente con NVIDIA Container Runtime. [moby/moby#48482](https://github.com/moby/moby/pull/48482)
- `client.ContainerCreate` ahora normaliza los campos `CapAdd` y `CapDrop` en `HostConfig` a su forma canónica. [moby/moby#48551](https://github.com/moby/moby/pull/48551)
- `docker image save` ahora produce marcas de tiempo estables. [moby/moby#48611](https://github.com/moby/moby/pull/48611)
- `docker inspect` ahora te permite inspeccionar las configuraciones de Swarm. [docker/cli#5573](https://github.com/docker/cli/pull/5573)
- Almacén de imágenes de containerd: Añadir soporte para el estado de capa `Extracting` en `docker pull`. [moby/moby#49064](https://github.com/moby/moby/pull/49064)
- Almacén de imágenes de containerd: Corregir que `commit`, `import` y `build` no conservaran una imagen reemplazada como una imagen huérfana. [moby/moby#48316](https://github.com/moby/moby/pull/48316)
- Almacén de imágenes de containerd: Hacer que `docker load --platform` devuelva un error cuando la plataforma solicitada no está cargada. [moby/moby#48718](https://github.com/moby/moby/pull/48718)
- Corregir la validación de la opción `--link`. [docker/cli#5739](https://github.com/docker/cli/pull/5739)
- Añadir la validación de la opción de configuración del daemon network-diagnostic-port. [moby/moby#49305](https://github.com/moby/moby/pull/49305)
- A menos que se configure explícitamente, ya no se reserva una dirección IP para una puerta de enlace (gateway) en los casos en que no es necesaria. A saber, redes bridge “internas” con la opción `com.docker.network.bridge.inhibit_ipv4`, redes `ipvlan` o `macvlan` sin interfaz padre y modos IPvlan L3. [moby/moby#49261](https://github.com/moby/moby/pull/49261)
- Si un controlador de red personalizado reporta la capacidad `GwAllocChecker` entonces, antes de que se cree una red, obtendrá una `GwAllocCheckerRequest` con las opciones de la red. El controlador personalizado puede responder entonces que no se debe asignar ninguna dirección IP de puerta de enlace. [moby/moby#49372](https://github.com/moby/moby/pull/49372)
- Se corrigió un problema por el cual un contenedor no podía asociarse a una IPvlan L3 al mismo tiempo que a otros tipos de red. [moby/moby#49130](https://github.com/moby/moby/pull/49130)
- Eliminar las entradas correctas de `/etc/hosts` al desconectar un contenedor de una red. [moby/moby#48857](https://github.com/moby/moby/pull/48857)
- Corregir eventos duplicados de desconexión de red. [moby/moby#48800](https://github.com/moby/moby/pull/48800)
- Resolver problemas relacionados con el cambio de `fixed-cidr` para `docker0`, y la inferencia de configuración de un puente predeterminado gestionado por el usuario (`--bridge`). [moby/moby#48319](https://github.com/moby/moby/pull/48319)
- Eliminar la bandera de característica `windows-dns-proxy`, introducida en la versión 26.1.0 para controlar el reenvío a resolvedores DNS externos desde contenedores Windows, para hacer que funcione `nslookup`. Se habilitó por defecto en la versión 27.0.0. [moby/moby#48738](https://github.com/moby/moby/pull/48738)
- Eliminar una regla de alteración (mangle) de `iptables` para el cálculo de suma de comprobación de SCTP. La regla se puede volver a habilitar estableciendo `DOCKER_IPTABLES_SCTP_CHECKSUM=1` en el entorno del daemon. Esta anulación se eliminará en una futura versión. [moby/moby#48149](https://github.com/moby/moby/pull/48149)
- Conexión más rápida a las redes bridge, en la mayoría de los casos. [moby/moby#49302](https://github.com/moby/moby/pull/49302)
### Actualizaciones de empaquetado
- Update Go runtime to [1.23.6](https://go.dev/doc/devel/release#go1.23.6). [docker/cli#5795](https://github.com/docker/cli/pull/5795), [moby/moby#49393](https://github.com/moby/moby/pull/49393), [docker/docker-ce-packaging#1161](https://github.com/docker/docker-ce-packaging/pull/1161)
- Actualizar `runc` a [v1.2.5](https://github.com/opencontainers/runc/releases/tag/v1.2.5) (solo binarios estáticos). [moby/moby#49464](https://github.com/moby/moby/pull/49464)
- Actualizar containerd a [v1.7.25](https://github.com/containerd/containerd/releases/tag/v1.7.25). [moby/moby#49252](https://github.com/moby/moby/pull/49252)
- Actualizar BuildKit a [v0.20.0](https://github.com/moby/buildkit/releases/tag/v0.20.0). [moby/moby#49495](https://github.com/moby/moby/pull/49495)
- Actualizar Buildx a [v0.21.0](https://github.com/docker/buildx/releases/tag/v0.21.0). [docker/docker-ce-packaging#1166](https://github.com/docker/docker-ce-packaging/pull/1166)
- Actualizar Compose a [v2.32.4](https://github.com/docker/compose/releases/tag/v2.32.3). [docker/docker-ce-packaging#1143](https://github.com/docker/docker-ce-packaging/pull/1143)
- La fuente canónica para la página de manual `dockerd(8)` se ha trasladado de nuevo al propio repositorio `moby/moby`. [moby/moby#48298](https://github.com/moby/moby/pull/48298)
### Go SDK
- Mejorar la validación de IDs de objetos vacíos. El cliente devuelve ahora un error "Invalid Parameter" cuando se intenta utilizar un ID o nombre vacío. Esto cambia el error devuelto por algunas funciones "Inspect" de un error "Not found" a "Invalid Parameter". [moby/moby#49381](https://github.com/moby/moby/pull/49381)
- `Client.ImageBuild()` omite ahora los valores predeterminados de la cadena de consulta de la solicitud a la API. [moby/moby#48651](https://github.com/moby/moby/pull/48651)
- `api/types/container`: fusionar `Stats` y `StatsResponse`. [moby/moby#49287](https://github.com/moby/moby/pull/49287)
- `client.WithVersion`: eliminar el prefijo v al establecer la versión de la API. [moby/moby#49352](https://github.com/moby/moby/pull/49352)
- `client`: añadir `WithTraceOptions` que permite especificar opciones de traza personalizadas de OTel. [moby/moby#49415](https://github.com/moby/moby/pull/49415)
- `client`: añadir la interfaz `HijackDialer`. [moby/moby#49388](https://github.com/moby/moby/pull/49388)
- `client`: añadir la interfaz `SwarmManagementAPIClient` para describir todos los métodos de cliente de API relacionados con objetos específicos de Swarm. [moby/moby#49388](https://github.com/moby/moby/pull/49388)
- `client`: las funciones `ImageHistory`, `ImageLoad` e `ImageSave` utilizan ahora opciones funcionales variádicas. [moby/moby#49466](https://github.com/moby/moby/pull/49466)
- `pkg/containerfs`: mover a internal. [moby/moby#48097](https://github.com/moby/moby/pull/48097)
- `pkg/reexec`: puede utilizarse ahora en plataformas distintas de Linux, Windows, macOS y FreeBSD. [moby/moby#49118](https://github.com/moby/moby/pull/49118)
- `api/types/container`: introducir el tipo `CommitResponse`. Actualmente es un alias para `IDResponse`, pero podría convertirse en un tipo distinto en una versión futura. [moby/moby#49444](https://github.com/moby/moby/pull/49444)
- `api/types/container`: introducir el tipo `ExecCreateResponse`. Actualmente es un alias para `IDResponse`, pero podría convertirse en un tipo distinto en una versión futura. [moby/moby#49444](https://github.com/moby/moby/pull/49444)
### API
- Actualizar la versión de la API a [v1.48](https://docs-docker.esdocu.com/engine/api/v1.48/). [moby/moby#48476](https://github.com/moby/moby/pull/48476)
- La respuesta `GET /images/{name}/json` devuelve ahora el campo `Manifests` que contiene información sobre los submanifiestos contenidos en el índice de la imagen. Esto incluye elementos como manifiestos específicos de plataforma y atestaciones de compilación. [moby/moby#48264](https://github.com/moby/moby/pull/48264)
- `POST /containers/create` admite ahora un `Mount` de tipo `image` para montar una imagen dentro de un contenedor. [moby/moby#48798](https://github.com/moby/moby/pull/48798)
- `GET /images/{name}/history` admite ahora un parámetro `platform` (tipo OCI Platform codificado en JSON) que permite especificar una plataforma de la cual mostrar el historial. [moby/moby#48295](https://github.com/moby/moby/pull/48295)
- `POST /images/{name}/load` y `GET /images/{name}/get` admiten ahora un parámetro `platform` (tipo OCI Platform codificado en JSON) que permite especificar una plataforma que cargar/guardar. No pasar este parámetro da como resultado la carga/guardado de la imagen multiplataforma completa. [moby/moby#48295](https://github.com/moby/moby/pull/48295)
- Mejorar los errores para anchura/altura no válidas en el redimensionamiento de contenedores y de procesos ejecutados (exec). [moby/moby#48679](https://github.com/moby/moby/pull/48679)
- El endpoint `POST /containers/create` incluye ahora una advertencia en la respuesta al establecer la opción `VolumeDriver` a nivel de contenedor en combinación con volúmenes definidos a través de `Mounts` porque la opción `VolumeDriver` no tiene efecto en esos volúmenes. Esta advertencia la generaba anteriormente la CLI. [moby/moby#48789](https://github.com/moby/moby/pull/48789)
- Almacén de imágenes de containerd: las respuestas `GET /images/json` y `GET /images/{name}/json` incluyen ahora el campo `Descriptor`, que contiene un descriptor OCI del destino de la imagen. El nuevo campo solo se completa si el daemon proporciona un almacén de imágenes multiplataforma. [moby/moby#48894](https://github.com/moby/moby/pull/48894)
- Almacén de imágenes de containerd: `GET /containers/{name}/json` devuelve ahora un campo `ImageManifestDescriptor` que contiene el descriptor OCI del manifiesto de imagen específico de la plataforma de la imagen que se utilizó para crear el contenedor. [moby/moby#48855](https://github.com/moby/moby/pull/48855)
- Los endpoints de depuración (`GET /debug/vars`, `GET /debug/pprof/`, `GET /debug/pprof/cmdline`, `GET /debug/pprof/profile`, `GET /debug/pprof/symbol`, `GET /debug/pprof/trace`, `GET /debug/pprof/{name}`) son ahora también accesibles a través de las rutas de API con versión (`/v/`). [moby/moby#49051](https://github.com/moby/moby/pull/49051)
- Corregir que la API devuelva un código de estado `500` en lugar de `400` para errores de validación. [moby/moby#49217](https://github.com/moby/moby/pull/49217)
- Corregir los códigos de estado para los endpoints de archivo `HEAD /containers/{name:.*}/archive`, `GET /containers/{name:.*}/archive`, `PUT /containers/{name:.*}/archive` que devolvían un estado `500` en lugar de `400`. [moby/moby#49219](https://github.com/moby/moby/pull/49219)
- `POST /containers/create` acepta ahora una opción `writable-cgroups=true` en `HostConfig.SecurityOpt` para montar los cgroups del contenedor como editables. Esto proporciona un enfoque más granular que `HostConfig.Privileged`. [moby/moby#48828](https://github.com/moby/moby/pull/48828)
- `POST /build/prune` renombra `keep-bytes` a `reserved-space` y admite ahora parámetros adicionales de limpieza `max-used-space` y `min-free-space`. [moby/moby#48720](https://github.com/moby/moby/pull/48720)
- `POST /networks/create` tiene ahora un campo `EnableIPv4`. Establecerlo en `false` desactiva el IPAM de IPv4 para la red. [moby/moby#48271](https://github.com/moby/moby/pull/48271)
- `GET /networks/{id}` devuelve ahora un campo `EnableIPv4` que muestra si la red tiene activado el IPAM de IPv4. [moby/moby#48271](https://github.com/moby/moby/pull/48271)
- Las redes bridge definidas por el usuario requieren que esté habilitada la asignación de direcciones IPv4 o IPv6. IPv4 no se puede deshabilitar para la red bridge predeterminada (`docker0`). [moby/moby#48323](https://github.com/moby/moby/pull/48323)
- Las redes `macvlan` e `ipvlan` se pueden crear con la asignación de direcciones desactivada para IPv4, IPv6 o ambas familias de direcciones. [moby/moby#48299](https://github.com/moby/moby/pull/48299)
- IPv4 no se puede deshabilitar para redes de Windows o Swarm. [moby/moby#48278](https://github.com/moby/moby/pull/48278)
- Añadir una forma de especificar qué red debe proporcionar la puerta de enlace predeterminada para un contenedor. [moby/moby#48936](https://github.com/moby/moby/pull/48936)
- `POST /networks/{id}/connect` y `POST /containers/create` aceptan ahora un campo `GwPriority` en `EndpointsConfig`. Este valor se utiliza para determinar qué endpoint de red proporciona la puerta de enlace predeterminada para el contenedor. Se selecciona el endpoint con la prioridad más alta. Si varios endpoints tienen la misma prioridad, se ordenan lexicográficamente por su nombre de red, y se elige el primero. [moby/moby#48746](https://github.com/moby/moby/pull/48746)
- `GET /containers/json` devuelve ahora un campo `GwPriority` en `NetworkSettings` para cada endpoint de red. La CLI utiliza el campo `GwPriority` mediante la nueva opción `gw-priority` para `docker run` y `docker network connect`. [moby/moby#48746](https://github.com/moby/moby/pull/48746)
- Los ajustes para `eth0` en las opciones de `--sysctl` ya no se migran automáticamente al endpoint de red. [moby/moby#48746](https://github.com/moby/moby/pull/48746)
- Por ejemplo, en la CLI de Docker, `docker run --network mynet --sysctl net.ipv4.conf.eth0.log_martians=1 ...` se rechaza. En su lugar, debes usar `docker run --network name=mynet,driver-opt=com.docker.network.endpoint.sysctls=net.ipv4.conf.IFNAME.log_martians=1 ...`
- `GET /containers/json` devuelve ahora un campo `ImageManifestDescriptor` que coincide con el mismo campo en `/containers/{name}/json`. Este campo solo se completa si el daemon proporciona un almacén de imágenes multiplataforma. [moby/moby#49407](https://github.com/moby/moby/pull/49407)
### Eliminado
- La opción del registrador fluentd `fluentd-async-connect` se deprecio en la versión 20.10 y ahora se ha eliminado. [moby/moby#46114](https://github.com/moby/moby/pull/46114)
- La opción `--time` en `docker stop` y `docker restart` está depreciada y se ha renombrado a `--timeout`. [docker/cli#5485](https://github.com/docker/cli/pull/5485)
- SDK de Go: `pkg/ioutils`: eliminar `NewReaderErrWrapper` ya que nunca se utilizó. [moby/moby#49258](https://github.com/moby/moby/pull/49258)
- SDK de Go: `pkg/ioutils`: eliminar los depreciados `BytesPipe`, `NewBytesPipe`, `ErrClosed`, `WriteCounter`, `NewWriteCounter`, `NewReaderErrWrapper`, `NopFlusher`. [moby/moby#49245](https://github.com/moby/moby/pull/49245)
- SDK de Go: `pkg/ioutils`: eliminar los depreciados `NopWriter` y `NopWriteCloser`. [moby/moby#49256](https://github.com/moby/moby/pull/49256)
- SDK de Go: `pkg/sysinfo`: eliminar el depreciado `NumCPU`. [moby/moby#49242](https://github.com/moby/moby/pull/49242)
- SDK de Go: eliminar `pkg/broadcaster`, ya que solo se utilizaba internamente. [moby/moby#49172](https://github.com/moby/moby/pull/49172)
- SDK de Go: eliminar el tipo de error depreciado `cli.Errors`. [docker/cli#5549](https://github.com/docker/cli/pull/5549)
- Eliminar `pkg/ioutils.ReadCloserWrapper`, ya que solo se utilizaba en pruebas. [moby/moby#49237](https://github.com/moby/moby/pull/49237)
- Eliminar el parámetro de configuración depreciado `api-cors-header` y la opción `--api-cors-header` de `dockerd`. [moby/moby#48209](https://github.com/moby/moby/pull/48209)
- Eliminar el campo depreciado `APIEndpoint.Version`, el tipo `APIVersion` y las constantes `APIVersion1` y `APIVersion2`. [moby/moby#49004](https://github.com/moby/moby/pull/49004)
- Eliminar el parámetro de configuración depreciado `api-cors-header` y la opción `--api-cors-header` del daemon de Docker. [docker/cli#5437](https://github.com/docker/cli/pull/5437)
- Eliminar el paquete depreciado `pkg/directory`. [moby/moby#48779](https://github.com/moby/moby/pull/48779)
- Eliminar la función depreciada `pkg/dmsg.Dmesg()`. [moby/moby#48109](https://github.com/moby/moby/pull/48109)
- Eliminar el paquete depreciado `image/spec`, que se movió a un módulo independiente (`github.com/moby/docker-image-spec`). [moby/moby#48460](https://github.com/moby/moby/pull/48460)
- Eliminar el código de migración y los errores del controlador de logs depreciado `logentries`. [moby/moby#48891](https://github.com/moby/moby/pull/48891)
- Eliminar el soporte para los plugins de graph-driver externos depreciados. [moby/moby#48072](https://github.com/moby/moby/pull/48072)
- `api/types`: eliminar el campo depreciado `container.ContainerNode` y `ContainerJSONBase.Node`. [moby/moby#48107](https://github.com/moby/moby/pull/48107)
- `api/types`: eliminar alias depreciados: `ImagesPruneReport`, `VolumesPruneReport`, `NetworkCreateRequest`, `NetworkCreate`, `NetworkListOptions`, `NetworkCreateResponse`, `NetworkInspectOptions`, `NetworkConnect`, `NetworkDisconnect`, `EndpointResource`, `NetworkResource`, `NetworksPruneReport`, `ExecConfig`, `ExecStartCheck`, `ContainerExecInspect`, `ContainersPruneReport`, `ContainerPathStat`, `CopyToContainerOptions`, `ContainerStats`, `ImageSearchOptions`, `ImageImportSource`, `ImageLoadResponse`, `ContainerNode`. [moby/moby#48107](https://github.com/moby/moby/pull/48107)
- `libnetwork/iptables`: eliminar los depreciados `IPV`, `Iptables`, `IP6Tables` y `Passthrough()`. [moby/moby#49121](https://github.com/moby/moby/pull/49121)
- `pkg/archive`: eliminar los depreciados `CanonicalTarNameForPath`, `NewTempArchive`, `TempArchive`. [moby/moby#48708](https://github.com/moby/moby/pull/48708)
- `pkg/fileutils`: eliminar el depreciado `GetTotalUsedFds`. [moby/moby#49210](https://github.com/moby/moby/pull/49210)
- `pkg/ioutils`: eliminar `OnEOFReader`, que solo se utilizaba internamente. [moby/moby#49170](https://github.com/moby/moby/pull/49170)
- `pkg/longpath`: eliminar la constante depreciada `Prefix`. [moby/moby#48779](https://github.com/moby/moby/pull/48779)
- `pkg/stringid`: eliminar las funciones depreciadas `IsShortID` y `ValidateID`. [moby/moby#48705](https://github.com/moby/moby/pull/48705)
- `runconfig/opts`: eliminar el depreciado `ConvertKVStringsToMap`. [moby/moby#48102](https://github.com/moby/moby/pull/48102)
- `runconfig`: eliminar los depreciados `ContainerConfigWrapper`, `SetDefaultNetModeIfBlank`, `DefaultDaemonNetworkMode`, `IsPreDefinedNetwork`. [moby/moby#48102](https://github.com/moby/moby/pull/48102)
- `container`: eliminar los depreciados `ErrNameReserved`, `ErrNameNotReserved`. [moby/moby#48728](https://github.com/moby/moby/pull/48728)
- Eliminar el método `Daemon.ContainerInspectCurrent()` y cambiar la firma de `Daemon.ContainerInspect()` para aceptar una estructura `backend.ContainerInspectOptions`. [moby/moby#48672](https://github.com/moby/moby/pull/48672)
- Eliminar los métodos depreciados `Daemon.Exists()` y `Daemon.IsPaused()`. [moby/moby#48723](https://github.com/moby/moby/pull/48723)
### Depreciaciones
- API: Los campos `BridgeNfIptables` y `BridgeNfIp6tables` en la respuesta `GET /info` son ahora siempre `false` y se omitirán en la versión de la API v1.49. El módulo netfilter se carga ahora bajo demanda, y ya no durante el arranque del daemon, haciendo estos campos obsoletos. [moby/moby#49114](https://github.com/moby/moby/pull/49114)
- API: Los campos `error` y `progress` en las respuestas de flujos de datos para endpoints que devuelven una respuesta de progreso JSON, tales como `POST /images/create`, `POST /images/{name}/push` y `POST /build` están depreciados. [moby/moby#49447](https://github.com/moby/moby/pull/49447)
- Los usuarios deben utilizar la información de los campos `errorDetail` y `progressDetail` en su lugar.
- Estos campos se marcaron como depreciados en la API v1.4 (docker v0.6.0) y la API v1.8 (docker v0.7.1) respectivamente, pero se seguían devolviendo.
- Estos campos se dejarán vacíos o se omitirán en una futura versión de la API.
- Depreciar `Daemon.Register()`. Esta función no se utiliza y se eliminará en la próxima versión. [moby/moby#48702](https://github.com/moby/moby/pull/48702)
- Depreciar la función `client.ImageInspectWithRaw` en favor de la nueva `client.ImageInspect`. [moby/moby#48264](https://github.com/moby/moby/pull/48264)
- Depreciar `daemon/config.Config.ValidatePlatformConfig()`. Este método se utilizaba como ayuda para `config.Validate`, que debería usarse en su lugar. [moby/moby#48985](https://github.com/moby/moby/pull/48985)
- Depreciar `pkg/reexec`. Este paquete está depreciado y se ha movido a un módulo independiente. Utiliza `github.com/moby/sys/reexec` en su lugar. [moby/moby#49129](https://github.com/moby/moby/pull/49129)
- Depreciar la configuración para subir artefactos no distribuibles. [docker/cli#5724](https://github.com/docker/cli/pull/5724)
- Depreciar la bandera del daemon `--allow-nondistributable-artifacts` y el correspondiente campo `allow-nondistributable-artifacts` en `daemon.json`. Establecer cualquiera de las dos opciones ya no tendrá efecto, pero se añade un registro de advertencia de depreciación. [moby/moby#49065](https://github.com/moby/moby/pull/49065)
- Depreciar los campos `RegistryConfig.AllowNondistributableArtifactsCIDRs` y `RegistryConfig.AllowNondistributableArtifactsHostnames` en la respuesta de la API `GET /info`. Para las versiones de API v1.48 y anteriores, los campos se siguen incluyendo en la respuesta, pero siempre son `null`. En la versión de la API v1.49 y posteriores, el campo se omitirá por completo. [moby/moby#49065](https://github.com/moby/moby/pull/49065)
- SDK de Go: depreciar el campo `registry.ServiceOptions.AllowNondistributableArtifacts`. [moby/moby#49065](https://github.com/moby/moby/pull/49065)
- SDK de Go: Los campos `BridgeNfIptables`, `BridgeNfIp6tables` en `api/types/system.Info` y los campos `BridgeNFCallIPTablesDisabled`, `BridgeNFCallIP6TablesDisabled` en `pkg/sysinfo.SysInfo` están depreciados y se eliminarán en la próxima versión. [moby/moby#49114](https://github.com/moby/moby/pull/49114)
- SDK de Go: `client`: depreciar la interfaz `CommonAPIClient` en favor de la interfaz `APIClient`. `CommonAPIClient` cambiará a un alias de `APIClient` en la próxima versión, y se eliminará en la siguiente. [moby/moby#49388](https://github.com/moby/moby/pull/49388)
- SDK de Go: `client`: depreciar el ayudante `ErrorConnectionFailed`. Esta función solo se utilizaba internamente y se eliminará en la próxima versión. [moby/moby#49389](https://github.com/moby/moby/pull/49389)
- SDK de Go: `pkg/ioutils`: depreciar `NewAtomicFileWriter`, `AtomicWriteFile`, `AtomicWriteSet`, `NewAtomicWriteSet` en favor de los equivalentes de `pkg/atomicwriter`. [moby/moby#49171](https://github.com/moby/moby/pull/49171)
- SDK de Go: `pkg/sysinfo`: depreciar `NumCPU`. Esta utilidad tiene el mismo comportamiento que `runtime.NumCPU`. [moby/moby#49241](https://github.com/moby/moby/pull/49241)
- SDK de Go: `pkg/system`: depreciar `MkdirAll`. Esta función proporcionaba un manejo personalizado para las rutas de volumen GUID de Windows. El soporte para tales rutas está ahora soportado por la biblioteca estándar de Go en go1.22 y posteriores, y esta función es ahora un alias para `os.MkdirAll`, que debería usarse en su lugar. Este alias se eliminará en la próxima versión. [moby/moby#49162](https://github.com/moby/moby/pull/49162)
- SDK de Go: depreciar `pkg/parsers.ParseKeyValueOpt`. [moby/moby#49177](https://github.com/moby/moby/pull/49177)
- SDK de Go: depreciar `pkg/parsers.ParseUintListMaximum`, `pkg/parsers.ParseUintList`. Estas utilidades solo se utilizaban internamente y se eliminarán en la próxima versión. [moby/moby#49222](https://github.com/moby/moby/pull/49222)
- SDK de Go: depreciar `api/type.IDResponse` en favor de `container.CommitResponse` y `container.ExecCreateResponse`, que son actualmente un alias, pero podrían convertirse en tipos distintos en una futura versión. Este tipo se eliminará en la próxima versión. [moby/moby#49446](https://github.com/moby/moby/pull/49446)
- SDK de Go: depreciar `api/types/container.ContainerUpdateOKBody` en favor de `UpdateResponse`. Este tipo se eliminará en la próxima versión. [moby/moby#49442](https://github.com/moby/moby/pull/49442)
- SDK de Go: depreciar `api/types/container.ContainerTopOKBody` en favor de `TopResponse`. Este tipo se eliminará en la próxima versión. [moby/moby#49442](https://github.com/moby/moby/pull/49442)
- SDK de Go: `pkg/jsonmessage`: corregir la depreciación de `ProgressMessage`, `ErrorMessage`, que se depreciaron en Docker v0.6.0 y v0.7.1 respectivamente. [moby/moby#49447](https://github.com/moby/moby/pull/49447)
- Mover `GraphDriverData` de `api/types` a `api/types/storage`. El tipo antiguo está depreciado y se eliminará en la próxima versión. [moby/moby#48108](https://github.com/moby/moby/pull/48108)
- Mover `RequestPrivilegeFunc` de `api/types` a `api/types/registry`. El tipo antiguo está depreciado y se eliminará en la próxima versión. [moby/moby#48119](https://github.com/moby/moby/pull/48119)
- Mover de `api/types` a `api/types/container` - `NetworkSettings`, `NetworkSettingsBase`, `DefaultNetworkSettings`, `SummaryNetworkSettings`, `Health`, `HealthcheckResult`, `NoHealthcheck`, `Starting`, `Healthy` y las constantes `Unhealthy`, `MountPoint`, `Port`, `ContainerState`, `Container`, `ContainerJSONBase`, `ContainerJSON`, `ContainerNode`. Los tipos antiguos están depreciados y se eliminarán en la próxima versión. [moby/moby#48108](https://github.com/moby/moby/pull/48108)
- Mover de `api/types` a `api/types/image` - `ImageInspect`, `RootFS`. Los tipos antiguos están depreciados y se eliminarán en la próxima versión. [moby/moby#48108](https://github.com/moby/moby/pull/48108)
- Los campos `ContainerdCommit.Expected`, `RuncCommit.Expected` y `InitCommit.Expected` en el endpoint `GET /info` están depreciados y se omitirán en la API v1.49. [moby/moby#48478](https://github.com/moby/moby/pull/48478)
- El campo `api/types/system/Commit.Expected` está depreciado y ya no debería utilizarse. [moby/moby#48478](https://github.com/moby/moby/pull/48478)
- `daemon/graphdriver`: depreciar `GetDriver()`. [moby/moby#48079](https://github.com/moby/moby/pull/48079)
- `libnetwork/iptables`: depreciar `Passthrough`. Esta función solo se utilizaba internamente y se eliminará en la próxima versión. [moby/moby#49115](https://github.com/moby/moby/pull/49115)
- La función `pkg/directory.Size()` está depreciada y se eliminará en la próxima versión. [moby/moby#48057](https://github.com/moby/moby/pull/48057)
- `registry`: depreciar `APIEndpoint.TrimHostName`; el nombre de host se recorta ahora incondicionalmente para nombres remotos. Este campo se eliminará en la próxima versión. [moby/moby#49005](https://github.com/moby/moby/pull/49005)
- Campo `allow-nondistributable-artifacts` en `daemon.json`. Establecer cualquier opción ya no tendrá efecto, pero se añade un log de advertencia de depreciación para concienciar sobre la depreciación. Está previsto que esta advertencia se convierta en un error en la próxima versión. [moby/moby#49065](https://github.com/moby/moby/pull/49065)
[Docker image spec]: https://github.com/moby/docker-image-spec/blob/v1.3.1/specs-go/v1/image.go#L19-L32
[OCI Image Spec]: https://github.com/opencontainers/image-spec/blob/v1.1.0/specs-go/v1/config.go#L24-L62