跳转到主要内容

Velociraptor的命令行客户端

项目描述

https://img.shields.io/pypi/v/vr.cli.svg https://img.shields.io/pypi/pyversions/vr.cli.svg https://img.shields.io/travis/yougov/vr.cli/master.svg

Velociraptor 群集管理命令行接口和自动化一些常用操作的命令行接口。

实现

该 cli 为 vr.common.models 提供了命令行接口。

功能

vr.cli 支持多个子命令,包括

  • 构建

  • 群集

  • 单元测试

要获取完整命令列表,请在 vr.cli 中使用 –help。

构建

简单地在一个给定的标签下组装一个应用程序的构建版本。这个常规操作在执行其他群集操作之前初始化构建很有用。

群集

这个常规操作在给定标签下派遣一个群集

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

它接受群集名称过滤器、版本号以及可选的排除项作为参数。

名称过滤器区分大小写,但排除项不区分大小写。

单元测试

此常规操作将快速打印出所有失败的单元测试。

进程

列出、启动或停止进程。

比较版本

比较任何两个版本(通过版本 ID 标识)的配置。

配置

vr.cli 命令需要一个 URL 来通过其 REST API 与 Velociraptor 实例通信。默认情况下,URL 是由 DNS 解析的 deploy 名称推断出来的。如果 deploy 解析为 deploy.example.com,则 vr.cli 将使用 https://deploy.example.com 作为 URL。此值可以通过向命令传递 --url 或设置 VELOCIRAPTOR_URL 环境变量来覆盖。

身份验证

Velociraptor 客户端模型(在 vr.common.models 中找到)将默认使用当前用户名(getpass.getuser)。如果您的本地主机的用户名与 Velociraptor 中的用户名不匹配,您可以通过向命令传递 --username 或通过设置任何 getuser 搜索的环境变量 或设置 VELOCIRAPTOR_USERNAME 环境变量来覆盖用户名。

vr.cli 还利用 keyring 来避免每次都输入密码。为此,它需要一个系统名称和用户名。对于用户名,它使用上面解析的用户名。对于系统名称,它默认为 Velociraptor URL 的域名(如上所述)。可以通过设置 VELOCIRAPTOR_AUTH_DOMAIN 环境变量来覆盖域名。

环境变量

对于无人值守使用,也可以通过设置 VELOCIRAPTOR_USERNAMEVELOCIRAPTOR_PASSWORD 环境变量来向 Velociraptor 提供身份验证凭据,这将覆盖上面的交互值。强烈建议不要在交互式使用中采用此技术。

项目详情


下载文件

下载您平台上的文件。如果您不确定要选择哪个,请了解有关 安装包 的更多信息。

源代码分发

vr.cli-4.2.tar.gz (16.0 kB 查看哈希值)

上传时间 源代码

构建分发

vr.cli-4.2-py2.py3-none-any.whl (7.3 kB 查看哈希值)

上传时间 Python 2 Python 3