Additional Setup Work

.circleci/test-deploy.yml

@@ -15,8 +15,7 @@ jobs:
       - image: cimg/base:current
     steps:
       - checkout
-      # Run your orb's commands to validate them.
-      - workflow-queue/greet
+      - workflow-queue/queue
 workflows:
   test-deploy:
     jobs:

.yamllint

@@ -4,4 +4,3 @@ rules:
     line-length:
         max: 200
         allow-non-breakable-inline-mappings: true
-

src/commands/queue.yml

@@ -0,0 +1,37 @@
+description: >
+  This command is executed and blocks further execution until the necessary criteria is met.
+
+parameters:
+  debug:
+    type: boolean
+    default: true
+    description: "If enabled, DEBUG messages will be logged."
+  time:
+    type: string
+    default: "10"
+    description: "Minutes to wait before giving up."
+  dont-quit:
+    type: boolean
+    default: false
+    description: "Force job through once time expires instead of failing."
+  only-on-branch:
+    type: string
+    default: "*"
+    description: "Only queue on specified branch"
+  confidence:
+    type: string
+    default: "1"
+    description: >
+      Due to concurrency issues, how many times should we requery the pipeline list to ensure previous jobs are "pending",
+      but not yet active. This number indicates the threshold for API returning no previous pending pipelines.
+      Default is one confirmation, increase if you see issues.
+  circleci-user-auth:
+    type: env_var_name
+    default: CIRCLECI_USER_AUTH
+    description: "In the event you wish to supply CCI basic-auth credentials via a different environment value, set the name here."
+steps:
+- run:
+      name: Queue Until Front of Line
+      environment:
+        DEBUG_ENABLED: "<< parameters.debug >>"
+      command: <<include(scripts/queue.sh)>>

src/jobs/queue.yml

@@ -0,0 +1,44 @@
+description: >
+  This job is executed and blocks further execution until the necessary criteria is met.
+
+docker:
+  - image: cimg/base:stable
+resource_class: small
+
+parameters:
+  debug:
+    type: boolean
+    default: false
+    description: "If enabled, DEBUG messages will be logged."
+  time:
+    type: string
+    default: "10"
+    description: "Minutes to wait before giving up."
+  dont-quit:
+    type: boolean
+    default: false
+    description: "Force job through once time expires instead of failing."
+  only-on-branch:
+    type: string
+    default: "*"
+    description: "Only queue on specified branch"
+  confidence:
+    type: string
+    default: "1"
+    description: >
+      Due to concurrency issues, how many times should we requery the pipeline list to ensure previous jobs are "pending",
+      but not yet active. This number indicates the threshold for API returning no previous pending pipelines.
+      Default is one confirmation, increase if you see issues.
+  circleci-user-auth:
+    type: env_var_name
+    default: CIRCLECI_USER_AUTH
+    description: "In the event you wish to supply CCI basic-auth credentials via a different environment value, set the name here."
+
+steps:
+  - queue:
+      debug: << parameters.debug >>
+      time: <<parameters.time>>
+      dont-quit: <<parameters.dont-quit>>
+      only-on-branch: <<parameters.only-on-branch>>
+      confidence: <<parameters.confidence>>
+      circleci-user-auth: <<parameters.circleci-user-auth>>

src/scripts/queue.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+
+debug() {
+    if [ -n "${DEBUG_ENABLED}" ]; then
+        echo "DEBUG: ${*}"
+    fi
+}
+
+debug "this is a test"
+echo "this is a test"