Notes de version de Dockerfile

Cette page contient des informations sur les nouvelles fonctionnalités, les améliorations, les problèmes connus et les corrections de bugs dans la référence Dockerfile.

Pour l'utilisation, consultez la page syntaxe du frontend Dockerfile.

1.16.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.16.0

• Support de ADD --checksum pour les URL Git. moby/buildkit#5975
• Autorisation des espaces dans les heredocs. moby/buildkit#5817
• WORKDIR prend maintenant en charge SOURCE_DATE_EPOCH. moby/buildkit#5960
• Conservation de la variable d'environnement PATH par défaut définie par l'image de base pour WCOW. moby/buildkit#5895

1.15.1

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.15.1

• Correction de no scan targets for linux/arm64/v8 lorsque --attest type=sbom est utilisé. moby/buildkit#5941

1.15.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.15.0

• L'erreur de build pour une cible invalide affiche maintenant des suggestions pour les noms possibles corrects. moby/buildkit#5851
• Correction de l'attestation SBOM produisant une erreur pour les cibles Windows. moby/buildkit#5837
• Correction de ARG récursif produisant une boucle infinie lors du traitement d'une requête de contour. moby/buildkit#5823
• Correction de l'analyse de la directive de syntaxe à partir de JSON qui échouerait si le JSON avait d'autres types de données que des chaînes. moby/buildkit#5815
• Correction de la plateforme dans la configuration de l'image étant sous forme non normalisée (régression depuis 1.12). moby/buildkit#5776
• Correction de la copie dans le répertoire de destination lorsque le répertoire n'est pas présent avec WCOW. moby/buildkit#5249

1.14.1

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.14.1

• Normaliser la plateforme dans la configuration de l'image. moby/buildkit#5776

1.14.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.14.0

• COPY --chmod autorise désormais les valeurs non octales. Cette fonctionnalité était auparavant dans le canal labs et est maintenant disponible dans la version principale. moby/buildkit#5734
• Correction de la gestion de la propriété de plateforme OSVersion si elle est définie par l'image de base moby/buildkit#5714
• Correction des erreurs où les métadonnées d'un contexte nommé pouvaient être résolues même si elles n'étaient pas accessibles par la configuration de build actuelle, entraînant des erreurs de build moby/buildkit#5688

1.14.0 (labs)

Important

Le canal des laboratoires vous donne accès à des fonctionnalités expérimentales du Dockerfile qui ne sont pas encore disponibles dans le canal stable.

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker.io/docker/dockerfile-upstream:1.14.0-labs

• Le nouveau drapeau RUN --device=name,[required] permet aux builds de demander que des périphériques CDI soient disponibles pour l'étape de build. Nécessite BuildKit v0.20.0+ moby/buildkit#4056, moby/buildkit#5738

1.13.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.13.0

• Les nouveaux arguments de build intégrés TARGETOSVERSION, BUILDOSVERSION sont disponibles pour les builds Windows, et la valeur TARGETPLATFORM contient désormais également la valeur OSVersion. moby/buildkit#5614
• Autoriser la transmission de la syntaxe pour les frontends externes pour les fichiers commençant par une marque d'ordre des octets (BOM). moby/buildkit#5645
• Le PATH par défaut dans les conteneurs Windows a été mis à jour avec le répertoire powershell.exe. moby/buildkit#5446
• Correction de l'analyse de la directive Dockerfile pour ne pas autoriser de syntaxe invalide. moby/buildkit#5646
• Correction du cas où la commande ONBUILD pouvait s'exécuter deux fois sur une étape héritée. moby/buildkit#5593
• Correction d'un remplacement de contexte nommé manquant possible pour les étapes enfants dans le Dockerfile. moby/buildkit#5596

1.13.0 (labs)

Important

Le canal des laboratoires vous donne accès à des fonctionnalités expérimentales du Dockerfile qui ne sont pas encore disponibles dans le canal stable.

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker.io/docker/dockerfile-upstream:1.13.0-labs

• Correction de la prise en charge des valeurs non octales pour COPY --chmod. moby/buildkit#5626

1.12.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.12.0

• Correction de la description incorrecte dans la ligne d'historique de la configuration de l'image avec plusieurs instructions ARG. moby/buildkit#5508

