| ... | ... |
@@ -534,6 +534,23 @@ func postImagesPush(srv *Server, version float64, w http.ResponseWriter, r *http |
| 534 | 534 |
return nil |
| 535 | 535 |
} |
| 536 | 536 |
|
| 537 |
+func getImagesGet(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
|
|
| 538 |
+ name := vars["name"] |
|
| 539 |
+ err := srv.ImageExport(name, w) |
|
| 540 |
+ if err != nil {
|
|
| 541 |
+ return err |
|
| 542 |
+ } |
|
| 543 |
+ return nil |
|
| 544 |
+} |
|
| 545 |
+ |
|
| 546 |
+func postImagesLoad(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
|
|
| 547 |
+ err := srv.ImageLoad(r.Body) |
|
| 548 |
+ if err != nil {
|
|
| 549 |
+ return err |
|
| 550 |
+ } |
|
| 551 |
+ return nil |
|
| 552 |
+} |
|
| 553 |
+ |
|
| 537 | 554 |
func postContainersCreate(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
|
| 538 | 555 |
if err := parseForm(r); err != nil {
|
| 539 | 556 |
return nil |
| ... | ... |
@@ -1036,6 +1053,7 @@ func createRouter(srv *Server, logging bool) (*mux.Router, error) {
|
| 1036 | 1036 |
"/images/json": getImagesJSON, |
| 1037 | 1037 |
"/images/viz": getImagesViz, |
| 1038 | 1038 |
"/images/search": getImagesSearch, |
| 1039 |
+ "/images/{name:.*}/get": getImagesGet,
|
|
| 1039 | 1040 |
"/images/{name:.*}/history": getImagesHistory,
|
| 1040 | 1041 |
"/images/{name:.*}/json": getImagesByName,
|
| 1041 | 1042 |
"/containers/ps": getContainersJSON, |
| ... | ... |
@@ -1052,6 +1070,7 @@ func createRouter(srv *Server, logging bool) (*mux.Router, error) {
|
| 1052 | 1052 |
"/build": postBuild, |
| 1053 | 1053 |
"/images/create": postImagesCreate, |
| 1054 | 1054 |
"/images/{name:.*}/insert": postImagesInsert,
|
| 1055 |
+ "/images/load": postImagesLoad, |
|
| 1055 | 1056 |
"/images/{name:.*}/push": postImagesPush,
|
| 1056 | 1057 |
"/images/{name:.*}/tag": postImagesTag,
|
| 1057 | 1058 |
"/containers/create": postContainersCreate, |
| ... | ... |
@@ -92,6 +92,7 @@ func (cli *DockerCli) CmdHelp(args ...string) error {
|
| 92 | 92 |
{"insert", "Insert a file in an image"},
|
| 93 | 93 |
{"inspect", "Return low-level information on a container"},
|
| 94 | 94 |
{"kill", "Kill a running container"},
|
| 95 |
+ {"load", "Load an image from a tar archive"},
|
|
| 95 | 96 |
{"login", "Register or Login to the docker registry server"},
|
| 96 | 97 |
{"logs", "Fetch the logs of a container"},
|
| 97 | 98 |
{"port", "Lookup the public-facing port which is NAT-ed to PRIVATE_PORT"},
|
| ... | ... |
@@ -102,6 +103,7 @@ func (cli *DockerCli) CmdHelp(args ...string) error {
|
| 102 | 102 |
{"rm", "Remove one or more containers"},
|
| 103 | 103 |
{"rmi", "Remove one or more images"},
|
| 104 | 104 |
{"run", "Run a command in a new container"},
|
| 105 |
+ {"save", "Save an image to a tar archive"},
|
|
| 105 | 106 |
{"search", "Search for an image in the docker index"},
|
| 106 | 107 |
{"start", "Start a stopped container"},
|
| 107 | 108 |
{"stop", "Stop a running container"},
|
| ... | ... |
@@ -1961,6 +1963,42 @@ func (cli *DockerCli) CmdCp(args ...string) error {
|
| 1961 | 1961 |
return nil |
| 1962 | 1962 |
} |
| 1963 | 1963 |
|
| 1964 |
+func (cli *DockerCli) CmdSave(args ...string) error {
|
|
| 1965 |
+ cmd := Subcmd("save", "IMAGE DESTINATION", "Save an image to a tar archive")
|
|
| 1966 |
+ if err := cmd.Parse(args); err != nil {
|
|
| 1967 |
+ cmd.Usage() |
|
| 1968 |
+ return nil |
|
| 1969 |
+ } |
|
| 1970 |
+ |
|
| 1971 |
+ if cmd.NArg() != 1 {
|
|
| 1972 |
+ cmd.Usage() |
|
| 1973 |
+ return nil |
|
| 1974 |
+ } |
|
| 1975 |
+ |
|
| 1976 |
+ image := cmd.Arg(0) |
|
| 1977 |
+ |
|
| 1978 |
+ if err := cli.stream("GET", "/images/"+image+"/get", nil, cli.out, nil); err != nil {
|
|
| 1979 |
+ return err |
|
| 1980 |
+ } |
|
| 1981 |
+ return nil |
|
| 1982 |
+} |
|
| 1983 |
+ |
|
| 1984 |
+func (cli *DockerCli) CmdLoad(args ...string) error {
|
|
| 1985 |
+ cmd := Subcmd("load", "SOURCE", "Load an image from a tar archive")
|
|
| 1986 |
+ |
|
| 1987 |
+ if cmd.NArg() != 0 {
|
|
| 1988 |
+ cmd.Usage() |
|
| 1989 |
+ return nil |
|
| 1990 |
+ } |
|
| 1991 |
+ |
|
| 1992 |
+ err := cli.stream("POST", "/images/load", cli.in, cli.out, nil)
|
|
| 1993 |
+ if err != nil {
|
|
| 1994 |
+ fmt.Println("Send failed", err)
|
|
| 1995 |
+ } |
|
| 1996 |
+ |
|
| 1997 |
+ return nil |
|
| 1998 |
+} |
|
| 1999 |
+ |
|
| 1964 | 2000 |
func (cli *DockerCli) call(method, path string, data interface{}) ([]byte, int, error) {
|
| 1965 | 2001 |
var params io.Reader |
| 1966 | 2002 |
if data != nil {
|
| ... | ... |
@@ -559,6 +559,17 @@ Known Issues (kill) |
| 559 | 559 |
* :issue:`197` indicates that ``docker kill`` may leave directories |
| 560 | 560 |
behind and make it difficult to remove the container. |
| 561 | 561 |
|
| 562 |
+.. _cli_load: |
|
| 563 |
+ |
|
| 564 |
+``load`` |
|
| 565 |
+-------- |
|
| 566 |
+ |
|
| 567 |
+:: |
|
| 568 |
+ Usage: docker load < repository.tar |
|
| 569 |
+ |
|
| 570 |
+ Loads a tarred repository from the standard input stream. |
|
| 571 |
+ Restores both images and tags. |
|
| 572 |
+ |
|
| 562 | 573 |
.. _cli_login: |
| 563 | 574 |
|
| 564 | 575 |
``login`` |
| ... | ... |
@@ -852,6 +863,17 @@ Known Issues (run -volumes-from) |
| 852 | 852 |
could indicate a permissions problem with AppArmor. Please see the |
| 853 | 853 |
issue for a workaround. |
| 854 | 854 |
|
| 855 |
+.. _cli_save: |
|
| 856 |
+ |
|
| 857 |
+``save`` |
|
| 858 |
+ |
|
| 859 |
+:: |
|
| 860 |
+ |
|
| 861 |
+ Usage: docker save image > repository.tar |
|
| 862 |
+ |
|
| 863 |
+ Streams a tarred repository to the standard output stream. |
|
| 864 |
+ Contains all parent layers, and all tags + versions. |
|
| 865 |
+ |
|
| 855 | 866 |
.. _cli_search: |
| 856 | 867 |
|
| 857 | 868 |
``search`` |
| ... | ... |
@@ -197,6 +197,155 @@ func (srv *Server) ContainerExport(name string, out io.Writer) error {
|
| 197 | 197 |
return fmt.Errorf("No such container: %s", name)
|
| 198 | 198 |
} |
| 199 | 199 |
|
| 200 |
+// ImageExport exports all images with the given tag. All versions |
|
| 201 |
+// containing the same tag are exported. The resulting output is an |
|
| 202 |
+// uncompressed tar ball. |
|
| 203 |
+// name is the set of tags to export. |
|
| 204 |
+// out is the writer where the images are written to. |
|
| 205 |
+func (srv *Server) ImageExport(name string, out io.Writer) error {
|
|
| 206 |
+ // get image json |
|
| 207 |
+ tempdir, err := ioutil.TempDir("", "docker-export-")
|
|
| 208 |
+ if err != nil {
|
|
| 209 |
+ utils.Debugf("save", name, "")
|
|
| 210 |
+ return err |
|
| 211 |
+ } |
|
| 212 |
+ utils.Debugf("Serializing %s", name)
|
|
| 213 |
+ |
|
| 214 |
+ rootRepo := srv.runtime.repositories.Repositories[name] |
|
| 215 |
+ for _, rootImage := range rootRepo {
|
|
| 216 |
+ image, _ := srv.ImageInspect(rootImage) |
|
| 217 |
+ for i := image; i != nil; {
|
|
| 218 |
+ // temporary directory |
|
| 219 |
+ tmpImageDir := path.Join(tempdir, i.ID) |
|
| 220 |
+ os.Mkdir(tmpImageDir, os.ModeDir) |
|
| 221 |
+ |
|
| 222 |
+ // serialize json |
|
| 223 |
+ b, err := json.Marshal(i) |
|
| 224 |
+ if err != nil {
|
|
| 225 |
+ utils.Debugf("%s", err)
|
|
| 226 |
+ os.RemoveAll(tempdir) |
|
| 227 |
+ return err |
|
| 228 |
+ } |
|
| 229 |
+ ioutil.WriteFile(path.Join(tmpImageDir, "json"), b, os.ModeAppend) |
|
| 230 |
+ |
|
| 231 |
+ // serialize filesystem |
|
| 232 |
+ fs, err := Tar(path.Join(srv.runtime.graph.Root, i.ID, "layer"), Uncompressed) |
|
| 233 |
+ if err != nil {
|
|
| 234 |
+ utils.Debugf("%s", err)
|
|
| 235 |
+ os.RemoveAll(tempdir) |
|
| 236 |
+ return err |
|
| 237 |
+ } |
|
| 238 |
+ fsTar, err := os.Create(path.Join(tmpImageDir, "layer.tar")) |
|
| 239 |
+ if err != nil {
|
|
| 240 |
+ os.RemoveAll(tempdir) |
|
| 241 |
+ utils.Debugf("%s", err)
|
|
| 242 |
+ return err |
|
| 243 |
+ } |
|
| 244 |
+ _, err = io.Copy(fsTar, fs) |
|
| 245 |
+ if err != nil {
|
|
| 246 |
+ utils.Debugf("%s", err)
|
|
| 247 |
+ os.RemoveAll(tempdir) |
|
| 248 |
+ return err |
|
| 249 |
+ } |
|
| 250 |
+ fsTar.Close() |
|
| 251 |
+ |
|
| 252 |
+ // find parent |
|
| 253 |
+ if i.Parent != "" {
|
|
| 254 |
+ i, err = srv.ImageInspect(i.Parent) |
|
| 255 |
+ if err != nil {
|
|
| 256 |
+ utils.Debugf("%s", err)
|
|
| 257 |
+ os.RemoveAll(tempdir) |
|
| 258 |
+ return err |
|
| 259 |
+ } |
|
| 260 |
+ } else {
|
|
| 261 |
+ i = nil |
|
| 262 |
+ } |
|
| 263 |
+ } |
|
| 264 |
+ } |
|
| 265 |
+ |
|
| 266 |
+ // write repositories |
|
| 267 |
+ rootRepoMap := map[string]Repository{}
|
|
| 268 |
+ rootRepoMap[name] = rootRepo |
|
| 269 |
+ rootRepoJson, _ := json.Marshal(rootRepoMap) |
|
| 270 |
+ |
|
| 271 |
+ ioutil.WriteFile(path.Join(tempdir, "repositories"), rootRepoJson, os.ModeAppend) |
|
| 272 |
+ |
|
| 273 |
+ fs, err := Tar(tempdir, Uncompressed) |
|
| 274 |
+ if err != nil {
|
|
| 275 |
+ os.RemoveAll(tempdir) |
|
| 276 |
+ return err |
|
| 277 |
+ } |
|
| 278 |
+ if _, err := io.Copy(out, fs); err != nil {
|
|
| 279 |
+ os.RemoveAll(tempdir) |
|
| 280 |
+ return err |
|
| 281 |
+ } |
|
| 282 |
+ os.RemoveAll(tempdir) |
|
| 283 |
+ return nil |
|
| 284 |
+} |
|
| 285 |
+ |
|
| 286 |
+// Loads a set of images into the repository. This is the complementary of ImageExport. |
|
| 287 |
+// The input stream is an uncompressed tar ball containing images and metadata. |
|
| 288 |
+func (srv *Server) ImageLoad(in io.Reader) error {
|
|
| 289 |
+ tmpImageDir, _ := ioutil.TempDir("", "docker-import-")
|
|
| 290 |
+ repoTarFile := path.Join(tmpImageDir, "repo.tar") |
|
| 291 |
+ repoDir := path.Join(tmpImageDir, "repo") |
|
| 292 |
+ tarFile, _ := os.Create(repoTarFile) |
|
| 293 |
+ io.Copy(tarFile, in) |
|
| 294 |
+ tarFile.Close() |
|
| 295 |
+ repoFile, _ := os.Open(repoTarFile) |
|
| 296 |
+ os.Mkdir(repoDir, os.ModeDir) |
|
| 297 |
+ Untar(repoFile, repoDir) |
|
| 298 |
+ repositoriesJson, _ := ioutil.ReadFile(path.Join(tmpImageDir, "repo", "repositories")) |
|
| 299 |
+ repositories := map[string]Repository{}
|
|
| 300 |
+ json.Unmarshal(repositoriesJson, &repositories) |
|
| 301 |
+ |
|
| 302 |
+ for imageName, tagMap := range repositories {
|
|
| 303 |
+ for tag, address := range tagMap {
|
|
| 304 |
+ err := srv.recursiveLoad(address, tmpImageDir) |
|
| 305 |
+ if err != nil {
|
|
| 306 |
+ utils.Debugf("Error loading repository")
|
|
| 307 |
+ } |
|
| 308 |
+ srv.runtime.repositories.Set(imageName, tag, address, true) |
|
| 309 |
+ } |
|
| 310 |
+ } |
|
| 311 |
+ os.RemoveAll(tmpImageDir) |
|
| 312 |
+ return nil |
|
| 313 |
+} |
|
| 314 |
+ |
|
| 315 |
+func (srv *Server) recursiveLoad(address, tmpImageDir string) error {
|
|
| 316 |
+ _, err := srv.ImageInspect(address) |
|
| 317 |
+ utils.Debugf("Attempting to load %s", "address")
|
|
| 318 |
+ if err != nil {
|
|
| 319 |
+ utils.Debugf("Loading %s", address)
|
|
| 320 |
+ imageJson, err := ioutil.ReadFile(path.Join(tmpImageDir, "repo", address, "json")) |
|
| 321 |
+ if err != nil {
|
|
| 322 |
+ return err |
|
| 323 |
+ utils.Debugf("Error reading json", err)
|
|
| 324 |
+ } |
|
| 325 |
+ layer, err := os.Open(path.Join(tmpImageDir, "repo", address, "layer.tar")) |
|
| 326 |
+ if err != nil {
|
|
| 327 |
+ utils.Debugf("Error reading embedded tar", err)
|
|
| 328 |
+ return err |
|
| 329 |
+ } |
|
| 330 |
+ img, err := NewImgJSON(imageJson) |
|
| 331 |
+ if err != nil {
|
|
| 332 |
+ utils.Debugf("Error unmarshalling json", err)
|
|
| 333 |
+ return err |
|
| 334 |
+ } |
|
| 335 |
+ if img.Parent != "" {
|
|
| 336 |
+ if !srv.runtime.graph.Exists(img.Parent) {
|
|
| 337 |
+ srv.recursiveLoad(img.Parent, tmpImageDir) |
|
| 338 |
+ } |
|
| 339 |
+ } |
|
| 340 |
+ err = srv.runtime.graph.Register(imageJson, layer, img) |
|
| 341 |
+ if err != nil {
|
|
| 342 |
+ utils.Debugf("Error registering image")
|
|
| 343 |
+ } |
|
| 344 |
+ } |
|
| 345 |
+ utils.Debugf("Completed processing %s", address)
|
|
| 346 |
+ return nil |
|
| 347 |
+} |
|
| 348 |
+ |
|
| 200 | 349 |
func (srv *Server) ImagesSearch(term string) ([]registry.SearchResult, error) {
|
| 201 | 350 |
r, err := registry.NewRegistry(srv.runtime.config.Root, nil, srv.HTTPRequestFactory(nil)) |
| 202 | 351 |
if err != nil {
|