|
| 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/) |
0 commit comments