1.11.1

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.11.1

• Correction de la régression lors de l'utilisation de l'instruction ONBUILD dans les étapes héritées au sein du même Dockerfile. moby/buildkit#5490

1.11.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.11.0

• L'instruction ONBUILD prend désormais en charge les commandes qui font référence à d'autres étapes ou images avec from, telles que COPY --from ou RUN mount=from=.... moby/buildkit#5357
• La vérification de build SecretsUsedInArgOrEnv a été améliorée pour réduire les faux positifs. moby/buildkit#5208
• Une nouvelle vérification de build InvalidDefinitionDescription recommande de formater les commentaires pour les descriptions des arguments de build et des étapes. Il s'agit d'une vérification expérimentale. moby/buildkit#5208, moby/buildkit#5414
• Multiples corrections pour la gestion des erreurs et de la progression de l'instruction ONBUILD. moby/buildkit#5397
• Amélioration du rapport d'erreurs pour les erreurs de drapeau manquant. moby/buildkit#5369
• Amélioration de la sortie de progression pour les valeurs secrètes montées en tant que variables d'environnement. moby/buildkit#5336
• Ajout de l'argument de build intégré TARGETSTAGE pour exposer le nom de l'étape cible (finale) pour le build en cours. moby/buildkit#5431

1.11.0 (labs)

Important

Le canal des laboratoires vous donne accès à des fonctionnalités expérimentales du Dockerfile qui ne sont pas encore disponibles dans le canal stable.

• COPY --chmod prend désormais en charge les valeurs non octales. moby/buildkit#5380

1.10.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.10.0

• Les secrets de build peuvent désormais être montés en tant que variables d'environnement à l'aide de l'option env=VARIABLE. moby/buildkit#5215
• La directive # check autorise désormais un nouvel attribut expérimental pour activer des règles de validation expérimentales comme CopyIgnoredFile. moby/buildkit#5213
• Améliorer la validation des modificateurs non pris en charge pour la substitution de variables. moby/buildkit#5146
• Les instructions ADD et COPY prennent désormais en charge l'interpolation de variables pour les arguments de build pour les valeurs de l'option --chmod. moby/buildkit#5151
• Améliorer la validation de l'option --chmod pour les instructions COPY et ADD. moby/buildkit#5148
• Correction des complétions manquantes pour les attributs de taille et de destination sur les montages. moby/buildkit#5245
• Les annotations OCI sont désormais définies sur l'image de version du frontend Dockerfile. moby/buildkit#5197

1.9.0

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.9.0

• Ajouter de nouvelles règles de validation :
  • SecretsUsedInArgOrEnv
  • InvalidDefaultArgInFrom
  • RedundantTargetPlatform
  • CopyIgnoredFile (expérimental)
  • FromPlatformFlagConstDisallowed
• Nombreuses améliorations des performances pour travailler avec de gros Dockerfiles. moby/buildkit#5067, moby/buildkit#5029
• Correction d'une panique possible lors de la construction d'un Dockerfile sans étapes définies. moby/buildkit#5150
• Correction de l'analyse JSON incorrecte qui pouvait laisser passer des valeurs JSON incorrectes sans produire d'erreur. moby/buildkit#5107
• Correction d'une régression où COPY --link avec un chemin de destination de . pouvait échouer. moby/buildkit#5080

1.8.1

Les notes de version complètes pour cette version sont disponibles sur GitHub.

# syntax=docker/dockerfile:1.8.1

Corrections de bugs et améliorations

• Correction de la gestion des chaînes vides lors de l'expansion des variables. moby/buildkit#5052
• Amélioration du formatage des avertissements de build. moby/buildkit#5037, moby/buildkit#5045, moby/buildkit#5046
• Correction d'une possible sortie invalide pour l'avertissement UndeclaredVariable pour les builds multi-étapes. moby/buildkit#5048

1.8.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.8.0

