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.
- Cambios en la API del motor, consulta el Historial de versiones de la API del motor.
28.5.2
2025-11-05Para 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:
CautionEsta versión contiene correcciones para tres vulnerabilidades de seguridad de alta gravedad en runc:
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
/procarbitrarios.
Correcciones de errores y mejoras
- dockerd-rootless.sh: si slirp4netns no está instalado, intentar usar pasta (passt). moby/moby#51162
Actualizaciones de empaquetado
- Actualizar BuildKit a v0.25.2. moby/moby#51398
- Actualizar el entorno de ejecución de Go a 1.24.9. moby/moby#51387, docker/cli#6613
- Actualizar runc a v1.3.3. moby/moby#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 - SDK de Go: cli/command/image/build: depreciar la utilidad
IsArchive. docker/cli#6560 - SDK de Go: opts: depreciar
ValidateMACAddress. docker/cli#6560 - SDK de Go: opts: depreciar
ListOpts.Delete(). docker/cli#6560
28.5.1
2025-10-08Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Correcciones de errores y mejoras
- Actualizar BuildKit a v0.25.1. moby/moby#51137
- Actualizar el entorno de ejecución de Go a 1.24.8. moby/moby#51133, docker/cli#6541
Depreciaciones
- api/types/image: InspectResponse: depreciar los campos
ParentyDockerVersion. moby/moby#51105 - api/types/plugin: depreciar el campo
Config.DockerVersion. moby/moby#51110
28.5.0
2025-10-02Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
WarningDepreciació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 infopor enlaces simbólicos rotos en directorios de plugins de la CLI. docker/cli#6476 - Corregir un pánico durante
statsen un evento conActor.IDvacío. docker/cli#6471
Actualizaciones de empaquetado
- Eliminar soporte para conjuntos de cifrado CBC heredados. docker/cli#6474
- Actualizar BuildKit a v0.25.0. moby/moby#51075
- Actualizar la sintaxis de Dockerfile a v1.19.0. moby/moby#51075
Redes
- Eliminar la advertencia inofensiva sobre la eliminación de
endpoint_countdel almacén de datos. moby/moby#51064 - Corregir un error que causaba que los plugins de IPAM no se cargaran en Windows. moby/moby#51035
API
- Depreciar el soporte para la contabilidad TCP de memoria del kernel (
KernelMemoryTCP). moby/moby#51067 - Corregir que
GET containers/{name}/checkpointsdevuelvanullen lugar de una matriz JSON vacía cuando no hay puntos de control (checkpoints). moby/moby#51052
SDK de Go
- cli-plugins/plugin: Run: permitir personalizar la CLI. docker/cli#6481
- cli/command: añadir la opción
WithUserAgent. docker/cli#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 - 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 - 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 - SDK de Go: cli/command: depreciar la utilidad
ResolveDefaultContext. docker/cli#6529 - SDK de Go: cli/command: depreciar las opciones
WithContentTrustFromEnvyWithContentTrust. Estas opciones se utilizaban internamente y se eliminarán en la próxima versión. docker/cli#6489 - SDK de Go: cli/manifest/store: depreciar
IsNotFound(). docker/cli#6514 - SDK de Go: templates: depreciar la función
NewParse(). docker/cli#6469
28.4.0
2025-09-03Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Nuevas características
- Permitir que la CLI de Docker establezca la variable de entorno
GODEBUGcuando el par clave-valor ("GODEBUG":"...") existe dentro de los metadatos del contexto de docker. docker/cli#6399
Correcciones de errores y mejoras
- Añadir completado de la terminal para
docker pullydocker image pull. docker/cli#6420 - Corregir una regresión en la v28.3.3 que podía causar un pánico al ejecutar
docker pushsi el cliente no enviaba una cabeceraX-Registry-Auth. moby/moby#50738 - Windows: Solucionar potencialmente un problema con el error "acceso denegado" al descargar imágenes. moby/moby#50871
- Almacén de imágenes de containerd: Corregir que
docker historyfallara consnapshot X does not existal llamarlo en una imagen no nativa que fue compilada localmente. moby/moby#50875 - Almacén de imágenes de containerd: Corregir que
docker image pruneemita los eventos correctosuntagydeletey liste solo los resúmenes raíz de las imágenes eliminadas en lugar de cada blob. moby/moby#50837 - Eliminar el prompt de inicio de sesión interactivo de
docker pushydocker pulldespués de un fallo causado por la falta de autenticación. docker/cli#6256
Actualizaciones de empaquetado
- Actualizar BuildKit a v0.24.0. moby#50888
- Actualizar el entorno de ejecución de Go a 1.24.7. moby/moby#50889, docker/cli#6422
- Actualizar
runca v1.3.0. moby/moby#50699 - Actualizar containerd (solo binarios estáticos) a v1.7.28. moby/moby#50700
Redes
- Corregir un problema que podía causar un reinicio lento del contenedor al realizar la restauración en vivo. moby/moby#50829
API
- Actualizar el mensaje de depreciación para el campo
AuthConfig.Email. moby/moby#50797
SDK de Go
- Depreciar el paquete profiles que se migró a github.com/moby/profiles. moby/moby#50513
Depreciaciones
- Depreciar el manejo especial para valores entrecomillados para las banderas de línea de comandos
--tlscacert,--tlscerty--tlskey. docker/cli#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 - SDK de Go: Depreciar el campo
NetworkSettingsBase.Bridge, la estructuraNetworkSettingsBase, todos los campos deDefaultNetworkSettingsy la estructuraDefaultNetworkSettings. moby/moby#50839 - SDK de Go: api/types:
build.CacheDiskUsage,container.DiskUsage,images.DiskUsageyvolumes.DiskUsageestán ahora depreciados y se eliminarán en la próxima versión principal. moby/moby#50768 - SDK de Go: cli-plugins/manager: depreciar
ReexecEnvvar. docker/cli#6411 - SDK de Go: cli-plugins/manager: depreciar los alias de anotación (
CommandAnnotationPlugin,CommandAnnotationPluginVendor,CommandAnnotationPluginVersion,CommandAnnotationPluginInvalid,CommandAnnotationPluginCommandPath) en favor de sus equivalentes encli-plugins/manager/metadata. docker/cli#6298 - SDK de Go: cli-plugins/manager: depreciar los alias de metadatos (
NamePrefix,MetadataSubcommandName,HookSubcommandName,Metadata,ReexecEnvvar) en favor de sus equivalentes encli-plugins/manager/metadata. docker/cli#6269 - SDK de Go: cli-plugins/manager: eliminar la interfaz
Candidate, que era solo para uso interno. docker/cli#6269 - SDK de Go: cli-plugins/manager: eliminar la función
NewPluginError, que era solo para uso interno. docker/cli#6269 - SDK de Go: cli-plugins/manager: eliminar la constante depreciada
ResourceAttributesEnvvar. docker/cli#6269 - SDK de Go: cli/command/builder: depreciar
NewBuilderCommandyNewBakeStubCommand. Estas funciones se eliminarán en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/builder: depreciar
NewPruneCommand. docker/cli#6343 - SDK de Go: cli/command/checkpoint: depreciar
NewCheckpointCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/checkpoint: depreciar
NewFormat,FormatWrite. docker/cli#6341 - SDK de Go: cli/command/completion: depreciar
NoComplete. docker/cli#6405 - SDK de Go: cli/command/completion: eliminar el depreciado
ValidArgsFn. docker/cli#6259 - SDK de Go: cli/command/config: depreciar
NewConfigCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/config: depreciar
NewFormat,FormatWrite,InspectFormatWrite. docker/cli#6341 - SDK de Go: cli/command/config: depreciar
RunConfigCreate,CreateOptions,RunConfigInspect,InspectOptions,RunConfigList,ListOptions,RunConfigRemoveyRemoveOptions. docker/cli#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 - 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 - 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 - SDK de Go: cli/command/context: depreciar
NewContextCommand. This function will be removed in the next release. docker/cli#6312 - SDK de Go: cli/command/context: depreciar
RunCreateyCreateOptions. docker/cli#6403 - SDK de Go: cli/command/context: depreciar
RunExportyExportOptions. docker/cli#6403 - SDK de Go: cli/command/context: depreciar
RunImport. docker/cli#6403 - SDK de Go: cli/command/context: depreciar
RunRemoveyRemoveOptions. docker/cli#6403 - SDK de Go: cli/command/context: depreciar
RunUpdateyUpdateOptions. docker/cli#6403 - SDK de Go: cli/command/context: depreciar
RunUse. docker/cli#6403 - SDK de Go: cli/command/image: depreciar la utilidad
AuthResolver. docker/cli#6357 - SDK de Go: cli/command/image: depreciar
NewHistoryFormat,HistoryWrite. docker/cli#6341 - SDK de Go: cli/command/manifest: depreciar
NewManifestCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/network: depreciar
NewFormat,FormatWrite. docker/cli#6341 - SDK de Go: cli/command/network: depreciar
NewNetworkCommand. Estas funciones se eliminarán en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/node: depreciar
NewFormat,FormatWrite,InspectFormatWrite. docker/cli#6341 - SDK de Go: cli/command/node: depreciar
NewNodeCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/plugin: depreciar
NewFormat,FormatWrite. docker/cli#6341 - SDK de Go: cli/command/plugin: depreciar
NewPluginCommand. Esta función se eliminará en la próxima versión. docker/cli#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 - SDK de Go: cli/command/registry: depreciar
NewSearchFormat,SearchWrite. docker/cli#6341 - SDK de Go: cli/command/registry: depreciar la constante
OauthLoginEscapeHatchEnvVar. docker/cli#6413 - SDK de Go: cli/command/secret: depreciar
NewFormat,FormatWrite,InspectFormatWrite. docker/cli#6341 - SDK de Go: cli/command/secret: depreciar
NewSecretCommand. Estas funciones se eliminarán en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/service: depreciar
NewFormat,InspectFormatWrite. docker/cli#6341 - SDK de Go: cli/command/service: depreciar
NewServiceCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/stack: depreciar
NewStackCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/stack: depreciar
RunList,RunServices. docker/cli#6391 - SDK de Go: cli/command/swarm: depreciar
NewSwarmCommand. Esta función se eliminará en la próxima versión. docker/cli#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 - SDK de Go: cli/command/task: depreciar
NewTaskFormat,FormatWrite. docker/cli#6341 - SDK de Go: cli/command/trust: depreciar
NewTrustCommand. Esta función se eliminará en la próxima versión. docker/cli#6312 - SDK de Go: cli/command/trust: depreciar
SignedTagInfo,SignerInfo,NewTrustTagFormat,NewSignerInfoFormat,TagWrite,SignerInfoWrite. docker/cli#6341 - SDK de Go: cli/command/volume: depreciar
NewVolumeCommand,NewPruneCommand. Estas funciones se eliminarán en la próxima versión. docker/cli#6312 - SDK de Go: cli/command: eliminar las utilidades
AddTrustSigningFlags,AddTrustVerificationFlagsyAddPlatformFlag, que se utilizaban solo internamente. docker/cli#6311 - SDK de Go: cli/command: eliminar la utilidad depreciada
ConfigureAuth. docker/cli#6257 - SDK de Go: cli/command: eliminar la utilidad depreciada
CopyToFile. docker/cli#6257 - SDK de Go: cli/config/types: actualizar el mensaje de depreciación para el campo
AuthConfig.Email. docker/cli#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 - SDK de Go: cli: eliminar la utilidad
HasCompletionArg. Esta utilidad solo se utilizaba internamente. docker/cli#6276 - SDK de Go: depreciar
cli/command.RegistryAuthenticationPrivilegedFunc. docker/cli#6256 - SDK de Go: depreciar cli/command/stack/formatter. docker/cli#6391
- SDK de Go: depreciar cli/command/stack/loader. docker/cli#6391
- SDK de Go: depreciar cli/command/stack/options. docker/cli#6391
- SDK de Go: depreciar cli/command/stack/swarm. docker/cli#6391
- SDK de Go: opts: depreciar
NewNamedListOptsRef,NewNamedMapOpts,NamedListOpts,NamedMapOptsyNamedOption. Estos tipos y funciones ya no se utilizan y se eliminarán en la próxima versión. docker/cli#6292 - SDK de Go: opts: depreciar
ParseEnvFileen favor dekvfile.Parse. docker/cli#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 - 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 - SDK de Go: pkg/jsonmessage: depreciar los campos
JSONMessage.From,JSONMessage.TimeyJSONMessage.TimeNano, ya que la API ya no los devuelve para mensajes de progreso. Utiliza el tipoevents.Messageen su lugar para deserializar la respuesta de/events. moby/moby#50762 - SDK de Go: el paquete cli/registry/client está depreciado y se eliminará en la próxima versión. docker/cli#6313
28.3.3
2025-07-29Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
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 / GHSA-x4rx-4gw3-53p4 / moby/moby#50506.
Actualizaciones de empaquetado
- Actualizar Buildx a v0.26.1. docker/docker-ce-packaging#1230
- Actualizar Compose a v2.39.1. docker/docker-ce-packaging#1234
- Actualizar el plugin Docker Model CLI a v0.1.36. docker/docker-ce-packaging#1233
28.3.2
2025-07-09Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Correcciones de errores y mejoras
- Corregir que
--use-api-socketno funcionara correctamente al dirigirse a un daemon remoto. docker/cli#6157 - Corregir que se imprimieran logs de "otel error" perdidos si el log de depuración está activado. docker/cli#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
- Advertir cuando
DOCKER_AUTH_CONFIGestá establecido durantedocker loginydocker logout. docker/cli#6163
Actualizaciones de empaquetado
- Actualizar Compose a v2.38.2. docker/docker-ce-packaging#1225
- Actualizar el plugin Docker Model CLI a v0.1.33. docker/docker-ce-packaging#1227
- Actualizar el entorno de ejecución de Go a 1.24.5. moby/moby#50354
28.3.1
2025-07-02Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Actualizaciones de empaquetado
- Actualizar BuildKit a v0.23.2. moby/moby#50309
- Actualizar Compose a v2.38.1. docker/docker-ce-packaging#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
28.3.0
2025-06-24Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Nuevas características
- Añadir soporte para GPUs AMD en
docker run --gpus. moby/moby#49952 - Utilizar
DOCKER_AUTH_CONFIGcomo almacén de credenciales. docker/cli#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) esté al día cuando el contenedor se detiene utilizando la API /containers/{id}/stop (antes de la respuesta de la API). moby/moby#50136
- Corregir que
docker image inspectomita campos vacíos. moby/moby#50135 - Corregir que
docker images --treeno marque las imágenes como en uso cuando el almacén de imágenes de containerd está desactivado. docker/cli#6140 - Corregir que
docker pull/pushse cuelgue en modo no interactivo cuando se requiere autenticación, debido a la solicitud de credenciales de inicio de sesión. docker/cli#6141 - Corregir una posible fuga de recursos cuando un nodo sale de un Swarm. moby/moby#50115
- Corregir un problema por el cual un prompt de inicio de sesión en
docker pullmostraba sugerencias específicas de Docker Hub al iniciar sesión en otros registros. docker/cli#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
- Eliminar un comando de nivel superior
docker removeoculto y no documentado que se introdujo accidentalmente en Docker 23.0. docker/cli#6144 - Validar la configuración de registry-mirrors como parte de
dockerd --validatey mejorar los mensajes de error para espejos no válidos. moby/moby#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- Almacén de imágenes de containerd: Corregir que
docker pushno cree una etiqueta en el repositorio remoto. moby/moby#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
Actualizaciones de empaquetado
- Permitir personalizar el nombre del servicio de containerd para OpenRC. moby/moby#50156
- Actualizar BuildKit a v0.23.1. moby/moby#50243
- Actualizar Buildx a v0.25.0. docker/docker-ce-packaging#1217
- Actualizar Compose a v2.37.2. docker/docker-ce-packaging#1219
- Actualizar el plugin Docker Model CLI a v0.1.30. docker/docker-ce-packaging#1218
- Actualizar el entorno de ejecución de Go a 1.24.4. docker/docker-ce-packaging#1213, moby/moby#50153, docker/cli#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
- Revertir: Corregir un problema por el cual
docker network inspect --verbosea 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).
- Revertir: Corregir un problema por el cual
- 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.0y otros están mapeados a direcciones específicas del host. moby/moby#50054 - La respuesta de
network inspectpara una red overlay ahora reporta queEnableIPv4es true. moby/moby#50147 - Windows: Mejorar el tiempo de inicio del daemon en casos donde el host tiene redes de tipo
"Mirrored". moby/moby#50155 - Windows: Asegurar que
docker system pruneydocker network prunesolo eliminen redes creadas por Docker. moby/moby#50154
API
- Actualizar la versión de la API a 1.51. moby/moby#50145
GET /images/jsonahora establece el valor del campoContainerspara todas las imágenes al recuento de contenedores que usan la imagen. moby/moby#50146
Depreciaciones
- Los campos de configuración de imagen vacíos/nulos en la respuesta
GET /images/{name}/jsonahora están depreciados y se eliminarán en la v29.0. docker/cli#6129 - api/types/container: depreciar
ExecOptions.Detach. Este campo no se utiliza y se eliminará en una versión futura. moby/moby#50219 - pkg/idtools: depreciar
IdentityMappingyIdentity.Chown. moby/moby#50210
28.2.2
2025-05-30Para 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:
Bug fixes and enhancements
- Almacén de imágenes de containerd: Corregir una regresión que causaba que
docker build --pushfallara. Esto revierte la corrección para quedocker buildno persistiera las imágenes sobrescritas como huérfanas (dangling). moby/moby#50105
Redes
- Al crear la cadena de iptables
DOCKER-USER, no añadir una reglaRETURNexplí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
28.2.1
2025-05-29Actualizaciones de empaquetado
- Corregir una regresión de empaquetado en la v28.2.0 que impedía la creación del grupo/usuario
dockeren instalaciones nuevas. docker-ce-packaging#1209
28.2.0
2025-05-28Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
NoteLos 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 paradocker pspara mostrar la plataforma de la imagen que el contenedor está ejecutando. docker/cli#6042 - Añadir soporte para rutas padre relativas (
../) en los orígenes de montaje bind cuando se utilizadocker run/createcon las opciones-v/--volumeo--mount type=bind. docker/cli#4966 - CDI está ahora activado por defecto. moby/moby#49963
- Mostrar los dispositivos CDI descubiertos en
docker info. docker/cli#6078 docker image rm: añadir la opción--platformpara eliminar una variante de imágenes multiplataforma. docker/cli#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
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 - Añadir soporte para
DOCKER_AUTH_CONFIGpara la opción experimental--use-api-socket. docker/cli#6019 - Corregir que
docker execesperara durante 10 segundos si se especificaba un usuario o grupo no existente. moby/moby#49868 - Corregir que
docker swarm initignorara la opcióncacertde--external-ca. docker/cli#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 - Corregir que los contenedores con política
--restart alwaysutilizando dispositivos CDI fallaran al iniciarse tras el reinicio del daemon. moby/moby#49990 - Corregir el completado en la terminal para completar solo algunas banderas una vez, aunque se puedan establecer varias veces. docker/cli#6030
- Corregir el error
plugin does not implement PluginAddr interfacepara los controladores Swarm CSI. moby/moby#49961 - Mejorar los mensajes de error de
docker loginpara opciones no válidas. docker/cli#6036 - Asegurar que el estado del terminal se restaure si la CLI se termina a la fuerza. docker/cli#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,removexattratysetxattrat. Esto evita que los contenedores reciban errores EPERM al utilizarlas. moby/moby#50077 docker inspect: añadir completado en la terminal, mejorar la descripción de la bandera para--typey mejorar la validación. docker/cli#6052- Almacén de imágenes de containerd: Habilitar el recolector de basura de BuildKit por defecto. moby/moby#49899
- Almacén de imágenes de containerd: Corregir que
docker buildno persistiera las imágenes sobrescritas como huérfanas (dangling). moby/moby#49702 - Almacén de imágenes de containerd: Corregir que
docker system dfreportara una cantidad negativa de espacio recuperable. moby/moby#49707 - Almacén de imágenes de containerd: Corregir solicitudes
PUTduplicadas al subir una imagen multiplataforma. moby/moby#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
- Corregir la ubicación de instalación para las páginas man de
docker-cebasadas en RPM. docker/docker-ce-packaging#1203 - Actualizar BuildKit a v0.22.0. moby/moby#50046
- Actualizar Buildx a v0.24.0. docker/docker-ce-packaging#1205
- Actualizar Compose a v2.36.2. docker/docker-ce-packaging#1208
- Actualizar el entorno de ejecución de Go a 1.24.3. docker/docker-ce-packaging#1192, docker/cli#6060, moby/moby#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 - 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 - No mostrar las opciones de red
com.docker.network.enable_ipv4ocom.docker.network.enable_ipv6en la salida del inspect si han sido anuladas porEnableIPv4oEnableIPv6en la solicitud de creación de red. moby/moby#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
- Corregir un problema por el cual
docker network inspect --verbosea veces podía bloquear el daemon. moby/moby#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
- Mejorar la confiabilidad de NetworkDB en clusters ocupados y redes con pérdidas. moby/moby#49932
- Mejoras en la confiabilidad y la velocidad de convergencia de NetworkDB. moby/moby#49939
API
DELETE /images/{name}admite ahora un parámetro de consultaplatforms. Acepta un array de objetos OCI Platform codificados en JSON, lo que permite seleccionar plataformas específicas de las cuales eliminar contenido. moby/moby#49982GET /infoincluye ahora un campoDiscoveredDevices. Se trata de un array de objetosDeviceInfo, cada uno de los cuales proporciona detalles sobre un dispositivo descubierto por un controlador de dispositivos. moby/moby#49980
SDK de Go
api/types/container: añadirContainerStatey constantes para el estado del contenedor. moby/moby#49965api/types/container: cambiarSummary.StateaContainerState. moby/moby#49991api/types/container: definir el tipoHealthStatuspara constantes de estado de salud. moby/moby#49876api/types: depreciarBuildResult,ImageBuildOptions,ImageBuildOutput,ImageBuildResponse,BuilderVersion,BuilderV1yBuilderBuildKi, que se movieron aapi/types/build. moby/moby#50025
Depreciaciones
- API: Depreciado:
GET /images/{name}/jsonya 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 - SDK de Go: Depreciado:
builder/remotecontext.Rel(). Esta función era necesaria en versiones anteriores de Go, pero ahora puede reemplazarse porfilepath.Rel(). moby/moby#49843 - SDK de Go: api/types: depreciar
BuildCachePruneOptionsen favor deapi/types/builder.CachePruneOptions. moby/moby#50015 - SDK de Go: api/types: depreciar
BuildCachePruneReporten favor deapi/types/builder.CachePruneReport. moby/moby#50015 - SDK de Go: api/types: depreciar
NodeListOptions,NodeRemoveOptions,ServiceCreateOptions,ServiceUpdateOptions,RegistryAuthFromSpec,RegistryAuthFromPreviousSpec,ServiceListOptions,ServiceInspectOptionsySwarmUnlockKeyResponseque se movieron aapi/types/swarm. moby/moby#50027 - SDK de Go: api/types: depreciar
SecretCreateResponse,SecretListOptions,ConfigCreateResponse,ConfigListOptionsque se movieron aapi/types/swarm. moby/moby#50024 - SDK de Go: client: depreciar
IsErrNotFound. moby/moby#50012 - SDK de Go: container: depreciar
IsValidHealthStringen favor deapi/types/container.ValidateHealthStatus. moby/moby#49893 - SDK de Go: container: depreciar
StateStatus,WaitConditiony las constantes relacionadasWaitConditionNotRunning,WaitConditionNextExityWaitConditionRemoveden favor de sus equivalentes enapi/types/container. moby/moby#49874 - SDK de Go: opts: depreciar
ListOpts.GetAllen favor deListOpts.GetSlice. docker/cli#6032 - Eliminar el marcador de posición de formato depreciado
IsAutomateddedocker search. docker/cli#6091 - Eliminar alternativa para descargar imágenes del registro no conforme con OCI
docker.pkg.github.com. moby/moby#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, moby/moby#42300 - Los campos
BridgeNfIptablesyBridgeNfIp6tablesen la respuestaGET /infose depreciaron en la API v1.48 y ahora se omiten en la API v1.50. moby/moby#49904 - errdefs: Depreciar
errdefs.FromStatusCode. Utilizarerrhttp.ToNativede containerd en su lugar. moby/moby#50030
28.1.1
2025-04-18Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Correcciones de errores y mejoras
- Corregir que
dockerd-rootless-setuptool.shreportara incorrectamente la falta deiptables. moby/moby#49833 - Almacén de imágenes de containerd: Corregir una posible caída del daemon al usar
docker loadcon imágenes de la plataforma incorrecta. moby/moby#49835
Actualizaciones de empaquetado
- Actualizar Go runtime a 1.23.6 (estaba en 1.23.5 en la versión 28.1.0). moby/moby#49393, docker/cli#5795
28.1.0
2025-04-09Para obtener una lista completa de las solicitudes de extracción y los cambios en esta versión, consulta los hitos correspondientes en GitHub:
Correcciones de errores y mejoras
- Añadir la dirección de loopback IPv6 como un registro no seguro por defecto. moby/moby#48540
- Añadir soporte para scripts de completado generados por Cobra para
dockerd. moby/moby#49339 - Corregir fallos en las consultas DNS cuando los contenedores se inician a través del auto-inicio de
systemden el arranque. moby/moby#48812 - Corregir que el modo Docker Swarm ignorara
volume.subpath. docker/cli#5833 - Corregir que
docker exportcontinuara la exportación después de cancelar la operación. moby/moby#49265 - Corregir que
docker exportno liberara la capa de escritura del contenedor tras un fallo. moby/moby#48517 - Corregir que
docker images --treetruncara innecesariamente nombres de imágenes largos cuando hay varios nombres disponibles. docker/cli#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
- Corregir un problema que impedía que algunas direcciones IPv6 mostradas por
docker psestuvieran correctamente entre corchetes. docker/cli#5468 - Corregir un error que impedía cancelar las descargas de imágenes durante
docker run. docker/cli#5645 - Corregir el manejo de errores al ejecutar el daemon como un servicio de Windows para evitar salidas incorrectas. moby/moby#48518
- Corregir un problema que causaba que la salida de
docker runfuera inconsistente cuando se utilizaba--attach stdouto--attach stderrfrente astdin.docker run --attach stdinahora sale si el contenedor sale. docker/cli#5662 - Corregir la configuración rootless de Docker con
subidrespaldado por módulos NSS. moby/moby#49036 - Los scripts de completado generados a partir de la CLI ahora muestran descripciones junto a cada sugerencia de comando/bandera. docker/cli#5756
- Las direcciones IPv6 que muestra
docker psen las asociaciones de puertos están ahora entre corchetes. docker/cli#5363 - Implementar el método de validación de puertos para Compose. docker/cli#5524
- Mejorar la salida de error para banderas no válidas en la línea de comandos. docker/cli#5233
- Mejorar los errores al fallar el inicio de un contenedor utilizando el espacio de nombres de red de otro contenedor. moby/moby#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
- Mejorar la salida y la consistencia para (sub)comandos desconocidos y argumentos no válidos. docker/cli#5234
- Mejorar la validación de
exec-optsen la configuración del daemon. moby/moby#48979 - Actualizar el manejo de la bandera
--gpus=0para que sea consistente con NVIDIA Container Runtime. moby/moby#48482 client.ContainerCreateahora normaliza los camposCapAddyCapDropenHostConfiga su forma canónica. moby/moby#48551docker image saveahora produce marcas de tiempo estables. moby/moby#48611docker inspectahora te permite inspeccionar las configuraciones de Swarm. docker/cli#5573- Almacén de imágenes de containerd: Añadir soporte para el estado de capa
Extractingendocker pull. moby/moby#49064 - Almacén de imágenes de containerd: Corregir que
commit,importybuildno conservaran una imagen reemplazada como una imagen huérfana. moby/moby#48316 - Almacén de imágenes de containerd: Hacer que
docker load --platformdevuelva un error cuando la plataforma solicitada no está cargada. moby/moby#48718 - Corregir la validación de la opción
--link. docker/cli#5739 - Añadir la validación de la opción de configuración del daemon network-diagnostic-port. moby/moby#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, redesipvlanomacvlansin interfaz padre y modos IPvlan L3. moby/moby#49261 - Si un controlador de red personalizado reporta la capacidad
GwAllocCheckerentonces, antes de que se cree una red, obtendrá unaGwAllocCheckerRequestcon 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 - 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
- Eliminar las entradas correctas de
/etc/hostsal desconectar un contenedor de una red. moby/moby#48857 - Corregir eventos duplicados de desconexión de red. moby/moby#48800
- Resolver problemas relacionados con el cambio de
fixed-cidrparadocker0, y la inferencia de configuración de un puente predeterminado gestionado por el usuario (--bridge). moby/moby#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 funcionenslookup. Se habilitó por defecto en la versión 27.0.0. moby/moby#48738 - Eliminar una regla de alteración (mangle) de
iptablespara el cálculo de suma de comprobación de SCTP. La regla se puede volver a habilitar estableciendoDOCKER_IPTABLES_SCTP_CHECKSUM=1en el entorno del daemon. Esta anulación se eliminará en una futura versión. moby/moby#48149 - Conexión más rápida a las redes bridge, en la mayoría de los casos. moby/moby#49302
Actualizaciones de empaquetado
- Update Go runtime to 1.23.6. docker/cli#5795, moby/moby#49393, docker/docker-ce-packaging#1161
- Actualizar
runca v1.2.5 (solo binarios estáticos). moby/moby#49464 - Actualizar containerd a v1.7.25. moby/moby#49252
- Actualizar BuildKit a v0.20.0. moby/moby#49495
- Actualizar Buildx a v0.21.0. docker/docker-ce-packaging#1166
- Actualizar Compose a v2.32.4. docker/docker-ce-packaging#1143
- La fuente canónica para la página de manual
dockerd(8)se ha trasladado de nuevo al propio repositoriomoby/moby. moby/moby#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
Client.ImageBuild()omite ahora los valores predeterminados de la cadena de consulta de la solicitud a la API. moby/moby#48651api/types/container: fusionarStatsyStatsResponse. moby/moby#49287client.WithVersion: eliminar el prefijo v al establecer la versión de la API. moby/moby#49352client: añadirWithTraceOptionsque permite especificar opciones de traza personalizadas de OTel. moby/moby#49415client: añadir la interfazHijackDialer. moby/moby#49388client: añadir la interfazSwarmManagementAPIClientpara describir todos los métodos de cliente de API relacionados con objetos específicos de Swarm. moby/moby#49388client: las funcionesImageHistory,ImageLoadeImageSaveutilizan ahora opciones funcionales variádicas. moby/moby#49466pkg/containerfs: mover a internal. moby/moby#48097pkg/reexec: puede utilizarse ahora en plataformas distintas de Linux, Windows, macOS y FreeBSD. moby/moby#49118api/types/container: introducir el tipoCommitResponse. Actualmente es un alias paraIDResponse, pero podría convertirse en un tipo distinto en una versión futura. moby/moby#49444api/types/container: introducir el tipoExecCreateResponse. Actualmente es un alias paraIDResponse, pero podría convertirse en un tipo distinto en una versión futura. moby/moby#49444
API
- Actualizar la versión de la API a v1.48. moby/moby#48476
- La respuesta
GET /images/{name}/jsondevuelve ahora el campoManifestsque 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 POST /containers/createadmite ahora unMountde tipoimagepara montar una imagen dentro de un contenedor. moby/moby#48798GET /images/{name}/historyadmite ahora un parámetroplatform(tipo OCI Platform codificado en JSON) que permite especificar una plataforma de la cual mostrar el historial. moby/moby#48295POST /images/{name}/loadyGET /images/{name}/getadmiten ahora un parámetroplatform(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- Mejorar los errores para anchura/altura no válidas en el redimensionamiento de contenedores y de procesos ejecutados (exec). moby/moby#48679
- El endpoint
POST /containers/createincluye ahora una advertencia en la respuesta al establecer la opciónVolumeDrivera nivel de contenedor en combinación con volúmenes definidos a través deMountsporque la opciónVolumeDriverno tiene efecto en esos volúmenes. Esta advertencia la generaba anteriormente la CLI. moby/moby#48789 - Almacén de imágenes de containerd: las respuestas
GET /images/jsonyGET /images/{name}/jsonincluyen ahora el campoDescriptor, 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 - Almacén de imágenes de containerd:
GET /containers/{name}/jsondevuelve ahora un campoImageManifestDescriptorque 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 - 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<versión-API>/<endpoint>). moby/moby#49051 - Corregir que la API devuelva un código de estado
500en lugar de400para errores de validación. moby/moby#49217 - Corregir los códigos de estado para los endpoints de archivo
HEAD /containers/{name:.*}/archive,GET /containers/{name:.*}/archive,PUT /containers/{name:.*}/archiveque devolvían un estado500en lugar de400. moby/moby#49219 POST /containers/createacepta ahora una opciónwritable-cgroups=trueenHostConfig.SecurityOptpara montar los cgroups del contenedor como editables. Esto proporciona un enfoque más granular queHostConfig.Privileged. moby/moby#48828POST /build/prunerenombrakeep-bytesareserved-spacey admite ahora parámetros adicionales de limpiezamax-used-spaceymin-free-space. moby/moby#48720POST /networks/createtiene ahora un campoEnableIPv4. Establecerlo enfalsedesactiva el IPAM de IPv4 para la red. moby/moby#48271GET /networks/{id}devuelve ahora un campoEnableIPv4que muestra si la red tiene activado el IPAM de IPv4. moby/moby#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 - Las redes
macvlaneipvlanse pueden crear con la asignación de direcciones desactivada para IPv4, IPv6 o ambas familias de direcciones. moby/moby#48299 - IPv4 no se puede deshabilitar para redes de Windows o Swarm. moby/moby#48278
- Añadir una forma de especificar qué red debe proporcionar la puerta de enlace predeterminada para un contenedor. moby/moby#48936
POST /networks/{id}/connectyPOST /containers/createaceptan ahora un campoGwPriorityenEndpointsConfig. 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#48746GET /containers/jsondevuelve ahora un campoGwPriorityenNetworkSettingspara cada endpoint de red. La CLI utiliza el campoGwPrioritymediante la nueva opcióngw-priorityparadocker runydocker network connect. moby/moby#48746
- Los ajustes para
eth0en las opciones de--sysctlya no se migran automáticamente al endpoint de red. moby/moby#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 usardocker run --network name=mynet,driver-opt=com.docker.network.endpoint.sysctls=net.ipv4.conf.IFNAME.log_martians=1 ...
- Por ejemplo, en la CLI de Docker,
GET /containers/jsondevuelve ahora un campoImageManifestDescriptorque 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
Eliminado
- La opción del registrador fluentd
fluentd-async-connectse deprecio en la versión 20.10 y ahora se ha eliminado. moby/moby#46114 - La opción
--timeendocker stopydocker restartestá depreciada y se ha renombrado a--timeout. docker/cli#5485 - SDK de Go:
pkg/ioutils: eliminarNewReaderErrWrapperya que nunca se utilizó. moby/moby#49258 - SDK de Go:
pkg/ioutils: eliminar los depreciadosBytesPipe,NewBytesPipe,ErrClosed,WriteCounter,NewWriteCounter,NewReaderErrWrapper,NopFlusher. moby/moby#49245 - SDK de Go:
pkg/ioutils: eliminar los depreciadosNopWriteryNopWriteCloser. moby/moby#49256 - SDK de Go:
pkg/sysinfo: eliminar el depreciadoNumCPU. moby/moby#49242 - SDK de Go: eliminar
pkg/broadcaster, ya que solo se utilizaba internamente. moby/moby#49172 - SDK de Go: eliminar el tipo de error depreciado
cli.Errors. docker/cli#5549 - Eliminar
pkg/ioutils.ReadCloserWrapper, ya que solo se utilizaba en pruebas. moby/moby#49237 - Eliminar el parámetro de configuración depreciado
api-cors-headery la opción--api-cors-headerdedockerd. moby/moby#48209 - Eliminar el campo depreciado
APIEndpoint.Version, el tipoAPIVersiony las constantesAPIVersion1yAPIVersion2. moby/moby#49004 - Eliminar el parámetro de configuración depreciado
api-cors-headery la opción--api-cors-headerdel daemon de Docker. docker/cli#5437 - Eliminar el paquete depreciado
pkg/directory. moby/moby#48779 - Eliminar la función depreciada
pkg/dmsg.Dmesg(). moby/moby#48109 - Eliminar el paquete depreciado
image/spec, que se movió a un módulo independiente (github.com/moby/docker-image-spec). moby/moby#48460 - Eliminar el código de migración y los errores del controlador de logs depreciado
logentries. moby/moby#48891 - Eliminar el soporte para los plugins de graph-driver externos depreciados. moby/moby#48072
api/types: eliminar el campo depreciadocontainer.ContainerNodeyContainerJSONBase.Node. moby/moby#48107api/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#48107libnetwork/iptables: eliminar los depreciadosIPV,Iptables,IP6TablesyPassthrough(). moby/moby#49121pkg/archive: eliminar los depreciadosCanonicalTarNameForPath,NewTempArchive,TempArchive. moby/moby#48708pkg/fileutils: eliminar el depreciadoGetTotalUsedFds. moby/moby#49210pkg/ioutils: eliminarOnEOFReader, que solo se utilizaba internamente. moby/moby#49170pkg/longpath: eliminar la constante depreciadaPrefix. moby/moby#48779pkg/stringid: eliminar las funciones depreciadasIsShortIDyValidateID. moby/moby#48705runconfig/opts: eliminar el depreciadoConvertKVStringsToMap. moby/moby#48102runconfig: eliminar los depreciadosContainerConfigWrapper,SetDefaultNetModeIfBlank,DefaultDaemonNetworkMode,IsPreDefinedNetwork. moby/moby#48102container: eliminar los depreciadosErrNameReserved,ErrNameNotReserved. moby/moby#48728- Eliminar el método
Daemon.ContainerInspectCurrent()y cambiar la firma deDaemon.ContainerInspect()para aceptar una estructurabackend.ContainerInspectOptions. moby/moby#48672 - Eliminar los métodos depreciados
Daemon.Exists()yDaemon.IsPaused(). moby/moby#48723
Depreciaciones
- API: Los campos
BridgeNfIptablesyBridgeNfIp6tablesen la respuestaGET /infoson ahora siemprefalsey 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 - API: Los campos
erroryprogressen las respuestas de flujos de datos para endpoints que devuelven una respuesta de progreso JSON, tales comoPOST /images/create,POST /images/{name}/pushyPOST /buildestán depreciados. moby/moby#49447- Los usuarios deben utilizar la información de los campos
errorDetailyprogressDetailen 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.
- Los usuarios deben utilizar la información de los campos
- Depreciar
Daemon.Register(). Esta función no se utiliza y se eliminará en la próxima versión. moby/moby#48702 - Depreciar la función
client.ImageInspectWithRawen favor de la nuevaclient.ImageInspect. moby/moby#48264 - Depreciar
daemon/config.Config.ValidatePlatformConfig(). Este método se utilizaba como ayuda paraconfig.Validate, que debería usarse en su lugar. moby/moby#48985 - Depreciar
pkg/reexec. Este paquete está depreciado y se ha movido a un módulo independiente. Utilizagithub.com/moby/sys/reexecen su lugar. moby/moby#49129 - Depreciar la configuración para subir artefactos no distribuibles. docker/cli#5724
- Depreciar la bandera del daemon
--allow-nondistributable-artifactsy el correspondiente campoallow-nondistributable-artifactsendaemon.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 - Depreciar los campos
RegistryConfig.AllowNondistributableArtifactsCIDRsyRegistryConfig.AllowNondistributableArtifactsHostnamesen la respuesta de la APIGET /info. Para las versiones de API v1.48 y anteriores, los campos se siguen incluyendo en la respuesta, pero siempre sonnull. En la versión de la API v1.49 y posteriores, el campo se omitirá por completo. moby/moby#49065 - SDK de Go: depreciar el campo
registry.ServiceOptions.AllowNondistributableArtifacts. moby/moby#49065 - SDK de Go: Los campos
BridgeNfIptables,BridgeNfIp6tablesenapi/types/system.Infoy los camposBridgeNFCallIPTablesDisabled,BridgeNFCallIP6TablesDisabledenpkg/sysinfo.SysInfoestán depreciados y se eliminarán en la próxima versión. moby/moby#49114 - SDK de Go:
client: depreciar la interfazCommonAPIClienten favor de la interfazAPIClient.CommonAPIClientcambiará a un alias deAPIClienten la próxima versión, y se eliminará en la siguiente. moby/moby#49388 - SDK de Go:
client: depreciar el ayudanteErrorConnectionFailed. Esta función solo se utilizaba internamente y se eliminará en la próxima versión. moby/moby#49389 - SDK de Go:
pkg/ioutils: depreciarNewAtomicFileWriter,AtomicWriteFile,AtomicWriteSet,NewAtomicWriteSeten favor de los equivalentes depkg/atomicwriter. moby/moby#49171 - SDK de Go:
pkg/sysinfo: depreciarNumCPU. Esta utilidad tiene el mismo comportamiento queruntime.NumCPU. moby/moby#49241 - SDK de Go:
pkg/system: depreciarMkdirAll. 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 paraos.MkdirAll, que debería usarse en su lugar. Este alias se eliminará en la próxima versión. moby/moby#49162 - SDK de Go: depreciar
pkg/parsers.ParseKeyValueOpt. moby/moby#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 - SDK de Go: depreciar
api/type.IDResponseen favor decontainer.CommitResponseycontainer.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 - SDK de Go: depreciar
api/types/container.ContainerUpdateOKBodyen favor deUpdateResponse. Este tipo se eliminará en la próxima versión. moby/moby#49442 - SDK de Go: depreciar
api/types/container.ContainerTopOKBodyen favor deTopResponse. Este tipo se eliminará en la próxima versión. moby/moby#49442 - SDK de Go:
pkg/jsonmessage: corregir la depreciación deProgressMessage,ErrorMessage, que se depreciaron en Docker v0.6.0 y v0.7.1 respectivamente. moby/moby#49447 - Mover
GraphDriverDatadeapi/typesaapi/types/storage. El tipo antiguo está depreciado y se eliminará en la próxima versión. moby/moby#48108 - Mover
RequestPrivilegeFuncdeapi/typesaapi/types/registry. El tipo antiguo está depreciado y se eliminará en la próxima versión. moby/moby#48119 - Mover de
api/typesaapi/types/container-NetworkSettings,NetworkSettingsBase,DefaultNetworkSettings,SummaryNetworkSettings,Health,HealthcheckResult,NoHealthcheck,Starting,Healthyy las constantesUnhealthy,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 - Mover de
api/typesaapi/types/image-ImageInspect,RootFS. Los tipos antiguos están depreciados y se eliminarán en la próxima versión. moby/moby#48108 - Los campos
ContainerdCommit.Expected,RuncCommit.ExpectedyInitCommit.Expecteden el endpointGET /infoestán depreciados y se omitirán en la API v1.49. moby/moby#48478 - El campo
api/types/system/Commit.Expectedestá depreciado y ya no debería utilizarse. moby/moby#48478 daemon/graphdriver: depreciarGetDriver(). moby/moby#48079libnetwork/iptables: depreciarPassthrough. Esta función solo se utilizaba internamente y se eliminará en la próxima versión. moby/moby#49115- La función
pkg/directory.Size()está depreciada y se eliminará en la próxima versión. moby/moby#48057 registry: depreciarAPIEndpoint.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- Campo
allow-nondistributable-artifactsendaemon.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