Merge branch '17299-uppercase-api'
[arvados.git] / doc / install / install-jobs-image.html.textile.liquid
1 ---
2 layout: default
3 navsection: installguide
4 title: Install arvados/jobs image
5 ...
6 {% comment %}
7 Copyright (C) The Arvados Authors. All rights reserved.
8
9 SPDX-License-Identifier: CC-BY-SA-3.0
10 {% endcomment %}
11
12 h2. Create a project for Docker images
13
14 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.
15
16 <notextile>
17 <pre><code>~$ <span class="userinput">uuid_prefix=$(arv --format=uuid user current | cut -d- -f1)</span>
18 ~$ <span class="userinput">project_uuid=$(arv --format=uuid group create --group '{"owner_uuid":"'$uuid_prefix'-tpzed-000000000000000", "group_class":"project", "name":"Arvados Standard Docker Images"}')</span>
19 ~$ <span class="userinput">echo "Arvados project uuid is '$project_uuid'"</span>
20 ~$ <span class="userinput">read -rd $'\000' newlink &lt;&lt;EOF; arv link create --link "$newlink"</span>
21 <span class="userinput">{
22  "tail_uuid":"${uuid_prefix}-j7d0g-fffffffffffffff",
23  "head_uuid":"$project_uuid",
24  "link_class":"permission",
25  "name":"can_read"
26 }
27 EOF</span>
28 </code></pre></notextile>
29
30 h2. Import the arvados/jobs docker image
31
32 In order to start workflows from workbench, there needs to be Docker image @arvados/jobs@ tagged with the version of Arvados you are installing. The following command downloads the latest arvados/jobs image from Docker Hub, loads it into Keep.  In this example @$project_uuid@ should be the UUID of the "Arvados Standard Docker Images" project.
33
34 <notextile>
35 <pre><code>~$ <span class="userinput">arv-keepdocker --pull arvados/jobs latest --project-uuid $project_uuid</span>
36 </code></pre></notextile>
37
38 If the image needs to be downloaded from Docker Hub, the command can take a few minutes to complete, depending on available network bandwidth.