• L'instruction ADD prend désormais en charge une option --checksum pour la validation de l'intégrité des fichiers. moby/buildkit#4899
• La nouvelle directive # PULL vous permet de tirer une image au début du build, pour améliorer les performances. moby/buildkit#4909
• Les arguments de build peuvent maintenant être utilisés dans les définitions de HEALTHCHECK et ONBUILD. moby/buildkit#4922
• Amélioration de la gestion des erreurs pour la syntaxe des options de montage invalides. moby/buildkit#4907
• Correction d'une régression dans le traitement de ONBUILD pour les images construites avec des versions antérieures de Docker. moby/buildkit#4984

1.7.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.7.0

• Nouvelle directive # check pour exécuter des vérifications sur un Dockerfile. Pour plus d'informations, consultez la référence de la directive # check.
• La complétion de code pour les options de montage a été améliorée pour inclure toutes les options valides. moby/buildkit#4841

1.6.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.6.0

• La nouvelle instruction HEALTHCHECK --timeout vous permet de définir une durée maximale pour l'exécution d'une sonde d'état. moby/buildkit#4118
• Les instructions COPY et ADD prennent désormais en charge un attribut --parents pour préserver la structure des répertoires parents pour les sources copiées. moby/buildkit#4042
• Ajout de la prise en charge de la syntaxe heredoc pour l'instruction ENV. moby/buildkit#4092
• Les instructions COPY et ADD prennent désormais en charge les chemins contenant des caractères génériques avec l'option --from. moby/buildkit#3915
• Ajout de la prise en charge de l'option --chown pour la syntaxe heredoc. moby/buildkit#4098
• Correction d'un problème qui provoquait l'échec des builds lors de la copie de fichiers entre des étapes basées sur des images scratch. moby/buildkit#4093
• Les variables d'environnement définies dans une image ne sont plus évaluées lors du calcul des sommes de contrôle de cache pour les montages de type cache. moby/buildkit#3893

1.5.1

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.5.1

• Amélioration de la gestion des erreurs pour les noms d'images invalides avec les instructions FROM.
• Correction de COPY --from où la source et la destination sont les mêmes.

1.5.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.5.0

• Ajout de la prise en charge de plusieurs plates-formes dans l'instruction FROM
• Ajout de nouvelles variables de plate-forme globales : TARGETPLATFORM, TARGETOS, TARGETARCH, TARGETVARIANT, BUILDPLATFORM, BUILDOS, BUILDARCH, et BUILDVARIANT.
• ARG sans valeur dans un Dockerfile ne sera plus défini sur une chaîne vide. Au lieu de cela, sa valeur est tirée de l'environnement au moment de l'exécution, ou en passant l'argument avec --build-arg.
• Ajout de la prise en charge de la définition d'options de montage de type tmpfs pour RUN à l'aide de l'option --mount=type=tmpfs.
• Ajout de la prise en charge de la définition de la verbosité de la sortie stderr pour les montages de type cache à l'aide de l'option verbose.
• Correction de l'instruction ADD pour qu'elle ne décompresse plus les archives lorsqu'une option --link est également spécifiée.
• Correction d'un problème qui faisait que la variable d'environnement PATH sur Windows contenait des barres obliques (/) au lieu de barres obliques inverses (\).
• Correction d'un problème avec l'instruction COPY --from où un répertoire source était copié avec des autorisations incorrectes.
• Correction d'un problème qui faisait que l'instruction COPY échouait silencieusement à copier des fichiers lors de l'utilisation de caractères génériques et lorsque l'un des chemins correspondants était un répertoire vide.
• Amélioration de la gestion des erreurs lors de la tentative de copie de fichiers dans un répertoire qui est en fait un fichier.

1.4.3

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.4.3

• Correction d'un problème avec les fichiers heredoc vides.

1.4.2

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.4.2

• Correction d'un problème avec l'utilisation de ARG après FROM scratch.
• Correction d'un problème qui pouvait survenir si vous utilisiez ARG avant le premier FROM dans votre Dockerfile.

1.4.1

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.4.1

• Correction d'un problème où COPY --from pouvait ignorer à tort le cache.
• Correction d'un problème de régression dans le traitement de ONBUILD qui affectait les builds docker-py.
• Correction d'un problème avec les documents heredoc contenant des fins de ligne CRLF.
• Amélioration de la gestion des erreurs pour la syntaxe COPY invalide.

1.4.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.4.0

