The debops command

The debops command provides multiple sub-commands, some of which are split into sections.

debops project

This section includes commands used to create and maintain the "project directories" which contain one or multiple Ansible inventories, PKI infrastructure, GPG keyring, and other resources used in a particular environment.

debops exec

This command can be used to execute Ansible modules ad-hoc against a given environment. You can use any arguments accepted by the ansible command - they will be executed in the DebOps project context, including the runtime environment variables and with the ansible/secret/ directory unlocked if necessary.

debops run

This command can be used to execute Ansible playbooks against a given environment. The playbooks used can come either from the DebOps Python package (included by default), from an Ansible Collection, or from the ansible/playbooks/ directory in a given project. You can also specify all ansible-playbook arguments to affect the Ansible execution;

debops check

This command is the same as the debops run command above, but automatically adds the --diff and --check ansible-playbook options to ensure that the playbooks are executed in a check mode;

debops env

This command can be used to inspect the environment variables which will be present when various DebOps commands are executed. It can also be used to run shell commands in DebOps environment, which is a handy shortcut for using Ansible ecosystem with DebOps project directories.

debops config

This command allows the user to inspect and manipulate the DebOps configuration options in various formats;

You can find more information about these subcommands in the DebOps documentation, debops-* manual pages or by running them with the --help option.

Options

-h, --help

Display the help and usage information

--version

Display the version of the debops scripts

Verbose mode and logging

The debops script can send log messages about its operation to the syslog service. Using configuration options, users can specify where to send the log messages, default log level and facility.

Users can specify the --verbose or -v flag in the debops subcommands to increase the script verbosity. The flag enables log output to the standard error (stderr) stream. Multiple uses of the flag increase the log level from the default WARNING to NOTICE, INFO and DEBUG with -vvv respectively.

To view the logs from debops using journald service, run the command:

journalctl -f _COMM=debops

Environment variables

These environment variables can be used to affect the environment during script execution:

DEBOPS_CMD_ANSIBLE

Path to the ansible binary used by DebOps. Can be overridden by configuration files.

DEBOPS_CMD_ANSIBLE_PLAYBOOK

Path to the ansible-playbook binary used by DebOps. Can be overridden by configuration files.

DEBOPS_CMD_GPG

Path to the gpg binary used by DebOps. Can be overridden by configuration files.

DEBOPS_CMD_ENCFS

Path to the encfs binary used by DebOps. Can be overridden by configuration files.

DEBOPS_CMD_UMOUNT

Path to the umount binary used by DebOps on Darwin-based hosts. Can be overridden by configuration files.

DEBOPS_CMD_FUSERMOUNT

Path to the fusermount binary used by DebOps. Can be overridden by configuration files.