跳转到主要内容

为Chef服务器索引提供的Web前端

项目描述

Sous-chef on PyPI Sous-chef on PyPI Travis-CI build status for Sous-chef GitHub issues for Sous-chef

为Chef服务器索引提供的Web前端,显示节点、角色和环境,以及由Ohai插件收集的数据(特别是已安装的软件包版本)。

安装

使用以下命令安装Sous-chef和Gunicorn

pip install 'sous-chef[deploy]'

要求

需要FlaskPyChefGunicorn是部署的最简单方法,但不是必需的(允许使用其他WSGI服务器)。可选地使用通过debug应用程序使用的Flask Debug Toolbar

兼容性

针对Python 2.6和2.7进行优化,因为依赖于PyChef

用法

使用Gunicorn运行Sous-chef

gunicorn 'sous_chef:create_app()'

配置

Sous-chef将从安装方式决定的两个地方之一读取其配置

# Global install
/usr/var/sous_chef-instance/config.py

# Virtualenv install
$VIRTUALENV/var/sous_chef-instance/config.py

示例配置文件可能如下所示

# The URL of the Chef server
CHEF_URL = 'http://chef.example.com'

# The client name and key to use
CHEF_CLIENT = 'sous'
CHEF_KEY = '/usr/var/sous_chef-instance/sous.pem'

如果这些未设置,则将使用PyChef的autoconfigure函数作为后备,并尝试从~/.chef/knife.rb/etc/chef/client.rb加载其配置。

软件包版本

Sous-chef将显示可用的节点软件包元数据。它期望此数据采用以下格式

"packages": {
        "<package_type>": {
                "<package_name>": {
                        "version": "<package_version"
                },
                ...
        },
        ...
}

例如,一个RPM Ohai插件可以设置以下节点属性

"packages": {
        "rpm": {
                "package-one": {
                        "version": "0.1.0",
                },
                "package-two": {
                        "version": "2.0.1",
                }
        }
}

调试模式

可以通过使用create_debug_app函数在调试模式下运行应用程序

gunicorn 'sous_chef:create_debug_app()'

如果可用,将加载DebugToolbar扩展,并可以使用它来在浏览器中显示调试信息。

贡献

欢迎贡献 - 问题和建议功能请使用GitHub问题跟踪器,并针对develop分支提交pull请求。

问题被分配了简单中等困难的标签,这表明实现功能请求的难易程度或修复bug的难度。欢迎修复或实现任何未分配的问题。

请注意,新的功能应该对应用程序的所有用户都有用 - 仅能使用内部组件或需要超过Chef服务器的显著基础设施的功能不太可能获得批准(尽管仍可讨论)。

代码风格和设计

Python代码应使用PEP8风格,并最好通过所有flake8测试。版本号应使用语义化版本控制规范,并在setup.pysous_chef/__init__.py中设置。

应尽可能让尽可能多的功能能够“开箱即用”,并无需显式配置即可运行 - 需要配置才能使用的功能要么应该回退到替代方案,要么默认关闭。

可选集成(如现有的Flask DebugToolbar集成)应在extras_require中定义要求,而不是在install_requires中,并确保如果未满足要求不会崩溃。

许可证

Sous-Chef是在MIT许可证下授权的。

此项目包含BootstrapjQuery的副本,这两者也都是MIT许可证。

版权(c)2014 DataSift <opensource@datasift.com>

在此,免费授予任何获得本软件及其相关文档文件(“软件”)副本的个人无限制地处理软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许软件提供者为此目的而使用软件,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“现状”提供,不提供任何形式的保证,无论是明示的还是暗示的,包括但不限于适销性、针对特定目的的适用性和非侵权性。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论这些责任是因合同、侵权或其他原因而产生的,无论这些责任是否与软件或其使用或其他方式有关。

作者

sous-chef是由Sam ClementsDataSift编写的。

https://gravatar.com/avatar/8dd5661684a7385fe723b7e7588e91ee?s=40 https://gravatar.com/avatar/a3a6d949b43b6b880ffb3e277a65f49d?s=40

项目详情


下载文件

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

源分布

sous-chef-2.7.0.tar.gz (71.5 kB 查看哈希值)

上传时间: 源代码

构建发行版

sous_chef-2.7.0-py2-none-any.whl (80.8 kB 查看哈希值)

上传时间: Python 2

由...