# <str<vault>> representing password for Linux root user account of LAN server on PC
password: ""
# <str<vault>> administrative API token or  PXE server authentication key/password
token: ~
# <str> representing hostname for LAN server; same as host or group variable name
instance: ""
# <str<enum>> representing Linux distro or OS image to be used for VPS; can be PXE server URI/URL link
# Example-- operating_system: "tftp://hikiki.local:69/debian.iso"
operating_system: ~
# <list[<str>]> of control node or local SSH key basenames
ssh_keys: []
# <dict[<str>:<dict>]> package groups
pkgs:
  # <dict[<str>:<dict>]> representing package groups installed by package manager via repositories
  mngr:
    # <list[<dict>]> representing system-level or essential packages
    core:
      - name: "" # <str> name of package in repositori/repositories; used by handler listener
        uri: "" # <str> URI/URL or path to package installation file
        key: "" # <str> URI/URL or path to package signing key
        key_path: "" # <str> destination path of signing key
        src_entry: "" # <str> repository entry line/block
        src_path: "" # <str> filepath for repository entry insertion
    # <list[<dict>]> representing user-level or supplemental packages
    userspace:
      - name: ""
        uri: ""
        key: ""
        key_path: ""
        src_entry: ""
        src_path: ""
  # <dict[<str>:<dict>]> representing package groups installed by shell scripts
  script:
    # <list[<dict>]> representing system-level or essential shell script software installations
    core:
      - name: "" # <str> arbitrary name, used by handler listener
        src: "" # <str> URI/URL or path to software installation shell script
        pre: "" # <str> URI/URL or path to shell script, or name of handler listener, for pre-installation actions
        post: "" # <str> URI/URL or path to shell script, or name of handler listener, for post-installation actions
    # <list[<dict>]> representing user-level or supplemental shell script software installations
    userspace:
      - name: ""
        src: ""
        pre: ""
        post: ""
  # <dict[<str>:<dict>]> representing package groups installed from source archives
  archive:
    # <list[<dict>]> representing system-level or essential source archives
    core:
      - name: "" # <str> arbitrary name, used by handler listener
        src: "" # <str> URI/URL or path of archive file for software build
        deploy: "" # <str> URI/URL or path to shell script, or handler listener name, to build software from archive
        pre: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take before software build
        post: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take after software build
    # <list[<dict>]> representing user-level or supplemental source archives
    userspace:
      - name: ""
        src: ""
        deploy: ""
        pre: ""
        post: ""
  # <dict[<str>:<dict>]> representing package groups installed from source git repositories
  git_repos:
    # <list[<dict>]> representing system-level or essential git repositories
    core:
      - name: "" # <str> arbitrary name, used by handler listener
        src: "" # <str> URI/URL or path of git repository
        src_path: "" # <str> path in which to place git repository clone
        branch: "" # <str> specific branch to pull or otherwise to swtich into
        deploy: "" # <str> URI/URL or path to shell script, or handler listener name, to build or run from source repository
        pre: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take before building or running from source repository
        post: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take after building or running from source repository
    # <list[<dict>]> representing user-level or supplemental git repositories
    userspace:
      - name: "" # <str> arbitrary name, used by handler listener
        src: "" # <str> URI/URL or path of git repository
        src_path: "" # <str> path in which to place git repository clone
        remote: "" # <str> the name of the remote source of the git repository
        branch: "" # <str> specific branch to pull or otherwise to swtich into
        deploy: "" # <str> URI/URL or path to shell script, or handler listener name, to build or run from source repository
        pre: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take before building or running from source repository
        post: "" # <str> URI/URL or path to shell script, or handler listener name, for actions to take after building or running from source repository
  # <dict[<str>:<dict>]> representing package groups installed via container engine
  containers:
    # <list[<dict>]> representing system-level or essential container images
    core: []
    # <list[<dict>]> representing user-level or supplemental container images
    userspace: []
  # <dict[<str>:<dict>]> representing package groups installed via snap package
  snaps:
    # <list[<dict>]> representing system-level or essential packages
    core: []
    # <list[<dict>]> representing user-level or supplemental packages
    userspace: []
  # <dict[<str>:<dict>]> representing flatpak groups installed via flatpak package
  flatpaks:
    # <list[<dict>]> representing system-level or essential flatpaks
    core: []
    # <list[<dict>]> representing user-level or supplemental flatpaks
    userspace: []
core_pkgs: [] # @TODO document this