do-audit 0.1.1

Audit your Digital Ocean account and make sure you know what's up

Audit your Digital Ocean account and make sure you know what’s up.

The script can currently list your droplets and domains information and has a ping-domains command which sends a test request to all your domains and checks the response for you.

Built to suit our own needs - which it did - but feel free to propose or implement new features.

Installation

>From PyPI (recommended):

$ pip install do-audit

With git clone:

$ git clone https://github.com/omni-digital/do-audit
$ pip install -r do-audit/requirements.txt
$ cd do-audit/bin

Usage

To use the script you’ll need Digital Ocean access token and either save it as an environment variable ($ export DO_ACCESS_TOKEN='...') or pass it explicitly (do-audit -t '...') with each command. Everything else should be pretty straightforward:

$ do-audit --help
Usage: do-audit [OPTIONS] COMMAND [ARGS]...

  Simple command line interface for doing an audit of your Digital Ocean
  account and making sure you know what's up.

  See https://github.com/omni-digital/do-audit for more info.

Options:
  -t, --access-token TEXT         Digital Ocean API access token.
  -o, --output-file FILENAME      Output file path.
  -f, --data-format [json|xls|yaml|csv|dbf|tsv|html|latex|xlsx|ods]
                                  Output file dat format.
  -v, --verbose                   Show extra information.
  --help                          Show this message and exit.

Commands:
  account       Show basic account info
  domains       List your domains
  droplets      List your droplets
  ping-domains  Ping your domains and see what's the response

Examples

The script has four subcommands, all with the same available options:

$ do-audit account
Email:              [e-mail]
Status:             active
Droplet limit:      25

Each command has a --verbose option that shows more information:

$ do-audit account -v
Email:              [e-mail]
Status:             active
Droplet limit:      25
Floating IP limit:  3
UUID:               uuid

Both domains and droplets subcommands work the same way:

$ do-audit droplets
# ubuntu-512mb-lon1-01 (active)
OS:                 Ubuntu 16.04.2x 64
IP:                 192.168.1.0
CPU:                1
Memory:             512 MB
Disk:               20 GB
URL:                https://cloud.digitalocean.com/droplets/2/graphs
Created at:         Mon, 05/08/17 12:52:22

$ do-audit domains
# example.com
@                                   A          192.168.0.1
blog                                A          192.168.0.1

# example.co.uk
@                                   A          192.168.0.2
www                                 A          192.168.0.2

All commands can be exported to a file:

$ do-audit account -o account.csv
CSV data was successfully exported to 'account.csv'

$ cat account.csv
Email,Status,Droplet limit
[e-mail],active,25

$ do-audit droplets -o droplets.csv -f json
JSON data was successfully exported to 'droplets.json'

Tests

Package was tested with the help of py.test and tox on Python 2.7, 3.4, 3.5 and 3.6 (see tox.ini).

To run tests yourself you need to run tox inside the repository:

$ pip install tox
$ tox

Contributions

Package source code is available at GitHub.

Feel free to use, ask, fork, star, report bugs, fix them, suggest enhancements, add functionality and point out any mistakes. Thanks!

Authors

Developed and maintained by Omni Digital.

Released under MIT License.