为Chef服务器索引提供的Web前端
项目描述
为Chef服务器索引提供的Web前端,显示节点、角色和环境,以及由Ohai插件收集的数据(特别是已安装的软件包版本)。
安装
使用以下命令安装Sous-chef和Gunicorn
pip install 'sous-chef[deploy]'
要求
需要Flask和PyChef。 Gunicorn是部署的最简单方法,但不是必需的(允许使用其他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.py和sous_chef/__init__.py中设置。
应尽可能让尽可能多的功能能够“开箱即用”,并无需显式配置即可运行 - 需要配置才能使用的功能要么应该回退到替代方案,要么默认关闭。
可选集成(如现有的Flask DebugToolbar集成)应在extras_require中定义要求,而不是在install_requires中,并确保如果未满足要求不会崩溃。
许可证
Sous-Chef是在MIT许可证下授权的。
此项目包含Bootstrap和jQuery的副本,这两者也都是MIT许可证。
版权(c)2014 DataSift <opensource@datasift.com>
在此,免费授予任何获得本软件及其相关文档文件(“软件”)副本的个人无限制地处理软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许软件提供者为此目的而使用软件,前提是遵守以下条件
上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。
软件按“现状”提供,不提供任何形式的保证,无论是明示的还是暗示的,包括但不限于适销性、针对特定目的的适用性和非侵权性。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论这些责任是因合同、侵权或其他原因而产生的,无论这些责任是否与软件或其使用或其他方式有关。
项目详情
下载文件
下载适用于您的平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。
源分布
构建发行版
sous-chef-2.7.0.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 85db3a750181dcc2b69a52942ddec2f2851717f8469c02d1a4bffb559a19223f |
|
MD5 | 23cfa1babb01245ada8bc0150b14b48c |
|
BLAKE2b-256 | cb4fbdffb1b51af996516c8303816b944239e729c0d7f62bf19b41841e34b359 |
sous_chef-2.7.0-py2-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 269afcef599d7fb0619da7c71db46d12da7498a1b20e7f3f9a221504a44c6fd8 |
|
MD5 | 99ee77ea275e391eaa7377c71a7f5d78 |
|
BLAKE2b-256 | 6f8a9b2f2769173a4936b81829cabfde6049dd43711166ed251922d2d241b397 |