https://github.com/yougov/vr.cli

https://github.com/yougov/vr.cli

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/yougov/vr.cli
• Owner: yougov
• License: mit
• Created: 2016-10-04T15:25:16.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-03-18T20:19:55.000Z (almost 6 years ago)
• Last Synced: 2024-11-13T02:49:38.349Z (about 2 months ago)
• Language: Python
• Size: 423 KB
• Stars: 1
• Watchers: 4
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
.. image:: https://img.shields.io/pypi/v/vr.cli.svg

   :target: https://pypi.org/project/vr.cli

.. image:: https://img.shields.io/pypi/pyversions/vr.cli.svg

.. image:: https://img.shields.io/travis/yougov/vr.cli/master.svg

   :target: https://travis-ci.org/yougov/vr.cli

.. .. image:: https://img.shields.io/appveyor/ci/jaraco/skeleton/master.svg

..    :target: https://ci.appveyor.com/project/jaraco/skeleton/branch/master

.. .. image:: https://readthedocs.org/projects/skeleton/badge/?version=latest

..    :target: https://skeleton.readthedocs.io/en/latest/?badge=latest

A command-line interface for wrangling Velociraptor swarms and automating

some common operations.

Implementation

==============

The cli provides a command-line interface around the vr.common.models.

Features

========

``vr.cli`` supports several sub-commands, including:

 - build

 - swarm

 - uptests

For a complete list of commands, invoke vr.cli with --help.

Build

-----

Simply assemble a build of an app at a given tag. This routine is useful to

prime an build before doing other swarm operations.

Swarm

-----

This routine dispatch a swarm at a given tag::

    vr.cli swarm MyApp-Recipe_.* 3.0 -x Recipe_Skipped

It takes as its parameters a filter of swarm name, a version number, and

optionally some excludes.

The name filter is case sensitive, but the excludes are case insensitive.

Uptests

-------

This routine will provide a quick printout of all failing uptests.

Procs

-----

List, start, or stop procs.

Compare Releases

----------------

Compare the configuration of any two releases (indicated by release ID).

Configuration

=============

The ``vr.cli`` command requires a URL to communicate with the

Velociraptor instance via its REST api. By default, the URL is inferred from

the name ``deploy`` as resolved by DNS. If ``deploy`` resolves as

``deploy.example.com``, ``vr.cli`` will use https://deploy.example.com as

the URL. The value can be overridden by passing ``--url`` to the command or by

setting the ``VELOCIRAPTOR_URL`` environment variable.

Authentication

--------------

The Velociraptor client models (found in vr.common.models) will default to

using the current username (getpass.getuser). If your username on your local

host doesn't match your username in Velociraptor, you can override the

username by passing ``--username`` to the command or by setting any of the

`environment variables searched by getuser

`_

or by setting ``VELOCIRAPTOR_USERNAME`` environment variable.

``vr.cli`` also leverages keyring to avoid entering passwords each time.

To do this, it needs a system name and username. For the username, it uses

the username resolved above. For the system name, it defaults to the domain

name of the Velociraptor URL (as resolved above). The domain can be overridden

by setting the ``VELOCIRAPTOR_AUTH_DOMAIN`` environment variable.

Environment Variables

---------------------

For unattended use, it's also possible to supply authentication credentials to

Velociraptor by setting the ``VELOCIRAPTOR_USERNAME`` and

``VELOCIRAPTOR_PASSWORD`` environment variables, which will supersede

the interactive values above. This technique is strongly discouraged for

interactive use.