docker: surface image pull progress error (#24981)

set() on the future, so the caller can handle it
instead of wait()ing forever and causing the
allocation to get stuck "pending"

.changelog/24981.txt

@@ -0,0 +1,3 @@
+```release-note:bug
+docker: Fixed a bug where "error reading image pull progress" caused the allocation to get stuck pending
+```

drivers/docker/coordinator.go

@@ -216,6 +216,7 @@ func (d *dockerCoordinator) pullImageImpl(imageID string, authOptions *registry.
 		_, err = io.Copy(pm, reader)
 		if err != nil && !errors.Is(err, io.EOF) {
 			d.logger.Error("error reading image pull progress", "error", err)
+			future.set("", "", recoverablePullError(err, imageID))
 			return
 		}
 	}
@@ -420,5 +421,5 @@ func recoverablePullError(err error, image string) error {
 	if imageNotFoundMatcher.MatchString(err.Error()) {
 		recoverable = false
 	}
-	return structs.NewRecoverableError(fmt.Errorf("Failed to pull `%s`: %s", image, err), recoverable)
+	return structs.NewRecoverableError(fmt.Errorf("Failed to pull `%s`: %w", image, err), recoverable)
 }

drivers/docker/coordinator_test.go

@@ -5,6 +5,7 @@ package docker
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"io"
 	"sync"
@@ -17,6 +18,7 @@ import (
 	"github.com/hashicorp/nomad/helper/testlog"
 	"github.com/hashicorp/nomad/helper/uuid"
 	"github.com/hashicorp/nomad/testutil"
+	"github.com/shoenig/test/must"
 	"github.com/stretchr/testify/require"
 )
 
@@ -25,6 +27,7 @@ type mockImageClient struct {
 	idToName   map[string]string
 	removed    map[string]int
 	pullDelay  time.Duration
+	pullReader io.ReadCloser
 	lock       sync.Mutex
 }
 
@@ -42,7 +45,7 @@ func (m *mockImageClient) ImagePull(ctx context.Context, refStr string, opts ima
 	m.lock.Lock()
 	defer m.lock.Unlock()
 	m.pulled[refStr]++
-	return nil, nil
+	return m.pullReader, nil
 }
 
 func (m *mockImageClient) ImageInspectWithRaw(ctx context.Context, id string) (types.ImageInspect, []byte, error) {
@@ -60,6 +63,21 @@ func (m *mockImageClient) ImageRemove(ctx context.Context, id string, opts image
 	return []image.DeleteResponse{}, nil
 }
 
+type readErrorer struct {
+	readErr    error
+	closeError error
+}
+
+var _ io.ReadCloser = &readErrorer{}
+
+func (r *readErrorer) Read(p []byte) (n int, err error) {
+	return len(p), r.readErr
+}
+
+func (r *readErrorer) Close() error {
+	return r.closeError
+}
+
 func TestDockerCoordinator_ConcurrentPulls(t *testing.T) {
 	ci.Parallel(t)
 	image := "foo"
@@ -322,3 +340,32 @@ func TestDockerCoordinator_Cleanup_HonorsCtx(t *testing.T) {
 	// Check that only no delete happened
 	require.Equal(t, map[string]int{id1: 1}, mock.removed, "removed images")
 }
+
+func TestDockerCoordinator_PullImage_ProgressError(t *testing.T) {
+	// testing: "error reading image pull progress"
+
+	ci.Parallel(t)
+
+	timeout := time.Second // shut down the driver in 1s (should not happen)
+	driverCtx, cancel := context.WithTimeout(context.Background(), timeout)
+	defer cancel()
+
+	mapping := map[string]string{uuid.Generate(): "foo"}
+	mock := newMockImageClient(mapping, 1*time.Millisecond)
+	config := &dockerCoordinatorConfig{
+		ctx:         driverCtx,
+		logger:      testlog.HCLogger(t),
+		cleanup:     true,
+		client:      mock,
+		removeDelay: 1 * time.Millisecond,
+	}
+	coordinator := newDockerCoordinator(config)
+
+	// this error should get set() on the future by pullImageImpl(),
+	// then returned by PullImage()
+	readErr := errors.New("a bad bad thing happened")
+	mock.pullReader = &readErrorer{readErr: readErr}
+
+	_, _, err := coordinator.PullImage("foo", nil, uuid.Generate(), nil, timeout, timeout)
+	must.ErrorIs(t, err, readErr)
+}