59fa6260ad937bbf3645bfc2ed80288d69315431
[arvados.git] / docker / docker19-migrate / README
1 Docker image format migration tool for Arvados.
2
3 This converts Docker images stored in Arvados from image format v1
4 (Docker <= 1.9) to image format v2 (Docker >= 1.10).
5
6 Requires Docker running on the local host.
7
8 Usage:
9
10 1) Run ./build.sh to create arvados/docker19-migrate Docker image.
11
12 2) Set ARVADOS_API_HOST and ARVADOS_API_TOKEN to the cluster you want to migrate.
13
14 3) Run arv-migrate-docker19
15
16 This will query Arvados for v1 format Docker images.  For each image that does
17 not already have a corresponding v2 format image (as indicated by a
18 docker_image_migration tag) it will perform the following process:
19
20 i) download the image from Arvados
21 ii) load it into Docker
22 iii) update the Docker version, which updates the image
23 iv) save the v2 format image and upload to Arvados
24 v) create a migration link