jramseye / docker-migrate

Script to migrate docker data

Docker-Migrate

This script allows the user to easily migrate images, volumes, and containers from one version of Docker to another. With the script, users can quickly save all their data from the current docker instance, change the docker storage backend, and then import all their old data to the new system.

./docker-migrate export [directory]

Specify the directory in which to temporarily store the files (can be an existing directory, or the command will create one)

The export command will export all the current images, volumes, and containers to the specified directory, in the /images, /volumes, /containers subdirectories.

./docker-migrate import [directory]

Specify the directory from which to read the files (must be an existing directory)

The import command will import images, volumes, and containers from the specified directory into the new docker instance.

Jenny Ramseyer, 2015

docker-migrate's Issues

Import broken

Currently can't import the volume data--I have not yet implemented how to unpack the tarred data.

Cover intermediate image

#docker images will hide the intermediate image by default (-a option is false), so use #docker images -a would be better.
For how to generate intermediate image:
#docker pull fedora
#docker run fedora --> assume the generated container named $TMP
#docker commit $TMP fedora
#docker images will only show the new fedora, but
#docker images -a will show the hidden <none>:<none> which is the original "fedora" image

RFE: Misc functions enhencement.

Those are inspired during i want to export and import those
images whose docker make build uses. If some of them have
been covered or this is not a right place to talk about them, feel free
correct me. :)

1.Support specified images import and export
(one or multiple specified images)

2.Provide an error recover method.
If an import or export returns error, records images info,
and then list them after the whole process finished.

Display help and usage message

If I type docker-migrate.py, I get following. I should instead get a help message with various options.

./docker-migrate.py

Traceback (most recent call last):
File "./docker-migrate.py", line 8, in
if sys.argv[1] == "export" :
IndexError: list index out of range

Handle <none>:<none> image

Trying to save a : image by name and tag will fail.
For how to generate a : image
#docker pull fedora
#docker run fedora
#docker commit $created_above fedora
#docker images -a

I'm not sure if need open another issue, but if use "saving by id", we also need cover those images which have the same id, like
#docker tag fedora same_id
#docker images
then you will see fedora and same_id id are same

The way gets image info could be broken.

Once a image CREATED includes something like
About one hour ago, it may brake if (i % 8 == 0):

Misc issues

• README.md seems to explain atomic command while it should be talking about how to use docker-migrate.
• I ran docker-migrate.sh without any option and it exited without any message on the console. Put an help message. Also do error handling if right arguments are not passed in.
• I ran script with one subcommand "export" and it did something. But I have no idea where did it save images.

[root@vm2-f22 rhvgoyal-docker-migrate]# ./docker-migrate.sh export
d2a0ecffe6fa
ded7cd95e059
tar: Removing leading `/' from member names
/var/lib/docker/volumes/

• While images are being saved it would be nice to give more informative message like. "Saving image "
• There seems to be this unnecessary warning about remving leading /.
  tar: Removing leading `/' from member names
  /var/lib/docker/volumes/