跳转到主要内容

Concierge仓库项目管理的命令行工具。

项目描述

GitHub Workflow Status GitHub Workflow Status Code health Python versions Software license

Concierge的配套命令行工具,用于配置管理及CI解决方案,以便对您的多个Git仓库进行对齐。允许您批量管理Git仓库项目的属性。目前支持GitLab。

为什么我应该使用这个工具?

Concierge-cli可以帮助您分析和批量更新您管理的仓库项目(例如,为项目设置主题、为ModuleSync生成项目列表)。

安装

从PyPI

$ pip install concierge-cli

注意:您需要Python >= 3.6,否则您的安装将不会成功(python-gitlab v2.0.0 已停止支持旧版本的Python)。您可以使用Pipenv来解决这个问题。

$ pip install pipenv
$ pipenv shell --three
$ pip install concierge-cli

准备

您需要一个GitLab用户的访问令牌来通过API访问资源。对于组和组成员,需要是管理员用户。您可能还需要禁用您计划进行批量更新的用户的通知,以避免发送大量电子邮件。

设置GitLab URI和TOKEN为环境变量(如果您想避免使用--token和/或--uri选项)

$ export CONCIERGE_GITLAB_URI=https://git.example.com/
$ export CONCIERGE_GITLAB_TOKEN=<redacted>

用法模式

  1. 管理项目主题

  2. 按主题列出项目

  3. 按项目列出(并合并)合并请求

  4. 管理组成员资格和权限

管理主题

列出所有尚未添加主题的私有GitLab项目

$ concierge-cli gitlab --uri https://git.vs.hn topics --empty

列出所有“foo”或类似名称在“bar”或类似组中的项目:(在GitLab.com上)

$ concierge-cli gitlab topics bar/foo --empty

为所有这些项目设置主题

$ concierge-cli gitlab topics bar/foo --empty --set-topic Puppet --set-topic Ansible

列出现在所有带有主题的项目:双重检查

$ concierge-cli gitlab topics bar/foo

列出项目

打印所有匹配主题的项目YAML列表

$ concierge-cli gitlab projects --topic Puppet

使用特定配置更新Concierge管理的模块列表

$ concierge-cli gitlab projects --topic Puppet > configs/foo-bar/managed_modules.yml
$ git add -v configs/foo-bar/managed_modules.yml
$ git status && git commit -m 'Added ...' && git push

合并请求

列出项目的所有合并请求,可选地匹配标签

$ concierge-cli gitlab mrs mygroup/myproject --label mylabel

添加--merge yes以触发所有找到的请求的合并。

组成员资格

列出用户尚未成为成员的所有组

$ concierge-cli gitlab groups --no-member my.user.name

将用户添加到所有这些组

$ concierge-cli gitlab groups --no-member my.user.name \
                       --set-permission maintainer

列出用户组成员资格和权限

$ concierge-cli gitlab groups my.user.name

从选定组中删除用户

$ concierge-cli gitlab groups my.user.name \
                       --group-filter a-group-name \
                       --set-permission none

发现了一个错误?需要新功能?

如果您想帮忙,请参阅我们的贡献指南

项目详情


下载文件

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

源分发

concierge-cli-1.7.2.tar.gz (11.9 kB 查看散列值)

上传时间

构建分发

concierge_cli-1.7.2-py3-none-any.whl (11.4 kB 查看散列值)

上传时间 Python 3

由以下支持

AWSAWS 云计算和安全赞助商 DatadogDatadog 监控 FastlyFastly CDN GoogleGoogle 下载分析 MicrosoftMicrosoft PSF赞助商 PingdomPingdom 监控 SentrySentry 错误记录 StatusPageStatusPage 状态页面