Skip to content

📜 Authoring scripts

Requirements

Note

Please refer to RFC2119 for meaning of words MUST, SHOULD and MAY.

  1. MUST adhere to POSIX standard.
  2. MUST pass Shellcheck code analysis scan
  3. MUST start with: 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
     #!/usr/bin/env bash
 ##
 # Action description that the script performs.
 #
 # More description and usage information with a last empty
 # comment line.
 #

 set -eu
 [ "${DREVOPS_DEBUG-}" = "1" ] && set -x
  4. MUST list all variables with their default values and descriptions. i.e.: 
    1
2
    # Deployment reference, such as a git SHA.
DREVOPS_NOTIFY_REF="${DREVOPS_NOTIFY_REF:-}"
  5. MUST include a delimiter between variables and the script body preceded and followed by an empty line (3 lines in total): 
    1
    # ------------------------------------------------------------------------------
  6. SHOULD include formatting helper functions: 
    1
2
3
4
5
6
    # @formatter:off
note() { printf "       %s\n" "$1"; }
info() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[34m[INFO] %s\033[0m\n" "$1" || printf "[INFO] %s\n" "$1"; }
pass() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[32m[ OK ] %s\033[0m\n" "$1" || printf "[ OK ] %s\n" "$1"; }
fail() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[31m[FAIL] %s\033[0m\n" "$1" || printf "[FAIL] %s\n" "$1"; }
# @formatter:on
  7. SHOULD include variable values checks with errors and early exist, i.e.: 
    1
    [ -z "${DREVOPS_NOTIFY_REF}" ] && fail "Missing required value for DREVOPS_NOTIFY_REF" && exit 1
  8. SHOULD include binaries checks if the script relies on them, i.e.: 
    1
    command -v curl > /dev/null || ( fail "curl command is not available." && exit 1 )
  9. MUST contain an info message about the start of the script body, e.g.: 
    1
    info "Started GitHub notification for operation ${DREVOPS_NOTIFY_EVENT}"
  10. MUST contain an pass message about the finish of the script body, e.g.: 
    1
    pass "Finished GitHub notification for operation ${DREVOPS_NOTIFY_EVENT}"
  11. MUST use uppercase global variables
  12. MUST use lowercase local variables.
  13. MUST use long options instead of short options for readability. I.e., drush cache:rebuild instead of drush cr.
  14. MUST use DREVOPS_ prefix for variables, unless it is a known 3-rd party variable like GITHUB_TOKEN or COMPOSER.
  15. MUST use script-specific prefix. I.e., for notify.sh, the variable to skip notifications should start with DREVOPS_NOTIFY_.
  16. MAY rely on variables from the external scripts (not prefixed with a script-specific prefix), but MUST declare such variables in the header of the file.
  17. MAY call other DrevOps scripts (discouraged), but MUST source them rather than creating a sub-process. This is to allow passing environment variables down the call stack.
  18. SHOULD use note messages for informing about the script progress.

Scaffold script

Use the scaffold script below to kick-start your custom DrevOps script.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
#!/usr/bin/env bash
##
# Action description that the script performs.
#
# More description and usage information with a last empty
# comment line.
#

set -eu
[ "${DREVOPS_DEBUG-}" = "1" ] && set -x

# Example scaffold variable with a default value.
DREVOPS_SCAFFOLD_EXAMPLE_URL="${DREVOPS_SCAFFOLD_EXAMPLE_URL:-http://example.com}"

# ------------------------------------------------------------------------------

# @formatter:off
note() { printf "       %s\n" "$1"; }
info() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[34m[INFO] %s\033[0m\n" "$1" || printf "[INFO] %s\n" "$1"; }
pass() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[32m[ OK ] %s\033[0m\n" "$1" || printf "[ OK ] %s\n" "$1"; }
fail() { [ "${TERM:-}" != "dumb" ] && tput colors >/dev/null 2>&1 && printf "\033[31m[FAIL] %s\033[0m\n" "$1" || printf "[FAIL] %s\n" "$1"; }
# @formatter:on

info "Started scaffold operations."

[ -z "${DREVOPS_SCAFFOLD_EXAMPLE_URL}" ] && fail "Missing required value for DREVOPS_SCAFFOLD_EXAMPLE_URL" && exit 1
command -v curl >/dev/null || (fail "curl command is not available." && exit 1)

# Example of the script body.
curl -L -s -o /dev/null -w "%{http_code}" "${DREVOPS_SCAFFOLD_EXAMPLE_URL}" | grep -q '200\|403' && note "Requested example page"

pass "Finished scaffold operations."