[gantry] Do not change replicas after updating.

shizunge · shizunge · commit b1f7d181b5cb · 2026-04-13T19:08:48.000-07:00
diff --git a/README.md b/README.md
@@ -92,7 +92,7 @@ You can configure the most behaviors of *Gantry* via environment variables.
 | GANTRY_ROLLBACK_OPTIONS       |       | [Options](https://docs.docker.com/engine/reference/commandline/service_update/#options) added to the `docker service update --rollback` command for all services. You can apply a different value to a particular service via [labels](#labels). |
 | GANTRY_UPDATE_JOBS            | false | Set to `true` to update `replicated-job` or `global-job`. Set to `false` to disable updating jobs. *Gantry* adds additional options to `docker service update` when there is [no running tasks](docs/faq.md#how-to-update-services-with-no-running-tasks). You can apply a different value to a particular service via [labels](#labels). |
 | GANTRY_UPDATE_NUM_WORKERS     | 1     | The maximum number of updates that can run in parallel. |
-| GANTRY_UPDATE_OPTIONS         |       | [Options](https://docs.docker.com/engine/reference/commandline/service_update/#options) added to the `docker service update` command for all services. You can apply a different value to a particular service via [labels](#labels). |
+| GANTRY_UPDATE_OPTIONS         |       | [Options](https://docs.docker.com/engine/reference/commandline/service_update/#options) added to the `docker service update` command for all services. This also overrides any automatically added options. You can apply a different value to a particular service via [labels](#labels). |
 | GANTRY_UPDATE_TIMEOUT_SECONDS | 0     | Error out if updating of a single service takes longer than the given time. Set to `0` to disable timeout. You can apply a different value to a particular service via [labels](#labels). |
 
 ### After updating
diff --git a/docs/faq.md b/docs/faq.md
@@ -26,9 +26,11 @@ You can start *Gantry* as a docker swarm service and use [`swarm-cronjob`](https
 
 ## How to update services with no running tasks?
 
-As discussed in [docker/cli/issues/627](https://github.com/docker/cli/issues/627), the CLI will hang when running `docker service update` on a service with no running tasks. We must add `--detach=true` option to the `docker service update`.
+As discussed in [docker/cli/issues/627](https://github.com/docker/cli/issues/627), the Docker CLI hangs when `docker service update` is running on a service with no running tasks, requiring the option `--detach=true` to be added.
 
-*Gantry* will check whether there are running tasks in a service. If there is no running task, *Gantry* automatically adds the option `--detach=true`. In addition to the detach option, *Gantry* also adds `--replicas=0` for services in replicated mode. You don't need to add these options manually.
+*Gantry* checks whether a service has running tasks. When none are found, it automatically adds the option `--detach=true`.
+
+If you want to keep replicas at zero post-update, which prevents tasks from starting, you should add the [label](../README.md#labels) `gantry.update.options=--replicas=0` to the service. See the [example](../examples/cronjob).
 
 ## Which `GANTRY_MANIFEST_CMD` to use?
 
diff --git a/examples/cronjob/README.md b/examples/cronjob/README.md
@@ -5,3 +5,5 @@ Use [*swarm-cronjob*](https://github.com/crazy-max/swarm-cronjob) to launch [*Ga
 In this example, we only want to run *Gantry* at the specific time, therefore we set `replicas` to `0` on the *Gantry* service to avoid running it as soon as the service is deployed. We also need to set `restart_policy.condition` to `none` to prevent *Gantry* from restarting automatically after a cronjob.
 
 Refer to the [*swarm-cronjob* document](https://crazymax.dev/swarm-cronjob/) for more information.
+
+*service_to_be_updated* is another service managed by the *swarm-cronjob* and updated by *Gantry*. The label `gantry.update.options=--replicas=0` is set on the service so that only *swarm-cronjob* starts it. Updating the image does not start the service.
diff --git a/examples/cronjob/docker-compose.yml b/examples/cronjob/docker-compose.yml
@@ -16,9 +16,9 @@ services:
       restart_policy:
         condition: none
       labels:
-        - swarm.cronjob.enable=true
-        - swarm.cronjob.schedule=45 23 0 * * *
-        - swarm.cronjob.skip-running=true
+        - "swarm.cronjob.enable=true"
+        - "swarm.cronjob.schedule=45 23 0 * * *"
+        - "swarm.cronjob.skip-running=true"
 
   cronjob:
     image: crazymax/swarm-cronjob:latest
@@ -28,3 +28,25 @@ services:
       placement:
         constraints:
           - node.role==manager
+
+  # Another service to be updated.
+  service_to_be_updated:
+    image: docker
+    command: ["docker", "system", "prune", "-f"]
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock"
+    deploy:
+      replicas: 0
+      placement:
+        constraints:
+          - node.role==manager
+      restart_policy:
+        condition: none
+      labels:
+        - "swarm.cronjob.enable=true"
+        - "swarm.cronjob.schedule=0 */5 * * * *"
+        - "swarm.cronjob.skip-running=false"
+        # Add "gantry.update.options=--replicas=0" to prevent tasks from starting after the update.
+        # Only start the tasks via cronjob.
+        # "--replicas=0" only works in replicated mode, you cannot add it to services in global mode.
+        - "gantry.update.options=--replicas=0"
diff --git a/src/lib-gantry.sh b/src/lib-gantry.sh
@@ -1013,22 +1013,20 @@ _get_service_update_additional_options() {
   local SERVICE_NAME="${1}"
   local IMAGE_UPDATE_TO="${2}"
   local AUTH_CONFIG="${3}"
-  local NUM_RUNS=
-  NUM_RUNS=$(_get_number_of_running_tasks "${SERVICE_NAME}")
-  ! is_number "${NUM_RUNS}" && log WARN "NUM_RUNS \"${NUM_RUNS}\" is not a number." && return 1
+  local RETURN_VALUE=0
   local OPTIONS=
   local SPACE=
-  if [ "${NUM_RUNS}" = "0" ]; then
-    # Add "--detach=true" when there is no running tasks.
-    # https://github.com/docker/cli/issues/627
-    OPTIONS="${OPTIONS}${SPACE}--detach=true"
-    SPACE=" "
-    local MODE=
-    # Do not start a new task. Only works for replicated, not global.
-    if MODE=$(_service_is_replicated "${SERVICE_NAME}"); then
-      OPTIONS="${OPTIONS}${SPACE}--replicas=0"
+  local NUM_RUNS=
+  NUM_RUNS=$(_get_number_of_running_tasks "${SERVICE_NAME}")
+  if is_number "${NUM_RUNS}"; then
+    if [ "${NUM_RUNS}" = "0" ]; then
+      # Add "--detach=true" when there is no running tasks.
+      # https://github.com/docker/cli/issues/627
+      OPTIONS="${OPTIONS}${SPACE}--detach=true"
       SPACE=" "
     fi
+  else
+    log WARN "NUM_RUNS \"${NUM_RUNS}\" is not a number." && RETURN_VALUE=1
   fi
   # Add `--with-registry-auth` if needed.
   local WITH_REGISTRY_AUTH=
@@ -1048,6 +1046,31 @@ _get_service_update_additional_options() {
     SPACE=" "
   fi
   echo "${OPTIONS}"
+  return "${RETURN_VALUE}"
+}
+
+_warning_no_running_task() {
+  local SERVICE_NAME="${1}"
+  local OPTIONS="${2}"
+  local NUM_RUNS=
+  NUM_RUNS=$(_get_number_of_running_tasks "${SERVICE_NAME}")
+  ! is_number "${NUM_RUNS}" && log WARN "NUM_RUNS \"${NUM_RUNS}\" is not a number." && return 1
+  if [ "${NUM_RUNS}" != "0" ]; then
+    return 0
+  fi
+  # Warning for replicated, not global, as "--replicas" only works on replicated, not global.
+  local MODE=
+  if MODE=$(! _service_is_replicated "${SERVICE_NAME}"); then
+    return 0
+  fi
+  # Now, the number of running task is 0, the mode is replicated.
+  # If "--replicas=" is already part of the option, no warning.
+  if [ -n "${OPTIONS}" ] && echo "${OPTIONS}" | grep_q "--replicas="; then
+    return 0
+  fi
+  local MSG="Service ${SERVICE_NAME} is in ${MODE} mode and has no running task before updating."
+  MSG="${MSG} Adding label \"gantry.update.options=--replicas=0\" to the service to prevent tasks from starting after the update."
+  log WARN "${MSG}"
 }
 
 _get_service_rollback_additional_options() {
@@ -1132,6 +1155,7 @@ _update_single_service() {
   [ -n "${AUTH_CONFIG}" ] && log INFO "Adding options \"${AUTH_CONFIG}\" to the command ${CMD_STRING} for ${SERVICE_NAME}."
   [ -n "${AUTOMATIC_OPTIONS}" ] && log INFO "Adding options \"${AUTOMATIC_OPTIONS}\" automatically to the command ${CMD_STRING} for ${SERVICE_NAME}."
   [ -n "${UPDATE_OPTIONS}" ] && log INFO "Adding options \"${UPDATE_OPTIONS}\" specified by user to the command ${CMD_STRING} for ${SERVICE_NAME}."
+  _warning_no_running_task "${SERVICE_NAME}" "${AUTOMATIC_OPTIONS} ${UPDATE_OPTIONS}"
   local TIMEOUT_COMMAND=
   TIMEOUT_COMMAND=$(_get_timeout_command "${SERVICE_NAME}") || return 1
   local SPACE_T=
diff --git a/tests/gantry_login_spec.sh b/tests/gantry_login_spec.sh
@@ -79,8 +79,8 @@ Describe 'login'
       The stderr should satisfy spec_expect_message    "${NUM_SERVICES_UPDATING}"
       The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--config ${AUTH_CONFIG}.*${SERVICE_NAME}"
       # 2 "--with-registry-auth" for SERVICE_NAME. One is automatically added. The other is from user.
-      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS_WITH_REGISTRY_AUTH}.*automatically.*${SERVICE_NAME}"
-      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS_WITH_REGISTRY_AUTH}.*specified by user.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS_WITH_REGISTRY_AUTH}.*${AUTOMATICALLY}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS_WITH_REGISTRY_AUTH}.*${SPECIFIED_BY_USER}.*${SERVICE_NAME}"
       The stderr should satisfy spec_expect_no_message "${FROM_DOCKER_IMAGE_DIGEST_WARNING}.*${SERVICE_NAME}"
       The stderr should satisfy spec_expect_no_message "${DOES_NOT_HAVE_A_DIGEST}"
       The stderr should satisfy spec_expect_message    "${UPDATED}.*${SERVICE_NAME}"
diff --git a/tests/gantry_service_no_running_tasks_spec.sh b/tests/gantry_service_no_running_tasks_spec.sh
@@ -15,6 +15,20 @@
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 #
 
+docker_service_replicas() {
+  local SERVICE_NAME="${1}"
+  local REPLICAS=
+  if ! REPLICAS=$(run_cmd docker service ls --filter "name=${SERVICE_NAME}" --format '{{.Replicas}} {{.Name}}'); then
+    echo "docker service ls failed. ${REPLICAS}"
+    return 1
+  fi
+  # For `docker service ls --filter`, the name filter matches on all or the prefix of a service's name
+  # See https://docs.docker.com/engine/reference/commandline/service_ls/#name
+  # It does not do the exact match of the name. See https://github.com/moby/moby/issues/32985
+  # We do an extra step to to perform the exact match.
+  echo "${REPLICAS}" | sed -n -E "s/(.*) ${SERVICE_NAME}$/\1/p"
+}
+
 Describe "service-no-running-tasks"
   SUITE_NAME="service-no-running-tasks"
   BeforeAll "initialize_all_tests ${SUITE_NAME}"
@@ -46,8 +60,17 @@ Describe "service-no-running-tasks"
     test_no_running_tasks_replicated() {
       local TEST_NAME="${1}"
       local SERVICE_NAME="${2}"
+      local REPLICAS_BEFORE=
+      REPLICAS_BEFORE=$(docker_service_replicas "${SERVICE_NAME}")
+      echo "Before updating: REPLICAS_BEFORE=${REPLICAS_BEFORE}"
       reset_gantry_env "${SUITE_NAME}" "${SERVICE_NAME}"
+      local RETURN_VALUE=
       run_gantry "${SUITE_NAME}" "${TEST_NAME}"
+      RETURN_VALUE="${?}"
+      local REPLICAS_AFTER=
+      REPLICAS_AFTER=$(docker_service_replicas "${SERVICE_NAME}")
+      echo "After updating: REPLICAS_AFTER=${REPLICAS_AFTER}"
+      return "${RETURN_VALUE}"
     }
     test_end() {
       local TEST_NAME="${1}"
@@ -65,15 +88,113 @@ Describe "service-no-running-tasks"
       When run test_no_running_tasks_replicated "${TEST_NAME}" "${SERVICE_NAME}"
       The status should be success
       The stdout should satisfy display_output
-      The stdout should satisfy spec_expect_no_message ".+"
+      The stdout should satisfy spec_expect_message    "Before updating: REPLICAS_BEFORE=0/0"
+      The stdout should satisfy spec_expect_message    "After updating: REPLICAS_AFTER=0/0"
+      The stderr should satisfy display_output
+      The stderr should satisfy spec_expect_no_message "${START_WITHOUT_A_SQUARE_BRACKET}"
+      # Add "--detach=true" when there is no running tasks.
+      # https://github.com/docker/cli/issues/627
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--detach=true.*${AUTOMATICALLY}.*${SERVICE_NAME}\."
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas=.*${SERVICE_NAME}\."
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--detach.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_message    "${SERVICE_NAME}.*${REPLICATED_MODE_NO_RUNNING_TASK}"
+      The stderr should satisfy spec_expect_no_message "${SKIP_UPDATING}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_message    "${PERFORM_UPDATING}.*${SERVICE_NAME}.*${PERFORM_REASON_HAS_NEWER_IMAGE}"
+      The stderr should satisfy spec_expect_no_message "${SKIP_UPDATING}.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_message    "${PERFORM_UPDATING}.*${SERVICE_NAME_SUFFIX}.*${PERFORM_REASON_KNOWN_NEWER_IMAGE}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_SKIP_JOBS}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_INSPECT_FAILURE}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_NO_NEW_IMAGES}"
+      The stderr should satisfy spec_expect_message    "${NUM_SERVICES_UPDATING}"
+      The stderr should satisfy spec_expect_message    "${UPDATED}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_no_message "${NO_UPDATES}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_no_message "${ROLLING_BACK}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_no_message "${FAILED_TO_ROLLBACK}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_no_message "${ROLLED_BACK}.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_no_message "${NO_SERVICES_UPDATED}"
+      The stderr should satisfy spec_expect_message    "2 ${SERVICES_UPDATED}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_UPDATE_FAILED}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_INSPECT_FAILED}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_ROLLBACK_FAILED}"
+      The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_ERRORS}"
+      The stderr should satisfy spec_expect_no_message "${NO_IMAGES_TO_REMOVE}"
+      The stderr should satisfy spec_expect_message    "${REMOVING_NUM_IMAGES}"
+      The stderr should satisfy spec_expect_no_message "${SKIP_REMOVING_IMAGES}"
+      The stderr should satisfy spec_expect_message    "${REMOVED_IMAGE}.*${IMAGE_WITH_TAG}"
+      The stderr should satisfy spec_expect_no_message "${FAILED_TO_REMOVE_IMAGE}.*${IMAGE_WITH_TAG}"
+      The stderr should satisfy spec_expect_message    "${DONE_REMOVING_IMAGES}"
+    End
+  End
+  Describe "test_no_running_tasks_replicated_user_replicas"
+    # For `docker service ls --filter`, the name filter matches on all or the prefix of a service's name
+    # See https://docs.docker.com/engine/reference/commandline/service_ls/#name
+    # It does not do the exact match of the name. See https://github.com/moby/moby/issues/32985
+    # This test also checks whether we do an extra step to to perform the exact match.
+    TEST_NAME="test_no_running_tasks_replicated_user_replicas"
+    IMAGE_WITH_TAG=$(get_image_with_tag "${SUITE_NAME}")
+    SERVICE_NAME=$(get_test_service_name "${TEST_NAME}")
+    SERVICE_NAME_SUFFIX="${SERVICE_NAME}-suffix"
+    test_start() {
+      local TEST_NAME="${1}"
+      local IMAGE_WITH_TAG="${2}"
+      local SERVICE_NAME="${3}"
+      local SERVICE_NAME_SUFFIX="${SERVICE_NAME}-suffix"
+      initialize_test "${TEST_NAME}"
+      build_and_push_test_image "${IMAGE_WITH_TAG}"
+      start_replicated_service "${SERVICE_NAME}" "${IMAGE_WITH_TAG}"
+      start_replicated_service "${SERVICE_NAME_SUFFIX}" "${IMAGE_WITH_TAG}"
+      build_and_push_test_image "${IMAGE_WITH_TAG}"
+      # Set running tasks to 0 for SERVICE_NAME.
+      # But keep tasks running for SERVICE_NAME_SUFFIX.
+      docker_service_update --replicas=0 "${SERVICE_NAME}"
+      wait_zero_running_tasks "${SERVICE_NAME}"
+    }
+    test_no_running_tasks_replicated_user_replicas() {
+      local TEST_NAME="${1}"
+      local SERVICE_NAME="${2}"
+      local REPLICAS_BEFORE=
+      REPLICAS_BEFORE=$(docker_service_replicas "${SERVICE_NAME}")
+      echo "Before updating: REPLICAS_BEFORE=${REPLICAS_BEFORE}"
+      reset_gantry_env "${SUITE_NAME}" "${SERVICE_NAME}"
+      # Test that user could override the replicas.
+      local LABEL_AND_VALUE="gantry.update.options=--replicas=1"
+      docker_service_update --label-add "${LABEL_AND_VALUE}" "${SERVICE_NAME}"
+      local RETURN_VALUE=
+      run_gantry "${SUITE_NAME}" "${TEST_NAME}"
+      RETURN_VALUE="${?}"
+      local REPLICAS_AFTER=
+      REPLICAS_AFTER=$(docker_service_replicas "${SERVICE_NAME}")
+      echo "After updating: REPLICAS_AFTER=${REPLICAS_AFTER}"
+      return "${RETURN_VALUE}"
+    }
+    test_end() {
+      local TEST_NAME="${1}"
+      local IMAGE_WITH_TAG="${2}"
+      local SERVICE_NAME="${3}"
+      local SERVICE_NAME_SUFFIX="${SERVICE_NAME}-suffix"
+      stop_service "${SERVICE_NAME}"
+      stop_service "${SERVICE_NAME_SUFFIX}"
+      prune_local_test_image "${IMAGE_WITH_TAG}"
+      finalize_test "${TEST_NAME}"
+    }
+    BeforeEach "test_start ${TEST_NAME} ${IMAGE_WITH_TAG} ${SERVICE_NAME}"
+    AfterEach "test_end ${TEST_NAME} ${IMAGE_WITH_TAG} ${SERVICE_NAME}"
+    It 'run_test'
+      When run test_no_running_tasks_replicated_user_replicas "${TEST_NAME}" "${SERVICE_NAME}"
+      The status should be success
+      The stdout should satisfy display_output
+      The stdout should satisfy spec_expect_message    "Before updating: REPLICAS_BEFORE=0/0"
+      The stdout should satisfy spec_expect_message    "After updating: REPLICAS_AFTER=1/1"
       The stderr should satisfy display_output
       The stderr should satisfy spec_expect_no_message "${START_WITHOUT_A_SQUARE_BRACKET}"
       # Add "--detach=true" when there is no running tasks.
       # https://github.com/docker/cli/issues/627
-      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--detach=true.*${SERVICE_NAME}\."
-      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--replicas=0.*${SERVICE_NAME}\."
-      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--detach=true.*${SERVICE_NAME_SUFFIX}"
-      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas=0.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--detach=true.*${AUTOMATICALLY}.*${SERVICE_NAME}\."
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--replicas=1.*${SPECIFIED_BY_USER}.*${SERVICE_NAME}\."
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--detach.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas.*${SERVICE_NAME_SUFFIX}"
+      The stderr should satisfy spec_expect_no_message "${SERVICE_NAME}.*${REPLICATED_MODE_NO_RUNNING_TASK}"
       The stderr should satisfy spec_expect_no_message "${SKIP_UPDATING}.*${SERVICE_NAME}"
       The stderr should satisfy spec_expect_message    "${PERFORM_UPDATING}.*${SERVICE_NAME}.*${PERFORM_REASON_HAS_NEWER_IMAGE}"
       The stderr should satisfy spec_expect_no_message "${SKIP_UPDATING}.*${SERVICE_NAME_SUFFIX}"
@@ -136,9 +257,10 @@ Describe "service-no-running-tasks"
       The stderr should satisfy spec_expect_no_message "${START_WITHOUT_A_SQUARE_BRACKET}"
       # Add "--detach=true" when there is no running tasks.
       # https://github.com/docker/cli/issues/627
-      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--detach=true.*${SERVICE_NAME}"
+      The stderr should satisfy spec_expect_message    "${ADDING_OPTIONS}.*--detach=true.*${AUTOMATICALLY}.*${SERVICE_NAME}"
       # Cannot add "--replicas" to global mode
-      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas=0"
+      The stderr should satisfy spec_expect_no_message "${ADDING_OPTIONS}.*--replicas"
+      The stderr should satisfy spec_expect_no_message "${SERVICE_NAME}.*${REPLICATED_MODE_NO_RUNNING_TASK}"
       The stderr should satisfy spec_expect_no_message "${SKIP_UPDATING}.*${SERVICE_NAME}"
       The stderr should satisfy spec_expect_message    "${PERFORM_UPDATING}.*${SERVICE_NAME}.*${PERFORM_REASON_HAS_NEWER_IMAGE}"
       The stderr should satisfy spec_expect_no_message "${NUM_SERVICES_SKIP_JOBS}"
diff --git a/tests/spec_gantry_test_helper.sh b/tests/spec_gantry_test_helper.sh
