# <str<vault>> representing password for Linux root user account of VPS
password: ""
# <str<vault>> representing API token for VPS cloud service
token: ""
# <str> representing name and hostname of VPS to be made in VPS cloud service
instance: ""
# <str<enum>> representing region options from or for given VPS cloud service
origin: ""
# <str<enum>> representing Linux distro or OS image available in VPS service to be used for VPS
operating_system: ~
# <list[<str>]> of control node or local SSH key basenames
ssh_keys: []
# @TODO change 'key' attributes of package entres under 'mngr' section below to 'signkey' 
# and edit 'roles/init-server/install-pks.yml' accordngly
# <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: ""
        uri: ""
        sigkey: ""
        sources: ""
        types: ""
        suites: ""
        comps: ""
    # <list[<dict>]> representing user-level or supplemental packages
    userspace:
      - name: ""
        uri: ""
        sigkey: ""
        sources: ""
        types: ""
        suites: ""
        comps: ""
  # <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 container image 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: []