github.com/docker/docker@v299999999.0.0-20200612211812-aaf470eca7b5+incompatible/image/spec/README.md (about)

     1  # Docker Image Specification v1.
     2  
     3  This directory contains documents about Docker Image Specification v1.X.
     4  
     5  The v1 file layout and manifests are no longer used in Moby and Docker, except in `docker save` and `docker load`.
     6  
     7  However, v1 Image JSON (`application/vnd.docker.container.image.v1+json`) has been still widely
     8  used and officially adopted in [V2 manifest](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md)
     9  and in [OCI Image Format Specification](https://github.com/opencontainers/image-spec).
    10  
    11  ## v1.X rough Changelog
    12  
    13  All 1.X versions are compatible with older ones.
    14  
    15  ### [v1.2](v1.2.md)
    16  
    17  * Implemented in Docker v1.12 (July, 2016)
    18  * The official spec document was written in August 2016 ([#25750](https://github.com/moby/moby/pull/25750))
    19  
    20  Changes:
    21  
    22  * `Healthcheck` struct was added to Image JSON
    23  
    24  ### [v1.1](v1.1.md)
    25  
    26  * Implemented in Docker v1.10 (February, 2016)
    27  * The official spec document was written in April 2016 ([#22264](https://github.com/moby/moby/pull/22264))
    28  
    29  Changes:
    30  
    31  * IDs were made into SHA256 digest values rather than random values
    32  * Layer directory names were made into deterministic values rather than random ID values
    33  * `manifest.json` was added 
    34  
    35  ### [v1](v1.md)
    36  
    37  * The initial revision
    38  * The official spec document was written in late 2014 ([#9560](https://github.com/moby/moby/pull/9560)), but actual implementations had existed even earlier
    39  
    40  
    41  ## Related specifications
    42  
    43  * [Open Containers Initiative (OCI) Image Format Specification v1.0.0](https://github.com/opencontainers/image-spec/tree/v1.0.0)
    44  * [Docker Image Manifest Version 2, Schema 2](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md)
    45  * [Docker Image Manifest Version 2, Schema 1](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-1.md) (*DEPRECATED*)
    46  * [Docker Registry HTTP API V2](https://docs.docker.com/registry/spec/api/)