X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/91dc5f1d7f5ad9eb2640f6089e2d0476cbf87c8e..89f10cd956b1282d8d650fd82f945f8169664df9:/doc/_includes/_install_compute_docker.liquid diff --git a/doc/_includes/_install_compute_docker.liquid b/doc/_includes/_install_compute_docker.liquid index 1a2e21c3b3..69b49e83cd 100644 --- a/doc/_includes/_install_compute_docker.liquid +++ b/doc/_includes/_install_compute_docker.liquid @@ -1,3 +1,9 @@ +{% comment %} +Copyright (C) The Arvados Authors. All rights reserved. + +SPDX-License-Identifier: CC-BY-SA-3.0 +{% endcomment %} + h2. Install Docker Compute nodes must have Docker installed to run containers. This requires a relatively recent version of Linux (at least upstream version 3.10, or a distribution version with the appropriate patches backported). Follow the "Docker Engine installation documentation":https://docs.docker.com/ for your distribution. @@ -43,3 +49,31 @@ On Red Hat-based systems, run: Finally, reboot the system to make these changes effective. + +h2. Create a project for Docker images + +Here we create a default project for the standard Arvados Docker images, and give all users read access to it. The project is owned by the system user. + + +
~$ uuid_prefix=`arv --format=uuid user current | cut -d- -f1`
+~$ project_uuid=`arv --format=uuid group create --group "{\"owner_uuid\":\"$uuid_prefix-tpzed-000000000000000\", \"group_class\":\"project\", \"name\":\"Arvados Standard Docker Images\"}"`
+~$ echo "Arvados project uuid is '$project_uuid'"
+~$ read -rd $'\000' newlink <<EOF; arv link create --link "$newlink"
+{
+ "tail_uuid":"$all_users_group_uuid",
+ "head_uuid":"$project_uuid",
+ "link_class":"permission",
+ "name":"can_read"
+}
+EOF
+
+ +h2. Download and tag the latest arvados/jobs docker image + +In order to start workflows from workbench, there needs to be Docker image tagged @arvados/jobs:latest@. The following command downloads the latest arvados/jobs image from Docker Hub, loads it into Keep, and tags it as 'latest'. In this example @$project_uuid@ should be the UUID of the "Arvados Standard Docker Images" project. + + +
~$ arv-keepdocker --pull arvados/jobs latest --project-uuid $project_uuid
+
+ +If the image needs to be downloaded from Docker Hub, the command can take a few minutes to complete, depending on available network bandwidth.