merge to master

Author: pzeballos

.buildkite/pipeline.yml

@@ -2,7 +2,10 @@ steps:
   - label: ":shell: Shellcheck"
     plugins:
       - shellcheck#v1.3.0:
-          files: hooks/**
+          files:
+            - hooks/**
+            - commands/**
+            - lib/**
 
   - label: ":sparkles:"
     plugins:
@@ -25,4 +28,4 @@ steps:
       - ${BUILDKITE_PULL_REQUEST_REPO:-$BUILDKITE_REPO}#${BUILDKITE_COMMIT}:
           image: ubuntu:22.04
     soft_fail:
-      - exit_status: 3
+      - exit_status: 3

README.md

@@ -6,6 +6,8 @@ Also see the [Docker Compose Buildkite Plugin](https://github.com/buildkite-plug
 
 ## Example
 
+### `run`
+
 The following pipeline will build a binary in the dist directory using [golang Docker image](https://hub.docker.com/_/golang/) and then uploaded as an artifact.
 
 ```yml
@@ -275,6 +277,10 @@ Whether or not to leave the container after the run, or immediately remove it wi
 
 Default: `false`
 
+### `load` (optional, string)
+
+Specify a file to load a docker image from. If omitted no load will be done.
+
 ### `mount-checkout` (optional, boolean)
 
 Whether to automatically mount the current working directory which contains your checked out codebase. Mounts onto `/workdir`, unless `workdir` is set, in which case that will be used.

commands/load.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+set -euo pipefail
+
+arg="${BUILDKITE_PLUGIN_DOCKER_LOAD:-}"
+
+if [[ -z "$arg" ]]; then
+  echo "Error: load has to be given a path to the file that should be loaded"
+  exit 1
+fi
+
+# Don't convert paths on gitbash on windows, as that can mangle user paths and cmd options.
+# See https://github.com/buildkite-plugins/docker-buildkite-plugin/issues/81 for more information.
+( if is_windows ; then export MSYS_NO_PATHCONV=1; fi && docker load -i "${arg}" )