• Ajout de la prise en charge des documents Here.
• Ajout de la prise en charge de RUN --mount=type=cache,sharing=locked.
• Ajout de la prise en charge de RUN --mount=type=cache,from=<stage>.
• Ajout de la prise en charge de RUN --mount=type=cache,required.
• Ajout de la prise en charge de la spécification d'un id pour les montages de cache, pour les partager entre différentes étapes RUN.
• COPY --chmod et ADD --chmod vous permettent de définir les autorisations pour les fichiers et répertoires copiés dans l'image.
• COPY --chown et ADD --chown prennent désormais en charge les variables d'environnement pour les noms d'utilisateur et de groupe.
• COPY --link et ADD --link vous permettent d'effectuer des copies sans aplatir les couches.
• Le nom de la plate-forme de l'étape peut être utilisé comme argument dans l'instruction FROM.
• Correction d'un problème où les constructions multi-plates-formes pouvaient échouer lorsqu'un argument FROM était utilisé.
• Correction d'un problème où ARG n'était pas correctement étendu lorsqu'il était utilisé dans l'instruction FROM.
• Correction d'un problème avec les chemins Windows contenant des espaces.
• Correction d'un problème avec les chemins Windows longs.

1.3.1

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.3.1

• Correction d'un problème qui empêchait l'utilisation de ARG avant FROM dans un Dockerfile.

1.3.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.3.0

• L'instruction FROM prend désormais en charge l'option --platform.
• L'instruction ARG peut maintenant être utilisée avant l'instruction FROM.
• Amélioration des messages d'erreur lors de l'utilisation d'une syntaxe invalide.
• Correction d'un problème où les constructions multi-plates-formes pouvaient échouer si le nom de l'image était omis dans FROM.
• Correction d'un problème où une instruction COPY pouvait être invalidée de manière incorrecte.
• Correction d'un problème où COPY --from pouvait échouer si la source était une étape multi-plate-forme.
• Correction d'un problème où les variables ARG n'étaient pas correctement étendues dans les commandes ONBUILD.

1.2.1

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.2.1

• Correction d'un problème qui pouvait survenir lors de l'utilisation de COPY --from avec WORKDIR.

1.2.0

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.2.0

• Ajout de la prise en charge de RUN --security=insecure.
• Ajout de la prise en charge de RUN --security=sandbox.

1.1.7

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.7

• Correction d'un problème avec COPY --from où le cache pouvait être incorrectement utilisé.

1.1.6

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.6

• Correction d'un problème qui pouvait survenir lors de l'utilisation de COPY --from avec ADD.
• Amélioration des performances de COPY --from lors de la copie de nombreux petits fichiers.

1.1.5

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.5

• Amélioration de la gestion des erreurs pour les noms d'images invalides.
• Correction d'un problème qui pouvait survenir lors de l'utilisation de COPY --from avec des caractères génériques.

1.1.4

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.4

• Amélioration des messages d'erreur lors de l'utilisation d'une syntaxe de montage invalide.

1.1.3

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.3

• Correction d'un problème qui pouvait survenir lors de l'utilisation de COPY --from avec une étape qui n'avait pas été construite.

1.1.2

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.2

• Correction d'un problème avec l'utilisation de ARG dans les commandes ONBUILD.

1.1.1

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.1.1

• Amélioration des performances de COPY --from lors de la copie de gros fichiers.
• Correction d'un problème avec COPY --from où les autorisations pouvaient être incorrectement définies.
• Correction d'un problème où COPY --from pouvait échouer si la source était un lien symbolique.

1.0.32

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.0.32

• Correction d'un problème avec l'utilisation de ARG dans l'instruction FROM.

1.0.31

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.0.31

• Correction d'un problème avec COPY --from où le cache pouvait être incorrectement utilisé.

1.0.30

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.0.30

• Correction d'un problème avec les chemins Windows dans COPY et ADD.
• Correction d'un problème où les constructions multi-plates-formes pouvaient échouer avec COPY --from.
• Correction d'un problème où COPY --from pouvait échouer si la source était un répertoire.

1.0.29

The full release notes for this release are available on GitHub.

# syntax=docker/dockerfile:1.0.29

• Correction d'un problème avec les variables d'environnement dans les commandes ONBUILD.