8567: Rename docker19-migrate to migrate-docker19 for consistency with
[arvados.git] / docker / migrate-docker19 / 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 arvados/docker/migrate-docker19/build.sh to create
11 arvados/migrate-docker19 Docker image.
12
13 2) Set ARVADOS_API_HOST and ARVADOS_API_TOKEN to the cluster you want to migrate.
14
15 3) Run arv-migrate-docker19
16
17 This will query Arvados for v1 format Docker images.  For each image that does
18 not already have a corresponding v2 format image (as indicated by a
19 docker_image_migration tag) it will perform the following process:
20
21 i) download the image from Arvados
22 ii) load it into Docker
23 iii) update the Docker version, which updates the image
24 iv) save the v2 format image and upload to Arvados
25 v) create a migration link