testsuite: check flux-archive(1) examples

Problem: flux-archive(1) includes some examples that aren't
really tested.

Add tests that ensure these use cases actually work.

Author: garlick

t/t0021-archive-cmd.t

@@ -173,5 +173,20 @@ test_expect_success 'archive exists in job KVS guest directory' '
 	jobdir=$(flux job last | flux job id --to=kvs) &&
 	flux kvs get $jobdir.guest.archive.mystuff >/dev/null
 '
+test_expect_success 'remove main archive' '
+	flux archive remove
+'
+test_expect_success 'Create files for example 1 of flux-archive(1)' '
+	mkdir -p project/dataset1 &&
+	echo foo >project/dataset1/testfile &&
+	echo bar >project/dataset1/testfile2
+'
+test_expect_success 'Ensure example 1 of flux-archive(1) works' '
+	flux archive create -C project dataset1 &&
+	flux exec -r 1 mkdir -p tmp.project &&
+	flux exec -r 1 flux archive extract --waitcreate -C tmp.project &&
+	flux exec -r 1 rm -r tmp.project &&
+	flux archive remove
+'
 
 test_done

t/t2617-job-shell-stage-in.t

@@ -128,5 +128,23 @@ test_expect_success 'content change should cause an error' '
         test_must_fail flux run -N1 -o stage-in /bin/true 2>changed.err &&
 	grep changed changed.err
 '
+test_expect_success 'Create files for example 2 of flux-archive(1)' '
+	mkdir -p project/dataset1 &&
+	mkdir -p home/fred &&
+	$lptest >project/dataset1/lptest &&
+	cat >home/fred/app <<-EOT &&
+	#!/bin/sh
+	find \$1 -type f
+	EOT
+	chmod +x home/fred/app
+'
+test_expect_success 'Verify that example 2 of flux-archive(1) works' '
+	flux archive create --name=dataset1 -C project dataset1 &&
+	flux archive create --name=app --mmap -C home/fred app &&
+	flux run -N4 -o stage-in.names=app,dataset1 \
+	    {{tmpdir}}/app {{tmpdir}}/dataset1 &&
+	flux archive remove --name=dataset1 &&
+	flux archive remove --name=app
+'
 
 test_done