2 # -*- mode: perl; perl-indent-level: 2; indent-tabs-mode: nil; -*-
6 crunch-job: Execute job steps, save snapshots as requested, collate output.
10 Obtain job details from Arvados, run tasks on compute nodes (typically
11 invoked by scheduler on controller):
13 crunch-job --job x-y-z --git-dir /path/to/repo/.git
15 Obtain job details from command line, run tasks on local machine
16 (typically invoked by application or developer on VM):
18 crunch-job --job '{"script_version":"/path/to/working/tree","script":"scriptname",...}'
20 crunch-job --job '{"repository":"https://github.com/curoverse/arvados.git","script_version":"master","script":"scriptname",...}'
28 If the job is already locked, steal the lock and run it anyway.
32 Path to a .git directory (or a git URL) where the commit given in the
33 job's C<script_version> attribute is to be found. If this is I<not>
34 given, the job's C<repository> attribute will be used.
38 Arvados API authorization token to use during the course of the job.
42 Do not clear per-job/task temporary directories during initial job
43 setup. This can speed up development and debugging when running jobs
48 UUID of the job to run, or a JSON-encoded job resource without a
49 UUID. If the latter is given, a new job object will be created.
53 =head1 RUNNING JOBS LOCALLY
55 crunch-job's log messages appear on stderr along with the job tasks'
56 stderr streams. The log is saved in Keep at each checkpoint and when
59 If the job succeeds, the job's output locator is printed on stdout.
61 While the job is running, the following signals are accepted:
65 =item control-C, SIGINT, SIGQUIT
67 Save a checkpoint, terminate any job tasks that are running, and stop.
71 Save a checkpoint and continue.
75 Refresh node allocation (i.e., check whether any nodes have been added
76 or unallocated) and attributes of the Job record that should affect
77 behavior (e.g., cancel job if cancelled_at becomes non-nil).
85 use POSIX ':sys_wait_h';
86 use POSIX qw(strftime);
87 use Fcntl qw(F_GETFL F_SETFL O_NONBLOCK);
91 use Digest::MD5 qw(md5_hex);
97 use File::Path qw( make_path remove_tree );
99 use constant TASK_TEMPFAIL => 111;
100 use constant EX_TEMPFAIL => 75;
101 use constant EX_RETRY_UNLOCKED => 93;
103 $ENV{"TMPDIR"} ||= "/tmp";
104 unless (defined $ENV{"CRUNCH_TMP"}) {
105 $ENV{"CRUNCH_TMP"} = $ENV{"TMPDIR"} . "/crunch-job";
106 if ($ENV{"USER"} ne "crunch" && $< != 0) {
107 # use a tmp dir unique for my uid
108 $ENV{"CRUNCH_TMP"} .= "-$<";
112 # Create the tmp directory if it does not exist
113 if ( ! -d $ENV{"CRUNCH_TMP"} ) {
114 make_path $ENV{"CRUNCH_TMP"} or die "Failed to create temporary working directory: " . $ENV{"CRUNCH_TMP"};
117 $ENV{"JOB_WORK"} = $ENV{"CRUNCH_TMP"} . "/work";
118 $ENV{"CRUNCH_INSTALL"} = "$ENV{CRUNCH_TMP}/opt";
119 $ENV{"CRUNCH_WORK"} = $ENV{"JOB_WORK"}; # deprecated
120 mkdir ($ENV{"JOB_WORK"});
129 my $cgroup_root = "/sys/fs/cgroup";
130 my $docker_bin = "docker.io";
131 my $docker_run_args = "";
132 GetOptions('force-unlock' => \$force_unlock,
133 'git-dir=s' => \$git_dir,
134 'job=s' => \$jobspec,
135 'job-api-token=s' => \$job_api_token,
136 'no-clear-tmp' => \$no_clear_tmp,
137 'resume-stash=s' => \$resume_stash,
138 'cgroup-root=s' => \$cgroup_root,
139 'docker-bin=s' => \$docker_bin,
140 'docker-run-args=s' => \$docker_run_args,
143 if (defined $job_api_token) {
144 $ENV{ARVADOS_API_TOKEN} = $job_api_token;
147 my $have_slurm = exists $ENV{SLURM_JOB_ID} && exists $ENV{SLURM_NODELIST};
152 $main::ENV{CRUNCH_DEBUG} = 1;
156 $main::ENV{CRUNCH_DEBUG} = 0;
159 my $arv = Arvados->new('apiVersion' => 'v1');
168 if ($jobspec =~ /^[-a-z\d]+$/)
170 # $jobspec is an Arvados UUID, not a JSON job specification
171 $Job = api_call("jobs/get", uuid => $jobspec);
176 $local_job = JSON::decode_json($jobspec);
180 # Make sure our workers (our slurm nodes, localhost, or whatever) are
181 # at least able to run basic commands: they aren't down or severely
184 if (($Job || $local_job)->{docker_image_locator}) {
185 $cmd = [$docker_bin, 'ps', '-q'];
187 Log(undef, "Sanity check is `@$cmd`");
188 my ($exited, $stdout, $stderr) = srun_sync(
189 ["srun", "--nodes=\Q$ENV{SLURM_NNODES}\E", "--ntasks-per-node=1"],
191 {label => "sanity check"});
193 Log(undef, "Sanity check failed: ".exit_status_s($exited));
196 Log(undef, "Sanity check OK");
199 my $User = api_call("users/current");
202 if (!$force_unlock) {
203 # Claim this job, and make sure nobody else does
204 eval { api_call("jobs/lock", uuid => $Job->{uuid}); };
206 Log(undef, "Error while locking job, exiting ".EX_TEMPFAIL);
215 map { croak ("No $_ specified") unless $local_job->{$_} }
216 qw(script script_version script_parameters);
219 $local_job->{'is_locked_by_uuid'} = $User->{'uuid'};
220 $local_job->{'started_at'} = gmtime;
221 $local_job->{'state'} = 'Running';
223 $Job = api_call("jobs/create", job => $local_job);
225 $job_id = $Job->{'uuid'};
227 my $keep_logfile = $job_id . '.log.txt';
228 log_writer_start($keep_logfile);
230 $Job->{'runtime_constraints'} ||= {};
231 $Job->{'runtime_constraints'}->{'max_tasks_per_node'} ||= 0;
232 my $max_ncpus = $Job->{'runtime_constraints'}->{'max_tasks_per_node'};
234 my $gem_versions = `gem list --quiet arvados-cli 2>/dev/null`;
236 $gem_versions =~ s/^arvados-cli \(/ with arvados-cli Gem version(s) /;
237 chomp($gem_versions);
238 chop($gem_versions); # Closing parentheses
243 "running from " . ((-e $0) ? realpath($0) : "stdin") . $gem_versions);
245 Log (undef, "check slurm allocation");
248 # Should use $ENV{SLURM_TASKS_PER_NODE} instead of sinfo? (eg. "4(x3),2,4(x2)")
252 my $localcpus = 0 + `grep -cw ^processor /proc/cpuinfo` || 1;
253 push @sinfo, "$localcpus localhost";
255 if (exists $ENV{SLURM_NODELIST})
257 push @sinfo, `sinfo -h --format='%c %N' --nodes=\Q$ENV{SLURM_NODELIST}\E`;
261 my ($ncpus, $slurm_nodelist) = split;
262 $ncpus = $max_ncpus if $max_ncpus && $ncpus > $max_ncpus;
265 while ($slurm_nodelist =~ s/^([^\[,]+?(\[.*?\])?)(,|$)//)
268 if ($nodelist =~ /\[((\d+)(-(\d+))?(,(\d+)(-(\d+))?)*)\]/)
271 foreach (split (",", $ranges))
284 push @nodelist, map {
286 $n =~ s/\[[-,\d]+\]/$_/;
293 push @nodelist, $nodelist;
296 foreach my $nodename (@nodelist)
298 Log (undef, "node $nodename - $ncpus slots");
299 my $node = { name => $nodename,
301 # The number of consecutive times a task has been dispatched
302 # to this node and failed.
304 # The number of consecutive times that SLURM has reported
305 # a node failure since the last successful task.
307 # Don't dispatch work to this node until this time
308 # (in seconds since the epoch) has passed.
310 foreach my $cpu (1..$ncpus)
312 push @slot, { node => $node,
316 push @node, @nodelist;
321 # Ensure that we get one jobstep running on each allocated node before
322 # we start overloading nodes with concurrent steps
324 @slot = sort { $a->{cpu} <=> $b->{cpu} } @slot;
327 $Job->update_attributes(
328 'tasks_summary' => { 'failed' => 0,
333 Log (undef, "start");
334 $SIG{'INT'} = sub { $main::please_freeze = 1; };
335 $SIG{'QUIT'} = sub { $main::please_freeze = 1; };
336 $SIG{'TERM'} = \&croak;
337 $SIG{'TSTP'} = sub { $main::please_freeze = 1; };
338 $SIG{'ALRM'} = sub { $main::please_info = 1; };
339 $SIG{'CONT'} = sub { $main::please_continue = 1; };
340 $SIG{'HUP'} = sub { $main::please_refresh = 1; };
342 $main::please_freeze = 0;
343 $main::please_info = 0;
344 $main::please_continue = 0;
345 $main::please_refresh = 0;
346 my $jobsteps_must_output_keys = 0; # becomes 1 when any task outputs a key
348 grep { $ENV{$1} = $2 if /^(NOCACHE.*?)=(.*)/ } split ("\n", $$Job{knobs});
349 $ENV{"CRUNCH_JOB_UUID"} = $job_id;
350 $ENV{"JOB_UUID"} = $job_id;
353 my @jobstep_todo = ();
354 my @jobstep_done = ();
355 my @jobstep_tomerge = ();
356 my $jobstep_tomerge_level = 0;
357 my $squeue_checked = 0;
358 my $latest_refresh = scalar time;
362 if (defined $Job->{thawedfromkey})
364 thaw ($Job->{thawedfromkey});
368 my $first_task = api_call("job_tasks/create", job_task => {
369 'job_uuid' => $Job->{'uuid'},
374 push @jobstep, { 'level' => 0,
376 'arvados_task' => $first_task,
378 push @jobstep_todo, 0;
384 must_lock_now("$ENV{CRUNCH_TMP}/.lock", "a job is already running here.");
387 my $build_script = handle_readall(\*DATA);
388 my $nodelist = join(",", @node);
389 my $git_tar_count = 0;
391 if (!defined $no_clear_tmp) {
392 # Find FUSE mounts under $CRUNCH_TMP and unmount them. Then clean
393 # up work directories crunch_tmp/work, crunch_tmp/opt,
396 # TODO: When #5036 is done and widely deployed, we can limit mount's
397 # -t option to simply fuse.keep.
398 my ($exited, $stdout, $stderr) = srun_sync(
399 ["srun", "--nodelist=$nodelist", "-D", $ENV{'TMPDIR'}],
400 ['bash', '-ec', '-o', 'pipefail', 'mount -t fuse,fuse.keep | awk "(index(\$3, \"$CRUNCH_TMP\") == 1){print \$3}" | xargs -r -n 1 fusermount -u -z; sleep 1; rm -rf $JOB_WORK $CRUNCH_INSTALL $CRUNCH_TMP/task $CRUNCH_TMP/src* $CRUNCH_TMP/*.cid'],
401 {label => "clean work dirs"});
403 exit(EX_RETRY_UNLOCKED);
407 # If this job requires a Docker image, install that.
408 my ($docker_locator, $docker_stream, $docker_hash, $docker_limitmem, $dockeruserarg);
409 if ($docker_locator = $Job->{docker_image_locator}) {
410 Log (undef, "Install docker image $docker_locator");
411 ($docker_stream, $docker_hash) = find_docker_image($docker_locator);
414 croak("No Docker image hash found from locator $docker_locator");
416 Log (undef, "docker image hash is $docker_hash");
417 $docker_stream =~ s/^\.//;
418 my $docker_install_script = qq{
419 if $docker_bin images -q --no-trunc --all | grep -xF \Q$docker_hash\E >/dev/null; then
422 declare -a exit_codes=("\${PIPESTATUS[@]}")
423 if [ 0 != "\${exit_codes[0]}" ]; then
424 exit "\${exit_codes[0]}" # `docker images` failed
425 elif [ 1 != "\${exit_codes[1]}" ]; then
426 exit "\${exit_codes[1]}" # `grep` encountered an error
428 # Everything worked fine, but grep didn't find the image on this host.
429 arv-get \Q$docker_locator$docker_stream/$docker_hash.tar\E | $docker_bin load
433 my ($exited, $stdout, $stderr) = srun_sync(
434 ["srun", "--nodelist=" . join(',', @node)],
435 ["/bin/bash", "-o", "pipefail", "-ec", $docker_install_script],
436 {label => "load docker image"});
439 exit(EX_RETRY_UNLOCKED);
442 # Determine whether this version of Docker supports memory+swap limits.
443 ($exited, $stdout, $stderr) = srun_sync(
444 ["srun", "--nodes=1"],
445 [$docker_bin, 'run', '--help'],
446 {label => "check --memory-swap feature"});
447 $docker_limitmem = ($stdout =~ /--memory-swap/);
449 # Find a non-root Docker user to use.
450 # Tries the default user for the container, then 'crunch', then 'nobody',
451 # testing for whether the actual user id is non-zero. This defends against
452 # mistakes but not malice, but we intend to harden the security in the future
453 # so we don't want anyone getting used to their jobs running as root in their
455 my @tryusers = ("", "crunch", "nobody");
456 foreach my $try_user (@tryusers) {
459 if ($try_user eq "") {
460 $label = "check whether default user is UID 0";
463 $label = "check whether user '$try_user' is UID 0";
464 $try_user_arg = "--user=$try_user";
466 my ($exited, $stdout, $stderr) = srun_sync(
467 ["srun", "--nodes=1"],
469 "$docker_bin run $docker_run_args $try_user_arg $docker_hash id --user"],
472 if ($exited == 0 && $stdout =~ /^\d+$/ && $stdout > 0) {
473 $dockeruserarg = $try_user_arg;
474 if ($try_user eq "") {
475 Log(undef, "Container will run with default user");
477 Log(undef, "Container will run with $dockeruserarg");
483 if (!defined $dockeruserarg) {
484 croak("Could not find a user in container that is not UID 0 (tried default user, @tryusers) or there was a problem running 'id' in the container.");
487 if ($Job->{arvados_sdk_version}) {
488 # The job also specifies an Arvados SDK version. Add the SDKs to the
489 # tar file for the build script to install.
490 Log(undef, sprintf("Packing Arvados SDK version %s for installation",
491 $Job->{arvados_sdk_version}));
492 add_git_archive("git", "--git-dir=$git_dir", "archive",
493 "--prefix=.arvados.sdk/",
494 $Job->{arvados_sdk_version}, "sdk");
498 if (!defined $git_dir && $Job->{'script_version'} =~ m{^/}) {
499 # If script_version looks like an absolute path, *and* the --git-dir
500 # argument was not given -- which implies we were not invoked by
501 # crunch-dispatch -- we will use the given path as a working
502 # directory instead of resolving script_version to a git commit (or
503 # doing anything else with git).
504 $ENV{"CRUNCH_SRC_COMMIT"} = $Job->{'script_version'};
505 $ENV{"CRUNCH_SRC"} = $Job->{'script_version'};
508 # Resolve the given script_version to a git commit sha1. Also, if
509 # the repository is remote, clone it into our local filesystem: this
510 # ensures "git archive" will work, and is necessary to reliably
511 # resolve a symbolic script_version like "master^".
512 $ENV{"CRUNCH_SRC"} = "$ENV{CRUNCH_TMP}/src";
514 Log (undef, "Looking for version ".$Job->{script_version}." from repository ".$Job->{repository});
516 $ENV{"CRUNCH_SRC_COMMIT"} = $Job->{script_version};
518 # If we're running under crunch-dispatch, it will have already
519 # pulled the appropriate source tree into its own repository, and
520 # given us that repo's path as $git_dir.
522 # If we're running a "local" job, we might have to fetch content
523 # from a remote repository.
525 # (Currently crunch-dispatch gives a local path with --git-dir, but
526 # we might as well accept URLs there too in case it changes its
528 my $repo = $git_dir || $Job->{'repository'};
530 # Repository can be remote or local. If remote, we'll need to fetch it
531 # to a local dir before doing `git log` et al.
534 if ($repo =~ m{://|^[^/]*:}) {
535 # $repo is a git url we can clone, like git:// or https:// or
536 # file:/// or [user@]host:repo.git. Note "user/name@host:foo" is
537 # not recognized here because distinguishing that from a local
538 # path is too fragile. If you really need something strange here,
539 # use the ssh:// form.
540 $repo_location = 'remote';
541 } elsif ($repo =~ m{^\.*/}) {
542 # $repo is a local path to a git index. We'll also resolve ../foo
543 # to ../foo/.git if the latter is a directory. To help
544 # disambiguate local paths from named hosted repositories, this
545 # form must be given as ./ or ../ if it's a relative path.
546 if (-d "$repo/.git") {
547 $repo = "$repo/.git";
549 $repo_location = 'local';
551 # $repo is none of the above. It must be the name of a hosted
553 my $arv_repo_list = api_call("repositories/list",
554 'filters' => [['name','=',$repo]]);
555 my @repos_found = @{$arv_repo_list->{'items'}};
556 my $n_found = $arv_repo_list->{'serverResponse'}->{'items_available'};
558 Log(undef, "Repository '$repo' -> "
559 . join(", ", map { $_->{'uuid'} } @repos_found));
562 croak("Error: Found $n_found repositories with name '$repo'.");
564 $repo = $repos_found[0]->{'fetch_url'};
565 $repo_location = 'remote';
567 Log(undef, "Using $repo_location repository '$repo'");
568 $ENV{"CRUNCH_SRC_URL"} = $repo;
570 # Resolve given script_version (we'll call that $treeish here) to a
571 # commit sha1 ($commit).
572 my $treeish = $Job->{'script_version'};
574 if ($repo_location eq 'remote') {
575 # We minimize excess object-fetching by re-using the same bare
576 # repository in CRUNCH_TMP/.git for multiple crunch-jobs -- we
577 # just keep adding remotes to it as needed.
578 my $local_repo = $ENV{'CRUNCH_TMP'}."/.git";
579 my $gitcmd = "git --git-dir=\Q$local_repo\E";
581 # Set up our local repo for caching remote objects, making
583 if (!-d $local_repo) {
584 make_path($local_repo) or croak("Error: could not create $local_repo");
586 # This works (exits 0 and doesn't delete fetched objects) even
587 # if $local_repo is already initialized:
588 `$gitcmd init --bare`;
590 croak("Error: $gitcmd init --bare exited ".exit_status_s($?));
593 # If $treeish looks like a hash (or abbrev hash) we look it up in
594 # our local cache first, since that's cheaper. (We don't want to
595 # do that with tags/branches though -- those change over time, so
596 # they should always be resolved by the remote repo.)
597 if ($treeish =~ /^[0-9a-f]{7,40}$/s) {
598 # Hide stderr because it's normal for this to fail:
599 my $sha1 = `$gitcmd rev-list -n1 ''\Q$treeish\E 2>/dev/null`;
601 # Careful not to resolve a branch named abcdeff to commit 1234567:
602 $sha1 =~ /^$treeish/ &&
603 $sha1 =~ /^([0-9a-f]{40})$/s) {
605 Log(undef, "Commit $commit already present in $local_repo");
609 if (!defined $commit) {
610 # If $treeish isn't just a hash or abbrev hash, or isn't here
611 # yet, we need to fetch the remote to resolve it correctly.
613 # First, remove all local heads. This prevents a name that does
614 # not exist on the remote from resolving to (or colliding with)
615 # a previously fetched branch or tag (possibly from a different
617 remove_tree("$local_repo/refs/heads", {keep_root => 1});
619 Log(undef, "Fetching objects from $repo to $local_repo");
620 `$gitcmd fetch --no-progress --tags ''\Q$repo\E \Q+refs/heads/*:refs/heads/*\E`;
622 croak("Error: `$gitcmd fetch` exited ".exit_status_s($?));
626 # Now that the data is all here, we will use our local repo for
627 # the rest of our git activities.
631 my $gitcmd = "git --git-dir=\Q$repo\E";
632 my $sha1 = `$gitcmd rev-list -n1 ''\Q$treeish\E`;
633 unless ($? == 0 && $sha1 =~ /^([0-9a-f]{40})$/) {
634 croak("`$gitcmd rev-list` exited "
636 .", '$treeish' not found, giving up");
639 Log(undef, "Version $treeish is commit $commit");
641 if ($commit ne $Job->{'script_version'}) {
642 # Record the real commit id in the database, frozentokey, logs,
643 # etc. -- instead of an abbreviation or a branch name which can
644 # become ambiguous or point to a different commit in the future.
645 if (!$Job->update_attributes('script_version' => $commit)) {
646 croak("Error: failed to update job's script_version attribute");
650 $ENV{"CRUNCH_SRC_COMMIT"} = $commit;
651 add_git_archive("$gitcmd archive ''\Q$commit\E");
654 my $git_archive = combined_git_archive();
655 if (!defined $git_archive) {
656 Log(undef, "Skip install phase (no git archive)");
658 Log(undef, "Warning: This probably means workers have no source tree!");
663 my $install_script_tries_left = 3;
664 for (my $attempts = 0; $attempts < 3; $attempts++) {
665 my @srunargs = ("srun",
666 "--nodelist=$nodelist",
667 "-D", $ENV{'TMPDIR'}, "--job-name=$job_id");
668 my @execargs = ("sh", "-c",
669 "mkdir -p $ENV{CRUNCH_INSTALL} && cd $ENV{CRUNCH_TMP} && perl -");
671 $ENV{"CRUNCH_GIT_ARCHIVE_HASH"} = md5_hex($git_archive);
672 my ($stdout, $stderr);
673 ($exited, $stdout, $stderr) = srun_sync(
674 \@srunargs, \@execargs,
675 {label => "run install script on all workers"},
676 $build_script . $git_archive);
678 my $stderr_anything_from_script = 0;
679 for my $line (split(/\n/, $stderr)) {
680 if ($line !~ /^(srun: error: |starting: \[)/) {
681 $stderr_anything_from_script = 1;
685 last if $exited == 0 || $main::please_freeze;
687 # If the install script fails but doesn't print an error message,
688 # the next thing anyone is likely to do is just run it again in
689 # case it was a transient problem like "slurm communication fails
690 # because the network isn't reliable enough". So we'll just do
691 # that ourselves (up to 3 attempts in total). OTOH, if there is an
692 # error message, the problem is more likely to have a real fix and
693 # we should fail the job so the fixing process can start, instead
694 # of doing 2 more attempts.
695 last if $stderr_anything_from_script;
698 foreach my $tar_filename (map { tar_filename_n($_); } (1..$git_tar_count)) {
699 unlink($tar_filename);
707 foreach (qw (script script_version script_parameters runtime_constraints))
711 (ref($Job->{$_}) ? JSON::encode_json($Job->{$_}) : $Job->{$_}));
713 foreach (split (/\n/, $Job->{knobs}))
715 Log (undef, "knob " . $_);
720 $main::success = undef;
726 my $thisround_succeeded = 0;
727 my $thisround_failed = 0;
728 my $thisround_failed_multiple = 0;
729 my $working_slot_count = scalar(@slot);
731 @jobstep_todo = sort { $jobstep[$a]->{level} <=> $jobstep[$b]->{level}
732 or $a <=> $b } @jobstep_todo;
733 my $level = $jobstep[$jobstep_todo[0]]->{level};
735 my $initial_tasks_this_level = 0;
736 foreach my $id (@jobstep_todo) {
737 $initial_tasks_this_level++ if ($jobstep[$id]->{level} == $level);
740 # If the number of tasks scheduled at this level #T is smaller than the number
741 # of slots available #S, only use the first #T slots, or the first slot on
742 # each node, whichever number is greater.
744 # When we dispatch tasks later, we'll allocate whole-node resources like RAM
745 # based on these numbers. Using fewer slots makes more resources available
746 # to each individual task, which should normally be a better strategy when
747 # there are fewer of them running with less parallelism.
749 # Note that this calculation is not redone if the initial tasks at
750 # this level queue more tasks at the same level. This may harm
751 # overall task throughput for that level.
753 if ($initial_tasks_this_level < @node) {
754 @freeslot = (0..$#node);
755 } elsif ($initial_tasks_this_level < @slot) {
756 @freeslot = (0..$initial_tasks_this_level - 1);
758 @freeslot = (0..$#slot);
760 my $round_num_freeslots = scalar(@freeslot);
761 print STDERR "crunch-job have ${round_num_freeslots} free slots for ${initial_tasks_this_level} initial tasks at this level, ".scalar(@node)." nodes, and ".scalar(@slot)." slots\n";
763 my %round_max_slots = ();
764 for (my $ii = $#freeslot; $ii >= 0; $ii--) {
765 my $this_slot = $slot[$freeslot[$ii]];
766 my $node_name = $this_slot->{node}->{name};
767 $round_max_slots{$node_name} ||= $this_slot->{cpu};
768 last if (scalar(keys(%round_max_slots)) >= @node);
771 Log(undef, "start level $level with $round_num_freeslots slots");
774 my $progress_is_dirty = 1;
775 my $progress_stats_updated = 0;
777 update_progress_stats();
781 for (my $todo_ptr = 0; $todo_ptr <= $#jobstep_todo; $todo_ptr ++)
783 # Don't create new tasks if we already know the job's final result.
784 last if defined($main::success);
786 my $id = $jobstep_todo[$todo_ptr];
787 my $Jobstep = $jobstep[$id];
788 if ($Jobstep->{level} != $level)
793 pipe $reader{$id}, "writer" or croak("pipe() failed: $!");
794 set_nonblocking($reader{$id});
796 my $childslot = $freeslot[0];
797 my $childnode = $slot[$childslot]->{node};
798 my $childslotname = join (".",
799 $slot[$childslot]->{node}->{name},
800 $slot[$childslot]->{cpu});
802 my $childpid = fork();
805 $SIG{'INT'} = 'DEFAULT';
806 $SIG{'QUIT'} = 'DEFAULT';
807 $SIG{'TERM'} = 'DEFAULT';
809 foreach (values (%reader))
813 fcntl ("writer", F_SETFL, 0) or croak ($!); # no close-on-exec
814 open(STDOUT,">&writer");
815 open(STDERR,">&writer");
820 delete $ENV{"GNUPGHOME"};
821 $ENV{"TASK_UUID"} = $Jobstep->{'arvados_task'}->{'uuid'};
822 $ENV{"TASK_QSEQUENCE"} = $id;
823 $ENV{"TASK_SEQUENCE"} = $level;
824 $ENV{"JOB_SCRIPT"} = $Job->{script};
825 while (my ($param, $value) = each %{$Job->{script_parameters}}) {
826 $param =~ tr/a-z/A-Z/;
827 $ENV{"JOB_PARAMETER_$param"} = $value;
829 $ENV{"TASK_SLOT_NODE"} = $slot[$childslot]->{node}->{name};
830 $ENV{"TASK_SLOT_NUMBER"} = $slot[$childslot]->{cpu};
831 $ENV{"TASK_WORK"} = $ENV{"CRUNCH_TMP"}."/task/$childslotname";
832 $ENV{"HOME"} = $ENV{"TASK_WORK"};
833 $ENV{"TASK_TMPDIR"} = $ENV{"TASK_WORK"}; # deprecated
834 $ENV{"CRUNCH_NODE_SLOTS"} = $round_max_slots{$ENV{TASK_SLOT_NODE}};
835 $ENV{"PATH"} = $ENV{"CRUNCH_INSTALL"} . "/bin:" . $ENV{"PATH"};
837 my $keep_mnt = $ENV{"TASK_WORK"}.".keep";
843 "--nodelist=".$childnode->{name},
844 qw(-n1 -c1 -N1 -D), $ENV{'TMPDIR'},
845 "--job-name=$job_id.$id.$$",
848 my $stdbuf = " stdbuf --output=0 --error=0 ";
850 my $arv_file_cache = "";
851 if (defined($Job->{'runtime_constraints'}->{'keep_cache_mb_per_task'})) {
852 $arv_file_cache = "--file-cache=" . ($Job->{'runtime_constraints'}->{'keep_cache_mb_per_task'} * 1024 * 1024);
856 "if [ -e \Q$ENV{TASK_WORK}\E ]; then rm -rf \Q$ENV{TASK_WORK}\E; fi; "
857 ."mkdir -p \Q$ENV{CRUNCH_TMP}\E \Q$ENV{JOB_WORK}\E \Q$ENV{TASK_WORK}\E \Q$keep_mnt\E "
858 ."&& cd \Q$ENV{CRUNCH_TMP}\E "
859 # These environment variables get used explicitly later in
860 # $command. No tool is expected to read these values directly.
861 .q{&& MEM=$(awk '($1 == "MemTotal:"){print $2}' </proc/meminfo) }
862 .q{&& SWAP=$(awk '($1 == "SwapTotal:"){print $2}' </proc/meminfo) }
863 ."&& MEMLIMIT=\$(( (\$MEM * 95) / ($ENV{CRUNCH_NODE_SLOTS} * 100) )) "
864 ."&& let SWAPLIMIT=\$MEMLIMIT+\$SWAP "
865 .q{&& declare -a VOLUMES=() }
866 .q{&& if which crunchrunner >/dev/null ; then VOLUMES+=("--volume=$(which crunchrunner):/usr/local/bin/crunchrunner") ; fi }
867 .q{&& if test -f /etc/ssl/certs/ca-certificates.crt ; then VOLUMES+=("--volume=/etc/ssl/certs/ca-certificates.crt:/etc/arvados/ca-certificates.crt") ; }
868 .q{elif test -f /etc/pki/tls/certs/ca-bundle.crt ; then VOLUMES+=("--volume=/etc/pki/tls/certs/ca-bundle.crt:/etc/arvados/ca-certificates.crt") ; fi };
870 $command .= "&& exec arv-mount --read-write --mount-by-pdh=by_pdh --mount-tmp=tmp --crunchstat-interval=10 --allow-other $arv_file_cache \Q$keep_mnt\E --exec ";
871 $ENV{TASK_KEEPMOUNT} = "$keep_mnt/by_pdh";
872 $ENV{TASK_KEEPMOUNT_TMP} = "$keep_mnt/tmp";
876 my $containername = "$Jobstep->{arvados_task}->{uuid}-$Jobstep->{failures}";
877 my $cidfile = "$ENV{CRUNCH_TMP}/$containername.cid";
878 $command .= "crunchstat -cgroup-root=\Q$cgroup_root\E -cgroup-parent=docker -cgroup-cid=$cidfile -poll=10000 ";
879 $command .= "$docker_bin run $docker_run_args --name=$containername --attach=stdout --attach=stderr --attach=stdin -i \Q$dockeruserarg\E --cidfile=$cidfile --sig-proxy ";
880 # We only set memory limits if Docker lets us limit both memory and swap.
881 # Memory limits alone have been supported longer, but subprocesses tend
882 # to get SIGKILL if they exceed that without any swap limit set.
883 # See #5642 for additional background.
884 if ($docker_limitmem) {
885 $command .= "--memory=\${MEMLIMIT}k --memory-swap=\${SWAPLIMIT}k ";
888 # The source tree and $destdir directory (which we have
889 # installed on the worker host) are available in the container,
890 # under the same path.
891 $command .= "--volume=\Q$ENV{CRUNCH_SRC}:$ENV{CRUNCH_SRC}:ro\E ";
892 $command .= "--volume=\Q$ENV{CRUNCH_INSTALL}:$ENV{CRUNCH_INSTALL}:ro\E ";
894 # Currently, we make the "by_pdh" directory in arv-mount's mount
895 # point appear at /keep inside the container (instead of using
896 # the same path as the host like we do with CRUNCH_SRC and
897 # CRUNCH_INSTALL). However, crunch scripts and utilities must
898 # not rely on this. They must use $TASK_KEEPMOUNT.
899 $command .= "--volume=\Q$ENV{TASK_KEEPMOUNT}:/keep:ro\E ";
900 $ENV{TASK_KEEPMOUNT} = "/keep";
902 # Ditto TASK_KEEPMOUNT_TMP, as /keep_tmp.
903 $command .= "--volume=\Q$ENV{TASK_KEEPMOUNT_TMP}:/keep_tmp\E ";
904 $ENV{TASK_KEEPMOUNT_TMP} = "/keep_tmp";
906 # TASK_WORK is almost exactly like a docker data volume: it
907 # starts out empty, is writable, and persists until no
908 # containers use it any more. We don't use --volumes-from to
909 # share it with other containers: it is only accessible to this
910 # task, and it goes away when this task stops.
912 # However, a docker data volume is writable only by root unless
913 # the mount point already happens to exist in the container with
914 # different permissions. Therefore, we [1] assume /tmp already
915 # exists in the image and is writable by the crunch user; [2]
916 # avoid putting TASK_WORK inside CRUNCH_TMP (which won't be
917 # writable if they are created by docker while setting up the
918 # other --volumes); and [3] create $TASK_WORK inside the
919 # container using $build_script.
920 $command .= "--volume=/tmp ";
921 $ENV{"TASK_WORK"} = "/tmp/crunch-job-task-work/$childslotname";
922 $ENV{"HOME"} = $ENV{"TASK_WORK"};
923 $ENV{"TASK_TMPDIR"} = $ENV{"TASK_WORK"}; # deprecated
925 # TODO: Share a single JOB_WORK volume across all task
926 # containers on a given worker node, and delete it when the job
927 # ends (and, in case that doesn't work, when the next job
930 # For now, use the same approach as TASK_WORK above.
931 $ENV{"JOB_WORK"} = "/tmp/crunch-job-work";
933 # Bind mount the crunchrunner binary and host TLS certificates file into
935 $command .= '"${VOLUMES[@]}" ';
937 while (my ($env_key, $env_val) = each %ENV)
939 if ($env_key =~ /^(ARVADOS|CRUNCH|JOB|TASK)_/) {
940 $command .= "--env=\Q$env_key=$env_val\E ";
943 $command .= "--env=\QHOME=$ENV{HOME}\E ";
944 $command .= "\Q$docker_hash\E ";
946 if ($Job->{arvados_sdk_version}) {
948 $command .= "perl - \Q$ENV{CRUNCH_SRC}/crunch_scripts/$Job->{script}\E";
950 $command .= "/bin/sh -c \'python -c " .
951 '"from pkg_resources import get_distribution as get; print \"Using Arvados SDK version\", get(\"arvados-python-client\").version"' .
952 ">&2 2>/dev/null; " .
953 "mkdir -p \"$ENV{JOB_WORK}\" \"$ENV{TASK_WORK}\" && " .
954 "if which stdbuf >/dev/null ; then " .
955 " exec $stdbuf \Q$ENV{CRUNCH_SRC}/crunch_scripts/$Job->{script}\E ;" .
957 " exec \Q$ENV{CRUNCH_SRC}/crunch_scripts/$Job->{script}\E ;" .
962 $command .= "crunchstat -cgroup-root=\Q$cgroup_root\E -poll=10000 ";
964 $command .= "perl - $ENV{CRUNCH_SRC}/crunch_scripts/" . $Job->{"script"};
967 my @execargs = ('bash', '-c', $command);
968 srun (\@srunargs, \@execargs, undef, $build_script);
969 # exec() failed, we assume nothing happened.
970 die "srun() failed on build script\n";
973 if (!defined $childpid)
984 jobstepname => "$job_id.$id.$childpid",
986 croak ("assert failed: \$slot[$childslot]->{'pid'} exists") if exists $slot[$childslot]->{pid};
987 $slot[$childslot]->{pid} = $childpid;
989 Log ($id, "job_task ".$Jobstep->{'arvados_task'}->{'uuid'});
990 Log ($id, "child $childpid started on $childslotname");
991 $Jobstep->{starttime} = time;
992 $Jobstep->{node} = $childnode->{name};
993 $Jobstep->{slotindex} = $childslot;
994 delete $Jobstep->{stderr};
995 delete $Jobstep->{finishtime};
996 delete $Jobstep->{tempfail};
998 $Jobstep->{'arvados_task'}->{started_at} = strftime "%Y-%m-%dT%H:%M:%SZ", gmtime($Jobstep->{starttime});
999 $Jobstep->{'arvados_task'}->save;
1001 splice @jobstep_todo, $todo_ptr, 1;
1004 $progress_is_dirty = 1;
1008 ($round_num_freeslots > @freeslot && $todo_ptr+1 > $#jobstep_todo))
1010 last THISROUND if $main::please_freeze;
1011 if ($main::please_info)
1013 $main::please_info = 0;
1015 create_output_collection();
1017 update_progress_stats();
1022 if (!$gotsome || ($latest_refresh + 2 < scalar time))
1024 check_refresh_wanted();
1026 update_progress_stats();
1028 elsif (time - $progress_stats_updated >= 30 || $progress_is_dirty)
1030 update_progress_stats();
1033 select (undef, undef, undef, 0.1);
1035 $working_slot_count = scalar(grep { $_->{node}->{fail_count} == 0 &&
1036 $_->{node}->{hold_count} < 4 } @slot);
1037 if (($thisround_failed_multiple >= 8 && $thisround_succeeded == 0) ||
1038 ($thisround_failed_multiple >= 16 && $thisround_failed_multiple > $thisround_succeeded))
1040 my $message = "Repeated failure rate too high ($thisround_failed_multiple/"
1041 .($thisround_failed+$thisround_succeeded)
1042 .") -- giving up on this round";
1043 Log (undef, $message);
1047 # move slots from freeslot to holdslot (or back to freeslot) if necessary
1048 for (my $i=$#freeslot; $i>=0; $i--) {
1049 if ($slot[$freeslot[$i]]->{node}->{hold_until} > scalar time) {
1050 push @holdslot, (splice @freeslot, $i, 1);
1053 for (my $i=$#holdslot; $i>=0; $i--) {
1054 if ($slot[$holdslot[$i]]->{node}->{hold_until} <= scalar time) {
1055 push @freeslot, (splice @holdslot, $i, 1);
1059 # give up if no nodes are succeeding
1060 if ($working_slot_count < 1) {
1061 Log(undef, "Every node has failed -- giving up");
1068 push @freeslot, splice @holdslot;
1069 map { $slot[$freeslot[$_]]->{node}->{losing_streak} = 0 } (0..$#freeslot);
1072 Log (undef, "wait for last ".(scalar keys %proc)." children to finish");
1075 if ($main::please_continue) {
1076 $main::please_continue = 0;
1079 $main::please_info = 0, freeze(), create_output_collection(), save_meta(1) if $main::please_info;
1081 if (!reapchildren())
1083 check_refresh_wanted();
1085 update_progress_stats();
1086 select (undef, undef, undef, 0.1);
1087 killem (keys %proc) if $main::please_freeze;
1091 update_progress_stats();
1092 freeze_if_want_freeze();
1095 if (!defined $main::success)
1097 if (!@jobstep_todo) {
1099 } elsif ($working_slot_count < 1) {
1100 save_output_collection();
1102 exit(EX_RETRY_UNLOCKED);
1103 } elsif ($thisround_succeeded == 0 &&
1104 ($thisround_failed == 0 || $thisround_failed > 4)) {
1105 my $message = "stop because $thisround_failed tasks failed and none succeeded";
1106 Log (undef, $message);
1111 goto ONELEVEL if !defined $main::success;
1114 release_allocation();
1116 my $collated_output = save_output_collection();
1117 Log (undef, "finish");
1122 if ($collated_output && $main::success) {
1123 $final_state = 'Complete';
1125 $final_state = 'Failed';
1127 $Job->update_attributes('state' => $final_state);
1129 exit (($final_state eq 'Complete') ? 0 : 1);
1133 sub update_progress_stats
1135 $progress_stats_updated = time;
1136 return if !$progress_is_dirty;
1137 my ($todo, $done, $running) = (scalar @jobstep_todo,
1138 scalar @jobstep_done,
1139 scalar keys(%proc));
1140 $Job->{'tasks_summary'} ||= {};
1141 $Job->{'tasks_summary'}->{'todo'} = $todo;
1142 $Job->{'tasks_summary'}->{'done'} = $done;
1143 $Job->{'tasks_summary'}->{'running'} = $running;
1144 $Job->update_attributes('tasks_summary' => $Job->{'tasks_summary'});
1145 Log (undef, "status: $done done, $running running, $todo todo");
1146 $progress_is_dirty = 0;
1153 my $children_reaped = 0;
1154 my @successful_task_uuids = ();
1156 while((my $pid = waitpid (-1, WNOHANG)) > 0)
1158 my $childstatus = $?;
1160 my $whatslot = ($slot[$proc{$pid}->{slot}]->{node}->{name}
1162 . $slot[$proc{$pid}->{slot}]->{cpu});
1163 my $jobstepidx = $proc{$pid}->{jobstepidx};
1166 my $elapsed = time - $proc{$pid}->{time};
1167 my $Jobstep = $jobstep[$jobstepidx];
1169 my $exitvalue = $childstatus >> 8;
1170 my $exitinfo = "exit ".exit_status_s($childstatus);
1171 $Jobstep->{'arvados_task'}->reload;
1172 my $task_success = $Jobstep->{'arvados_task'}->{success};
1174 Log ($jobstepidx, "child $pid on $whatslot $exitinfo success=$task_success");
1176 if (!defined $task_success) {
1177 # task did not indicate one way or the other --> fail
1178 Log($jobstepidx, sprintf(
1179 "ERROR: Task process exited %s, but never updated its task record to indicate success and record its output.",
1180 exit_status_s($childstatus)));
1181 $Jobstep->{'arvados_task'}->{success} = 0;
1182 $Jobstep->{'arvados_task'}->save;
1189 $temporary_fail ||= $Jobstep->{tempfail};
1190 $temporary_fail ||= ($exitvalue == TASK_TEMPFAIL);
1192 ++$thisround_failed;
1193 ++$thisround_failed_multiple if $Jobstep->{'failures'} >= 1;
1195 # Check for signs of a failed or misconfigured node
1196 if (++$slot[$proc{$pid}->{slot}]->{node}->{losing_streak} >=
1197 2+$slot[$proc{$pid}->{slot}]->{node}->{ncpus}) {
1198 # Don't count this against jobstep failure thresholds if this
1199 # node is already suspected faulty and srun exited quickly
1200 if ($slot[$proc{$pid}->{slot}]->{node}->{hold_until} &&
1202 Log ($jobstepidx, "blaming failure on suspect node " .
1203 $slot[$proc{$pid}->{slot}]->{node}->{name});
1204 $temporary_fail ||= 1;
1206 ban_node_by_slot($proc{$pid}->{slot});
1209 Log ($jobstepidx, sprintf('failure (#%d, %s) after %d seconds',
1210 ++$Jobstep->{'failures'},
1211 $temporary_fail ? 'temporary' : 'permanent',
1214 if (!$temporary_fail || $Jobstep->{'failures'} >= 3) {
1215 # Give up on this task, and the whole job
1218 # Put this task back on the todo queue
1219 push @jobstep_todo, $jobstepidx;
1220 $Job->{'tasks_summary'}->{'failed'}++;
1224 push @successful_task_uuids, $Jobstep->{'arvados_task'}->{uuid};
1225 ++$thisround_succeeded;
1226 $slot[$proc{$pid}->{slot}]->{node}->{losing_streak} = 0;
1227 $slot[$proc{$pid}->{slot}]->{node}->{hold_until} = 0;
1228 $slot[$proc{$pid}->{slot}]->{node}->{fail_count} = 0;
1229 push @jobstep_done, $jobstepidx;
1230 Log ($jobstepidx, "success in $elapsed seconds");
1232 $Jobstep->{exitcode} = $childstatus;
1233 $Jobstep->{finishtime} = time;
1234 $Jobstep->{'arvados_task'}->{finished_at} = strftime "%Y-%m-%dT%H:%M:%SZ", gmtime($Jobstep->{finishtime});
1235 $Jobstep->{'arvados_task'}->save;
1236 process_stderr_final ($jobstepidx);
1237 Log ($jobstepidx, sprintf("task output (%d bytes): %s",
1238 length($Jobstep->{'arvados_task'}->{output}),
1239 $Jobstep->{'arvados_task'}->{output}));
1241 close $reader{$jobstepidx};
1242 delete $reader{$jobstepidx};
1243 delete $slot[$proc{$pid}->{slot}]->{pid};
1244 push @freeslot, $proc{$pid}->{slot};
1247 $progress_is_dirty = 1;
1250 if (scalar(@successful_task_uuids) > 0)
1252 Log (undef, sprintf("%d tasks exited (%d succeeded), checking for new tasks from API server.", $children_reaped, scalar(@successful_task_uuids)));
1254 my $newtask_list = [];
1255 my $newtask_results;
1257 $newtask_results = api_call(
1259 'filters' => [["created_by_job_task_uuid","in",\@successful_task_uuids]],
1260 'order' => 'qsequence',
1261 'offset' => scalar(@$newtask_list),
1263 push(@$newtask_list, @{$newtask_results->{items}});
1264 } while (@{$newtask_results->{items}});
1265 Log (undef, sprintf("Got %d new tasks from API server.", scalar(@$newtask_list)));
1266 foreach my $arvados_task (@$newtask_list) {
1268 'level' => $arvados_task->{'sequence'},
1270 'arvados_task' => $arvados_task
1272 push @jobstep, $jobstep;
1273 push @jobstep_todo, $#jobstep;
1277 return $children_reaped;
1280 sub check_refresh_wanted
1282 my @stat = stat $ENV{"CRUNCH_REFRESH_TRIGGER"};
1284 $stat[9] > $latest_refresh &&
1285 # ...and we have actually locked the job record...
1286 $job_id eq $Job->{'uuid'}) {
1287 $latest_refresh = scalar time;
1288 my $Job2 = api_call("jobs/get", uuid => $jobspec);
1289 for my $attr ('cancelled_at',
1290 'cancelled_by_user_uuid',
1291 'cancelled_by_client_uuid',
1293 $Job->{$attr} = $Job2->{$attr};
1295 if ($Job->{'state'} ne "Running") {
1296 if ($Job->{'state'} eq "Cancelled") {
1297 Log (undef, "Job cancelled at " . $Job->{'cancelled_at'} . " by user " . $Job->{'cancelled_by_user_uuid'});
1299 Log (undef, "Job state unexpectedly changed to " . $Job->{'state'});
1302 $main::please_freeze = 1;
1309 my $last_squeue_check = $squeue_checked;
1311 # Do not call `squeue` or check the kill list more than once every
1313 return if $last_squeue_check > time - 15;
1314 $squeue_checked = time;
1316 # Look for children from which we haven't received stderr data since
1317 # the last squeue check. If no such children exist, all procs are
1318 # alive and there's no need to even look at squeue.
1320 # As long as the crunchstat poll interval (10s) is shorter than the
1321 # squeue check interval (15s) this should make the squeue check an
1323 my $silent_procs = 0;
1324 for my $js (map {$jobstep[$_->{jobstepidx}]} values %proc)
1326 if (!exists($js->{stderr_at}))
1328 $js->{stderr_at} = 0;
1330 if ($js->{stderr_at} < $last_squeue_check)
1335 return if $silent_procs == 0;
1337 # use killem() on procs whose killtime is reached
1338 while (my ($pid, $procinfo) = each %proc)
1340 my $js = $jobstep[$procinfo->{jobstepidx}];
1341 if (exists $procinfo->{killtime}
1342 && $procinfo->{killtime} <= time
1343 && $js->{stderr_at} < $last_squeue_check)
1346 if ($js->{stderr_at}) {
1347 $sincewhen = " in last " . (time - $js->{stderr_at}) . "s";
1349 Log($procinfo->{jobstepidx}, "killing orphaned srun process $pid (task not in slurm queue, no stderr received$sincewhen)");
1356 # here is an opportunity to check for mysterious problems with local procs
1360 # Get a list of steps still running. Note: squeue(1) says --steps
1361 # selects a format (which we override anyway) and allows us to
1362 # specify which steps we're interested in (which we don't).
1363 # Importantly, it also changes the meaning of %j from "job name" to
1364 # "step name" and (although this isn't mentioned explicitly in the
1365 # docs) switches from "one line per job" mode to "one line per step"
1366 # mode. Without it, we'd just get a list of one job, instead of a
1368 my @squeue = `squeue --jobs=\Q$ENV{SLURM_JOB_ID}\E --steps --format='%j' --noheader`;
1371 Log(undef, "warning: squeue exit status $? ($!)");
1376 # which of my jobsteps are running, according to squeue?
1378 for my $jobstepname (@squeue)
1380 $ok{$jobstepname} = 1;
1383 # Check for child procs >60s old and not mentioned by squeue.
1384 while (my ($pid, $procinfo) = each %proc)
1386 if ($procinfo->{time} < time - 60
1387 && $procinfo->{jobstepname}
1388 && !exists $ok{$procinfo->{jobstepname}}
1389 && !exists $procinfo->{killtime})
1391 # According to slurm, this task has ended (successfully or not)
1392 # -- but our srun child hasn't exited. First we must wait (30
1393 # seconds) in case this is just a race between communication
1394 # channels. Then, if our srun child process still hasn't
1395 # terminated, we'll conclude some slurm communication
1396 # error/delay has caused the task to die without notifying srun,
1397 # and we'll kill srun ourselves.
1398 $procinfo->{killtime} = time + 30;
1399 Log($procinfo->{jobstepidx}, "notice: task is not in slurm queue but srun process $pid has not exited");
1405 sub release_allocation
1409 Log (undef, "release job allocation");
1410 system "scancel $ENV{SLURM_JOB_ID}";
1419 my $sel = IO::Select->new();
1420 foreach my $jobstepidx (keys %reader)
1422 my $fd = $reader{$jobstepidx};
1424 $fd_job{$fd} = $jobstepidx;
1426 if (my $stdout_fd = $jobstep[$jobstepidx]->{stdout_r}) {
1427 $sel->add($stdout_fd);
1428 $fd_job{$stdout_fd} = $jobstepidx;
1431 # select on all reader fds with 0.1s timeout
1432 my @ready_fds = $sel->can_read(0.1);
1433 foreach my $fd (@ready_fds)
1436 if (0 < sysread ($fd, $buf, 65536))
1439 print STDERR $buf if $ENV{CRUNCH_DEBUG};
1441 my $jobstepidx = $fd_job{$fd};
1442 if ($jobstep[$jobstepidx]->{stdout_r} == $fd) {
1443 $jobstep[$jobstepidx]->{stdout_captured} .= $buf;
1447 $jobstep[$jobstepidx]->{stderr_at} = time;
1448 $jobstep[$jobstepidx]->{stderr} .= $buf;
1450 # Consume everything up to the last \n
1451 preprocess_stderr ($jobstepidx);
1453 if (length ($jobstep[$jobstepidx]->{stderr}) > 16384)
1455 # If we get a lot of stderr without a newline, chop off the
1456 # front to avoid letting our buffer grow indefinitely.
1457 substr ($jobstep[$jobstepidx]->{stderr},
1458 0, length($jobstep[$jobstepidx]->{stderr}) - 8192) = "";
1466 # Consume all full lines of stderr for a jobstep. Everything after the
1467 # last newline will remain in $jobstep[$jobstepidx]->{stderr} after
1469 sub preprocess_stderr
1471 my $jobstepidx = shift;
1472 # slotindex is only defined for children running Arvados job tasks.
1473 # Be prepared to handle the undef case (for setup srun calls, etc.).
1474 my $job_slot_index = $jobstep[$jobstepidx]->{slotindex};
1476 while ($jobstep[$jobstepidx]->{stderr} =~ /^(.*?)\n/) {
1478 substr $jobstep[$jobstepidx]->{stderr}, 0, 1+length($line), "";
1479 Log ($jobstepidx, "stderr $line");
1480 if ($line =~ /srun: error: (SLURM job $ENV{SLURM_JOB_ID} has expired|Unable to confirm allocation for job $ENV{SLURM_JOB_ID})/) {
1482 $main::please_freeze = 1;
1484 elsif ($line =~ /srun: error: (Node failure on|Aborting, .*\bio error\b)/) {
1485 $jobstep[$jobstepidx]->{tempfail} = 1;
1486 if (defined($job_slot_index)) {
1487 $slot[$job_slot_index]->{node}->{fail_count}++;
1488 ban_node_by_slot($job_slot_index);
1491 elsif ($line =~ /srun: error: (Unable to create job step|.*: Communication connection failure)/) {
1492 $jobstep[$jobstepidx]->{tempfail} = 1;
1493 ban_node_by_slot($job_slot_index) if (defined($job_slot_index));
1495 elsif ($line =~ /\bKeep(Read|Write|Request)Error:/) {
1496 $jobstep[$jobstepidx]->{tempfail} = 1;
1502 sub process_stderr_final
1504 my $jobstepidx = shift;
1505 preprocess_stderr ($jobstepidx);
1508 Log ($jobstepidx, "stderr $_");
1509 } split ("\n", $jobstep[$jobstepidx]->{stderr});
1510 $jobstep[$jobstepidx]->{stderr} = '';
1517 if (!open($keep, "-|", "arv-get", "--retries", retry_count(), $hash)) {
1518 Log(undef, "fetch_block run error from arv-get $hash: $!");
1521 my $output_block = "";
1524 my $bytes = sysread($keep, $buf, 1024 * 1024);
1525 if (!defined $bytes) {
1526 Log(undef, "fetch_block read error from arv-get: $!");
1527 $output_block = undef;
1529 } elsif ($bytes == 0) {
1530 # sysread returns 0 at the end of the pipe.
1533 # some bytes were read into buf.
1534 $output_block .= $buf;
1539 Log(undef, "fetch_block arv-get exited " . exit_status_s($?));
1540 $output_block = undef;
1542 return $output_block;
1545 # Create a collection by concatenating the output of all tasks (each
1546 # task's output is either a manifest fragment, a locator for a
1547 # manifest fragment stored in Keep, or nothing at all). Return the
1548 # portable_data_hash of the new collection.
1549 sub create_output_collection
1551 Log (undef, "collate");
1553 my ($child_out, $child_in);
1554 my $pid = open2($child_out, $child_in, 'python', '-c', q{
1557 print (arvados.api("v1").collections().
1558 create(body={"manifest_text": sys.stdin.read()}).
1559 execute(num_retries=int(sys.argv[1]))["portable_data_hash"])
1563 my $manifest_size = 0;
1567 my $output = $_->{'arvados_task'}->{output};
1568 next if (!defined($output));
1570 if ($output =~ /^[0-9a-f]{32}(\+\S+)*$/) {
1571 $next_write = fetch_block($output);
1573 $next_write = $output;
1575 if (defined($next_write)) {
1576 if (!defined(syswrite($child_in, $next_write))) {
1577 # There's been an error writing. Stop the loop.
1578 # We'll log details about the exit code later.
1581 $manifest_size += length($next_write);
1584 my $uuid = $_->{'arvados_task'}->{'uuid'};
1585 Log (undef, "Error retrieving '$output' output by task $task_idx ($uuid)");
1590 Log(undef, "collated output manifest text to send to API server is $manifest_size bytes with access tokens");
1593 my $s = IO::Select->new($child_out);
1594 if ($s->can_read(120)) {
1595 sysread($child_out, $joboutput, 1024 * 1024);
1598 Log(undef, "output collection creation exited " . exit_status_s($?));
1604 Log (undef, "timed out while creating output collection");
1605 foreach my $signal (2, 2, 2, 15, 15, 9) {
1606 kill($signal, $pid);
1607 last if waitpid($pid, WNOHANG) == -1;
1616 # Calls create_output_collection, logs the result, and returns it.
1617 # If that was successful, save that as the output in the job record.
1618 sub save_output_collection {
1619 my $collated_output = create_output_collection();
1621 if (!$collated_output) {
1622 Log(undef, "Failed to write output collection");
1625 Log(undef, "job output $collated_output");
1626 $Job->update_attributes('output' => $collated_output);
1628 return $collated_output;
1635 my $sig = 2; # SIGINT first
1636 if (exists $proc{$_}->{"sent_$sig"} &&
1637 time - $proc{$_}->{"sent_$sig"} > 4)
1639 $sig = 15; # SIGTERM if SIGINT doesn't work
1641 if (exists $proc{$_}->{"sent_$sig"} &&
1642 time - $proc{$_}->{"sent_$sig"} > 4)
1644 $sig = 9; # SIGKILL if SIGTERM doesn't work
1646 if (!exists $proc{$_}->{"sent_$sig"})
1648 Log ($proc{$_}->{jobstepidx}, "sending 2x signal $sig to pid $_");
1650 select (undef, undef, undef, 0.1);
1653 kill $sig, $_; # srun wants two SIGINT to really interrupt
1655 $proc{$_}->{"sent_$sig"} = time;
1656 $proc{$_}->{"killedafter"} = time - $proc{$_}->{"time"};
1666 vec($bits,fileno($_),1) = 1;
1672 # Send log output to Keep via arv-put.
1674 # $log_pipe_in and $log_pipe_out are the input and output filehandles to the arv-put pipe.
1675 # $log_pipe_out_buf is a string containing all output read from arv-put so far.
1676 # $log_pipe_out_select is an IO::Select object around $log_pipe_out.
1677 # $log_pipe_pid is the pid of the arv-put subprocess.
1679 # The only functions that should access these variables directly are:
1681 # log_writer_start($logfilename)
1682 # Starts an arv-put pipe, reading data on stdin and writing it to
1683 # a $logfilename file in an output collection.
1685 # log_writer_read_output([$timeout])
1686 # Read output from $log_pipe_out and append it to $log_pipe_out_buf.
1687 # Passes $timeout to the select() call, with a default of 0.01.
1688 # Returns the result of the last read() call on $log_pipe_out, or
1689 # -1 if read() wasn't called because select() timed out.
1690 # Only other log_writer_* functions should need to call this.
1692 # log_writer_send($txt)
1693 # Writes $txt to the output log collection.
1695 # log_writer_finish()
1696 # Closes the arv-put pipe and returns the output that it produces.
1698 # log_writer_is_active()
1699 # Returns a true value if there is currently a live arv-put
1700 # process, false otherwise.
1702 my ($log_pipe_in, $log_pipe_out, $log_pipe_out_buf, $log_pipe_out_select,
1705 sub log_writer_start($)
1707 my $logfilename = shift;
1708 $log_pipe_pid = open2($log_pipe_out, $log_pipe_in,
1712 '--filename', $logfilename,
1714 $log_pipe_out_buf = "";
1715 $log_pipe_out_select = IO::Select->new($log_pipe_out);
1718 sub log_writer_read_output {
1719 my $timeout = shift || 0.01;
1721 while ($read && $log_pipe_out_select->can_read($timeout)) {
1722 $read = read($log_pipe_out, $log_pipe_out_buf, 65536,
1723 length($log_pipe_out_buf));
1725 if (!defined($read)) {
1726 Log(undef, "error reading log manifest from arv-put: $!");
1731 sub log_writer_send($)
1734 print $log_pipe_in $txt;
1735 log_writer_read_output();
1738 sub log_writer_finish()
1740 return unless $log_pipe_pid;
1742 close($log_pipe_in);
1744 my $logger_failed = 0;
1745 my $read_result = log_writer_read_output(120);
1746 if ($read_result == -1) {
1747 $logger_failed = -1;
1748 Log (undef, "timed out reading from 'arv-put'");
1749 } elsif ($read_result != 0) {
1750 $logger_failed = -2;
1751 Log(undef, "failed to read arv-put log manifest to EOF");
1754 waitpid($log_pipe_pid, 0);
1756 $logger_failed ||= $?;
1757 Log(undef, "log_writer_finish: arv-put exited " . exit_status_s($?))
1760 close($log_pipe_out);
1761 my $arv_put_output = $logger_failed ? undef : $log_pipe_out_buf;
1762 $log_pipe_pid = $log_pipe_in = $log_pipe_out = $log_pipe_out_buf =
1763 $log_pipe_out_select = undef;
1765 return $arv_put_output;
1768 sub log_writer_is_active() {
1769 return $log_pipe_pid;
1772 sub Log # ($jobstepidx, $logmessage)
1774 my ($jobstepidx, $logmessage) = @_;
1775 if ($logmessage =~ /\n/) {
1776 for my $line (split (/\n/, $_[1])) {
1777 Log ($jobstepidx, $line);
1781 my $fh = select STDERR; $|=1; select $fh;
1783 if (defined($jobstepidx) && exists($jobstep[$jobstepidx]->{arvados_task})) {
1784 $task_qseq = $jobstepidx;
1786 my $message = sprintf ("%s %d %s %s", $job_id, $$, $task_qseq, $logmessage);
1787 $message =~ s{([^ -\176])}{"\\" . sprintf ("%03o", ord($1))}ge;
1790 if (log_writer_is_active() || -t STDERR) {
1791 my @gmtime = gmtime;
1792 $datetime = sprintf ("%04d-%02d-%02d_%02d:%02d:%02d",
1793 $gmtime[5]+1900, $gmtime[4]+1, @gmtime[3,2,1,0]);
1795 print STDERR ((-t STDERR) ? ($datetime." ".$message) : $message);
1797 if (log_writer_is_active()) {
1798 log_writer_send($datetime . " " . $message);
1805 my ($package, $file, $line) = caller;
1806 my $message = "@_ at $file line $line\n";
1807 Log (undef, $message);
1808 freeze() if @jobstep_todo;
1809 create_output_collection() if @jobstep_todo;
1819 if ($Job->{'state'} eq 'Cancelled') {
1820 $Job->update_attributes('finished_at' => scalar gmtime);
1822 $Job->update_attributes('state' => 'Failed');
1829 my $justcheckpoint = shift; # false if this will be the last meta saved
1830 return if $justcheckpoint; # checkpointing is not relevant post-Warehouse.pm
1831 return unless log_writer_is_active();
1832 my $log_manifest = log_writer_finish();
1833 return unless defined($log_manifest);
1836 my $prev_log_coll = api_call("collections/get", uuid => $Job->{log});
1837 $log_manifest = $prev_log_coll->{manifest_text} . $log_manifest;
1840 my $log_coll = api_call(
1841 "collections/create", ensure_unique_name => 1, collection => {
1842 manifest_text => $log_manifest,
1843 owner_uuid => $Job->{owner_uuid},
1844 name => sprintf("Log from %s job %s", $Job->{script}, $Job->{uuid}),
1846 Log(undef, "log collection is " . $log_coll->{portable_data_hash});
1847 $Job->update_attributes('log' => $log_coll->{portable_data_hash});
1851 sub freeze_if_want_freeze
1853 if ($main::please_freeze)
1855 release_allocation();
1858 # kill some srun procs before freeze+stop
1859 map { $proc{$_} = {} } @_;
1862 killem (keys %proc);
1863 select (undef, undef, undef, 0.1);
1865 while (($died = waitpid (-1, WNOHANG)) > 0)
1867 delete $proc{$died};
1872 create_output_collection();
1882 Log (undef, "Freeze not implemented");
1889 croak ("Thaw not implemented");
1905 $s =~ s{\\(.)}{$1 eq "n" ? "\n" : $1}ge;
1912 my $srunargs = shift;
1913 my $execargs = shift;
1914 my $opts = shift || {};
1917 my $label = exists $opts->{label} ? $opts->{label} : "@$execargs";
1918 Log (undef, "$label: start");
1920 my ($stderr_r, $stderr_w);
1921 pipe $stderr_r, $stderr_w or croak("pipe() failed: $!");
1923 my ($stdout_r, $stdout_w);
1924 pipe $stdout_r, $stdout_w or croak("pipe() failed: $!");
1926 my $srunpid = fork();
1931 fcntl($stderr_w, F_SETFL, 0) or croak($!); # no close-on-exec
1932 fcntl($stdout_w, F_SETFL, 0) or croak($!);
1933 open(STDERR, ">&", $stderr_w);
1934 open(STDOUT, ">&", $stdout_w);
1935 srun ($srunargs, $execargs, $opts, $stdin);
1941 set_nonblocking($stderr_r);
1942 set_nonblocking($stdout_r);
1944 # Add entries to @jobstep and %proc so check_squeue() and
1945 # freeze_if_want_freeze() can treat it like a job task process.
1949 stderr_captured => '',
1950 stdout_r => $stdout_r,
1951 stdout_captured => '',
1953 my $jobstepidx = $#jobstep;
1955 jobstepidx => $jobstepidx,
1957 $reader{$jobstepidx} = $stderr_r;
1959 while ($srunpid != waitpid ($srunpid, WNOHANG)) {
1960 my $busy = readfrompipes();
1961 if (!$busy || ($latest_refresh + 2 < scalar time)) {
1962 check_refresh_wanted();
1966 select(undef, undef, undef, 0.1);
1968 killem(keys %proc) if $main::please_freeze;
1972 1 while readfrompipes();
1973 process_stderr_final ($jobstepidx);
1975 Log (undef, "$label: exit ".exit_status_s($exited));
1979 delete $proc{$srunpid};
1980 delete $reader{$jobstepidx};
1982 my $j = pop @jobstep;
1983 # If the srun showed signs of tempfail, ensure the caller treats that as a
1985 if ($main::please_freeze || $j->{tempfail}) {
1988 return ($exited, $j->{stdout_captured}, $j->{stderr_captured});
1994 my $srunargs = shift;
1995 my $execargs = shift;
1996 my $opts = shift || {};
1998 my $args = $have_slurm ? [@$srunargs, @$execargs] : $execargs;
2000 $Data::Dumper::Terse = 1;
2001 $Data::Dumper::Indent = 0;
2002 my $show_cmd = Dumper($args);
2003 $show_cmd =~ s/(TOKEN\\*=)[^\s\']+/${1}[...]/g;
2004 $show_cmd =~ s/\n/ /g;
2005 if ($opts->{fork}) {
2006 Log(undef, "starting: $show_cmd");
2008 # This is a child process: parent is in charge of reading our
2009 # stderr and copying it to Log() if needed.
2010 warn "starting: $show_cmd\n";
2013 if (defined $stdin) {
2014 my $child = open STDIN, "-|";
2015 defined $child or die "no fork: $!";
2017 print $stdin or die $!;
2018 close STDOUT or die $!;
2023 return system (@$args) if $opts->{fork};
2026 warn "ENV size is ".length(join(" ",%ENV));
2027 die "exec failed: $!: @$args";
2031 sub ban_node_by_slot {
2032 # Don't start any new jobsteps on this node for 60 seconds
2034 $slot[$slotid]->{node}->{hold_until} = 60 + scalar time;
2035 $slot[$slotid]->{node}->{hold_count}++;
2036 Log (undef, "backing off node " . $slot[$slotid]->{node}->{name} . " for 60 seconds");
2041 my ($lockfile, $error_message) = @_;
2042 open L, ">", $lockfile or croak("$lockfile: $!");
2043 if (!flock L, LOCK_EX|LOCK_NB) {
2044 croak("Can't lock $lockfile: $error_message\n");
2048 sub find_docker_image {
2049 # Given a Keep locator, check to see if it contains a Docker image.
2050 # If so, return its stream name and Docker hash.
2051 # If not, return undef for both values.
2052 my $locator = shift;
2053 my ($streamname, $filename);
2054 my $image = api_call("collections/get", uuid => $locator);
2056 foreach my $line (split(/\n/, $image->{manifest_text})) {
2057 my @tokens = split(/\s+/, $line);
2059 $streamname = shift(@tokens);
2060 foreach my $filedata (grep(/^\d+:\d+:/, @tokens)) {
2061 if (defined($filename)) {
2062 return (undef, undef); # More than one file in the Collection.
2064 $filename = (split(/:/, $filedata, 3))[2];
2069 if (defined($filename) and ($filename =~ /^([0-9A-Fa-f]{64})\.tar$/)) {
2070 return ($streamname, $1);
2072 return (undef, undef);
2077 # Calculate the number of times an operation should be retried,
2078 # assuming exponential backoff, and that we're willing to retry as
2079 # long as tasks have been running. Enforce a minimum of 3 retries.
2080 my ($starttime, $endtime, $timediff, $retries);
2082 $starttime = $jobstep[0]->{starttime};
2083 $endtime = $jobstep[-1]->{finishtime};
2085 if (!defined($starttime)) {
2087 } elsif (!defined($endtime)) {
2088 $timediff = time - $starttime;
2090 $timediff = ($endtime - $starttime) - (time - $endtime);
2092 if ($timediff > 0) {
2093 $retries = int(log($timediff) / log(2));
2095 $retries = 1; # Use the minimum.
2097 return ($retries > 3) ? $retries : 3;
2101 # Pass in two function references.
2102 # This method will be called with the remaining arguments.
2103 # If it dies, retry it with exponential backoff until it succeeds,
2104 # or until the current retry_count is exhausted. After each failure
2105 # that can be retried, the second function will be called with
2106 # the current try count (0-based), next try time, and error message.
2107 my $operation = shift;
2108 my $retry_callback = shift;
2109 my $retries = retry_count();
2110 foreach my $try_count (0..$retries) {
2111 my $next_try = time + (2 ** $try_count);
2112 my $result = eval { $operation->(@_); };
2115 } elsif ($try_count < $retries) {
2116 $retry_callback->($try_count, $next_try, $@);
2117 my $sleep_time = $next_try - time;
2118 sleep($sleep_time) if ($sleep_time > 0);
2121 # Ensure the error message ends in a newline, so Perl doesn't add
2122 # retry_op's line number to it.
2128 # Pass in a /-separated API method name, and arguments for it.
2129 # This function will call that method, retrying as needed until
2130 # the current retry_count is exhausted, with a log on the first failure.
2131 my $method_name = shift;
2132 my $log_api_retry = sub {
2133 my ($try_count, $next_try_at, $errmsg) = @_;
2134 $errmsg =~ s/\s*\bat \Q$0\E line \d+\.?\s*//;
2135 $errmsg =~ s/\s/ /g;
2136 $errmsg =~ s/\s+$//;
2138 if ($next_try_at < time) {
2139 $retry_msg = "Retrying.";
2141 my $next_try_fmt = strftime "%Y-%m-%dT%H:%M:%SZ", gmtime($next_try_at);
2142 $retry_msg = "Retrying at $next_try_fmt.";
2144 Log(undef, "API method $method_name failed: $errmsg. $retry_msg");
2147 foreach my $key (split(/\//, $method_name)) {
2148 $method = $method->{$key};
2150 return retry_op(sub { $method->execute(@_); }, $log_api_retry, @_);
2154 # Given a $?, return a human-readable exit code string like "0" or
2155 # "1" or "0 with signal 1" or "1 with signal 11".
2156 my $exitcode = shift;
2157 my $s = $exitcode >> 8;
2158 if ($exitcode & 0x7f) {
2159 $s .= " with signal " . ($exitcode & 0x7f);
2161 if ($exitcode & 0x80) {
2162 $s .= " with core dump";
2167 sub handle_readall {
2168 # Pass in a glob reference to a file handle.
2169 # Read all its contents and return them as a string.
2170 my $fh_glob_ref = shift;
2172 return <$fh_glob_ref>;
2175 sub tar_filename_n {
2177 return sprintf("%s/git.%s.%d.tar", $ENV{CRUNCH_TMP}, $job_id, $n);
2180 sub add_git_archive {
2181 # Pass in a git archive command as a string or list, a la system().
2182 # This method will save its output to be included in the archive sent to the
2186 if (!open(GIT_ARCHIVE, ">", tar_filename_n($git_tar_count))) {
2187 croak("Failed to save git archive: $!");
2189 my $git_pid = open2(">&GIT_ARCHIVE", $git_input, @_);
2191 waitpid($git_pid, 0);
2194 croak("Failed to save git archive: git exited " . exit_status_s($?));
2198 sub combined_git_archive {
2199 # Combine all saved tar archives into a single archive, then return its
2200 # contents in a string. Return undef if no archives have been saved.
2201 if ($git_tar_count < 1) {
2204 my $base_tar_name = tar_filename_n(1);
2205 foreach my $tar_to_append (map { tar_filename_n($_); } (2..$git_tar_count)) {
2206 my $tar_exit = system("tar", "-Af", $base_tar_name, $tar_to_append);
2207 if ($tar_exit != 0) {
2208 croak("Error preparing build archive: tar -A exited " .
2209 exit_status_s($tar_exit));
2212 if (!open(GIT_TAR, "<", $base_tar_name)) {
2213 croak("Could not open build archive: $!");
2215 my $tar_contents = handle_readall(\*GIT_TAR);
2217 return $tar_contents;
2220 sub set_nonblocking {
2222 my $flags = fcntl ($fh, F_GETFL, 0) or croak ($!);
2223 fcntl ($fh, F_SETFL, $flags | O_NONBLOCK) or croak ($!);
2229 # This is crunch-job's internal dispatch script. crunch-job running on the API
2230 # server invokes this script on individual compute nodes, or localhost if we're
2231 # running a job locally. It gets called in two modes:
2233 # * No arguments: Installation mode. Read a tar archive from the DATA
2234 # file handle; it includes the Crunch script's source code, and
2235 # maybe SDKs as well. Those should be installed in the proper
2236 # locations. This runs outside of any Docker container, so don't try to
2237 # introspect Crunch's runtime environment.
2239 # * With arguments: Crunch script run mode. This script should set up the
2240 # environment, then run the command specified in the arguments. This runs
2241 # inside any Docker container.
2244 use File::Path qw( make_path remove_tree );
2245 use POSIX qw(getcwd);
2247 use constant TASK_TEMPFAIL => 111;
2249 # Map SDK subdirectories to the path environments they belong to.
2250 my %SDK_ENVVARS = ("perl/lib" => "PERLLIB", "ruby/lib" => "RUBYLIB");
2252 my $destdir = $ENV{"CRUNCH_SRC"};
2253 my $archive_hash = $ENV{"CRUNCH_GIT_ARCHIVE_HASH"};
2254 my $repo = $ENV{"CRUNCH_SRC_URL"};
2255 my $install_dir = $ENV{"CRUNCH_INSTALL"} || (getcwd() . "/opt");
2256 my $job_work = $ENV{"JOB_WORK"};
2257 my $task_work = $ENV{"TASK_WORK"};
2259 open(STDOUT_ORIG, ">&", STDOUT);
2260 open(STDERR_ORIG, ">&", STDERR);
2262 for my $dir ($destdir, $job_work, $task_work) {
2265 -e $dir or die "Failed to create temporary directory ($dir): $!";
2270 remove_tree($task_work, {keep_root => 1});
2273 ### Crunch script run mode
2275 # We want to do routine logging during task 0 only. This gives the user
2276 # the information they need, but avoids repeating the information for every
2279 if ($ENV{TASK_SEQUENCE} eq "0") {
2282 printf STDERR_ORIG "[Crunch] $msg\n", @_;
2288 my $python_src = "$install_dir/python";
2289 my $venv_dir = "$job_work/.arvados.venv";
2290 my $venv_built = -e "$venv_dir/bin/activate";
2291 if ((!$venv_built) and (-d $python_src) and can_run("virtualenv")) {
2292 shell_or_die(undef, "virtualenv", "--quiet", "--system-site-packages",
2293 "--python=python2.7", $venv_dir);
2294 shell_or_die(TASK_TEMPFAIL, "$venv_dir/bin/pip", "--quiet", "install", "-I", $python_src);
2296 $Log->("Built Python SDK virtualenv");
2299 my @pysdk_version_cmd = ("python", "-c",
2300 "from pkg_resources import get_distribution as get; print get('arvados-python-client').version");
2302 $Log->("Running in Python SDK virtualenv");
2303 @pysdk_version_cmd = ();
2304 my $orig_argv = join(" ", map { quotemeta($_); } @ARGV);
2305 @ARGV = ("/bin/sh", "-ec",
2306 ". \Q$venv_dir/bin/activate\E; exec $orig_argv");
2307 } elsif (-d $python_src) {
2308 $Log->("Warning: virtualenv not found inside Docker container default " .
2309 "\$PATH. Can't install Python SDK.");
2312 if (@pysdk_version_cmd) {
2313 open(my $pysdk_version_pipe, "-|", @pysdk_version_cmd);
2314 my $pysdk_version = <$pysdk_version_pipe>;
2315 close($pysdk_version_pipe);
2317 chomp($pysdk_version);
2318 $Log->("Using Arvados SDK version $pysdk_version");
2320 # A lot could've gone wrong here, but pretty much all of it means that
2321 # Python won't be able to load the Arvados SDK.
2322 $Log->("Warning: Arvados SDK not found");
2326 while (my ($sdk_dir, $sdk_envkey) = each(%SDK_ENVVARS)) {
2327 my $sdk_path = "$install_dir/$sdk_dir";
2329 if ($ENV{$sdk_envkey}) {
2330 $ENV{$sdk_envkey} = "$sdk_path:" . $ENV{$sdk_envkey};
2332 $ENV{$sdk_envkey} = $sdk_path;
2334 $Log->("Arvados SDK added to %s", $sdk_envkey);
2339 die "Cannot exec `@ARGV`: $!";
2342 ### Installation mode
2343 open L, ">", "$destdir.lock" or die "$destdir.lock: $!";
2345 if (readlink ("$destdir.archive_hash") eq $archive_hash && -d $destdir) {
2346 # This exact git archive (source + arvados sdk) is already installed
2347 # here, so there's no need to reinstall it.
2349 # We must consume our DATA section, though: otherwise the process
2350 # feeding it to us will get SIGPIPE.
2352 while (read(DATA, $buf, 65536)) { }
2357 unlink "$destdir.archive_hash";
2361 # Ignore SIGPIPE: we check retval of close() instead. See perlipc(1).
2362 local $SIG{PIPE} = "IGNORE";
2363 warn "Extracting archive: $archive_hash\n";
2364 # --ignore-zeros is necessary sometimes: depending on how much NUL
2365 # padding tar -A put on our combined archive (which in turn depends
2366 # on the length of the component archives) tar without
2367 # --ignore-zeros will exit before consuming stdin and cause close()
2368 # to fail on the resulting SIGPIPE.
2369 if (!open(TARX, "|-", "tar", "--ignore-zeros", "-xC", $destdir)) {
2370 die "Error launching 'tar -xC $destdir': $!";
2372 # If we send too much data to tar in one write (> 4-5 MiB), it stops, and we
2373 # get SIGPIPE. We must feed it data incrementally.
2375 while (read(DATA, $tar_input, 65536)) {
2376 print TARX $tar_input;
2379 die "'tar -xC $destdir' exited $?: $!";
2385 my $sdk_root = "$destdir/.arvados.sdk/sdk";
2387 foreach my $sdk_lang (("python",
2388 map { (split /\//, $_, 2)[0]; } keys(%SDK_ENVVARS))) {
2389 if (-d "$sdk_root/$sdk_lang") {
2390 if (!rename("$sdk_root/$sdk_lang", "$install_dir/$sdk_lang")) {
2391 die "Failed to install $sdk_lang SDK: $!";
2397 my $python_dir = "$install_dir/python";
2398 if ((-d $python_dir) and can_run("python2.7")) {
2399 open(my $egg_info_pipe, "-|",
2400 "python2.7 \Q$python_dir/setup.py\E egg_info 2>&1 >/dev/null");
2401 my @egg_info_errors = <$egg_info_pipe>;
2402 close($egg_info_pipe);
2405 if (@egg_info_errors and (($egg_info_errors[-1] =~ /\bgit\b/) or ($egg_info_errors[-1] =~ /\[Errno 2\]/))) {
2406 # egg_info apparently failed because it couldn't ask git for a build tag.
2407 # Specify no build tag.
2408 open(my $pysdk_cfg, ">>", "$python_dir/setup.cfg");
2409 print $pysdk_cfg "\n[egg_info]\ntag_build =\n";
2412 my $egg_info_exit = $? >> 8;
2413 foreach my $errline (@egg_info_errors) {
2416 warn "python setup.py egg_info failed: exit $egg_info_exit";
2417 exit ($egg_info_exit || 1);
2422 # Hide messages from the install script (unless it fails: shell_or_die
2423 # will show $destdir.log in that case).
2424 open(STDOUT, ">>", "$destdir.log");
2425 open(STDERR, ">&", STDOUT);
2427 if (-e "$destdir/crunch_scripts/install") {
2428 shell_or_die (undef, "$destdir/crunch_scripts/install", $install_dir);
2429 } elsif (!-e "./install.sh" && -e "./tests/autotests.sh") {
2431 shell_or_die (undef, "./tests/autotests.sh", $install_dir);
2432 } elsif (-e "./install.sh") {
2433 shell_or_die (undef, "./install.sh", $install_dir);
2436 if ($archive_hash) {
2437 unlink "$destdir.archive_hash.new";
2438 symlink ($archive_hash, "$destdir.archive_hash.new") or die "$destdir.archive_hash.new: $!";
2439 rename ("$destdir.archive_hash.new", "$destdir.archive_hash") or die "$destdir.archive_hash: $!";
2445 my $command_name = shift;
2446 open(my $which, "-|", "which", $command_name);
2447 while (<$which>) { }
2454 my $exitcode = shift;
2456 if ($ENV{"DEBUG"}) {
2457 print STDERR "@_\n";
2459 if (system (@_) != 0) {
2462 my $exitstatus = sprintf("exit %d signal %d", $code >> 8, $code & 0x7f);
2463 open STDERR, ">&STDERR_ORIG";
2464 system ("cat $destdir.log >&2");
2465 warn "@_ failed ($err): $exitstatus";
2466 if (defined($exitcode)) {
2470 exit (($code >> 8) || 1);