The debops project section

The debops project section contains commands related to creation and maintenance of the DebOps project directories. Each project directory can contain one or more Ansible inventories, a PKI infrastructure, and various other resources used in a given environment.

debops project init

This command can be used to initialize a new project directory, specified as the main argument. The script will check if a .debops.cfg file exists in a given directory; if not, it will be created along with a basic directory structure.

Options

-h, --help
Display the help and usage information
-t <legacy|modern>, --type <legacy|modern>

Select the type of the project directory:

  • legacy: simple directory layout with a single Ansible inventory (default)
  • modern: more complicated directory layout with multiple Ansible inventories separated into "infrastructure views"
-V <view>, --default-view <view>
Specify the name of the "infrastructure view" used by default. If not specified, "system" will be created automatically. You can use slashes (/) to create hierarchical views, but nesting a view inside of another view is not allowed.
--git
Initialize a git repository in the project directory (planned)
--no-git
Do not initialize a git repository, if it's created by default (planned)
--encrypt <encfs|git-crypt>

Prepare the project directory to host encrypted ansible/secret/ subdirectory, used to store passwords, encryption keys and other confidential information. See the debops.secret Ansible role for more details.

You need to specify either encfs or git-crypt (planned) to select the encryption method. If encryption is enabled, you need to specify the list of GPG recipients as well, using the --keys option.

--keys <recipient>[,recipient]
A list of GPG recipients (e-mail addresses or key IDs) which will be allowed to unlock the ansible/secret/ directory encrypted with EncFS or git-crypt. Separate multiple list entries by commas.
-v, --verbose
Increase output verbosity. More letters means higher verbosity.
<project_dir>
Path to the DebOps project directory to initialize. If not specified, DebOps will try to use the current directory to create a new project directory. The script will check if the current directory is a home directory and will stop operation in this case.

Examples

Create a basic DebOps project directory:

debops project init ~/src/projects/myproject

Create a project directory with multiple infrastructure views:

debops project init --type modern ~/src/projects/myproject

Create a project directory with EncFS encryption for secrets:

debops project init --encrypt encfs \
                    --keys admin@example.org,otheradmin@example.org \
                    ~/src/projects/example.org

debops project mkview

This command can be used in an existing project directory to create a new "infrastructure view", which contains:

  • separate ansible.cfg configuration file
  • separate Ansible inventory
  • separate secret/ directory for the debops.secret role
  • separate resources/ directory for the debops.resources role
  • its own set of Ansible playbooks and roles

Each view has its own configuration entry in the DebOps configuration tree.

Options

-h, --help
Display the help and usage information
--project-dir <project_dir>
Path to the project directory to work on. If it's not specified, the script will use the current directory.
--encrypt <encfs|git-crypt>

Prepare the new infrastructure view to host encrypted <view>/secret/ subdirectory, used to store passwords, encryption keys and other confidential information. See the debops.secret Ansible role for more details.

You need to specify either encfs or git-crypt (planned) to select the encryption method. If encryption is enabled, you need to specify the list of GPG recipients as well, using the --keys option.

--keys <recipient>[,recipient]
A list of GPG recipients (e-mail addresses or key IDs) which will be allowed to unlock the <view>/secret/ directory encrypted with EncFS or git-crypt. Separate multiple list entries by commas.
-v, --verbose
Increase output verbosity. More letters means higher verbosity.
<new_view>
Name of the view to create. It will be used in the file system as well as in the configuration tree. You can use slashes (/) to create hierarchical views, but nesting a view inside of another view is not allowed.

Examples

Create a new infrastructure view in the DebOps project directory:

debops project mkview deployment

Create a new infrastructure view with encrypted secrets:

debops project mkview --encrypt encfs \
                      --keys admin@example.org,otheradmin@example.org \
                      deployment

debops project refresh

This command can be used to "refresh" a given DebOps project directory. By default DebOps does not modify an existing ansible.cfg configuration file. This allows the user to test new configuration if needed. When the debops project refresh command is called, DebOps will generate a new ansible.cfg configuration file based on the contents of its own internal configuration. The script will also ensure that the basic directory structure of a project exists.

Options

-h, --help
Display the help and usage information
-v, --verbose
Increase output verbosity. More letters means higher verbosity.
<project_dir>
Path to the project directory to refresh.

debops project unlock

When the project directory contains an encrypted ansible/secret/ directory, this command can be used to unlock it and provide access to encrypted data. This only works for project directories that have been initialized with EncFS or git-crypt support (or that support has been configured manually).

Keep in mind that after unlocking the directory manually, DebOps will not lock it on subsequent Ansible runs. In such case you should use the debops project lock command to secure the secrets.

Options

-h, --help
Display the help and usage information
-V <view>, --view <view>
Specify the name of the "infrastructure view" to unlock. If not specified, the default view will be used automatically. Using this option overrides the automatic view detection performed by DebOps based on the current working directory.
-v, --verbose
Increase output verbosity. More letters means higher verbosity.
<project_dir>
Path to the project directory to unlock.

debops project lock

This command can be used to lock and secure the ansible/secret/ directory after it has been unlocked using the debops project unlock command. This only works in project directories that have been configured with either EncFS or git-crypt encryption during initialization.

Options

-h, --help
Display the help and usage information
-V <view>, --view <view>
Specify the name of the "infrastructure view" to lock. If not specified, the default view will be used automatically. Using this option overrides the automatic view detection performed by DebOps based on the current working directory.
-v, --verbose
Increase output verbosity. More letters means higher verbosity.
<project_dir>
Path to the project directory to lock.