项目
projects 命令(别名 p)用于管理 Redmine 项目。
list 列出所有项目。
get 查看单个项目,可选包含关联数据。
create 创建新项目。
update 更新字段、跟踪标签、模块及默认值。
archive 归档项目(Redmine 5.0+)。
unarchive 恢复已归档的项目(Redmine 5.0+)。
delete 永久删除项目。
members 列出成员及其角色。
redmine projects list [flags]| 标志 | 描述 |
|---|---|
--include | 附加数据,可重复或以逗号分隔:trackers、issue_categories、enabled_modules、time_entry_activities、issue_custom_fields |
--limit | 最大结果数 |
--offset | 分页偏移量 |
-o, --output | 输出格式:table、json、csv |
表格视图始终显示 ID, Identifier, Name, Status, Public。如需查看通过 --include 请求到的额外字段,请使用 --output json。
redmine projects get <identifier> [flags]别名:show、view。
| 标志 | 描述 |
|---|---|
--include | 附加数据,可重复或以逗号分隔:trackers、issue_categories、enabled_modules、time_entry_activities、issue_custom_fields |
-o, --output | 输出格式 |
详情视图会在响应包含相关字段时显示主页、默认指派人、默认版本、已启用模块以及项目自定义字段值。
create
Section titled “create”redmine projects create [flags]| 标志 | 描述 |
|---|---|
--name | 项目名称 — 必填 |
--identifier | URL 友好的标识符 — 必填 |
--description | 项目描述 |
--homepage | 项目主页 URL |
--public | 将项目设为公开 |
--parent | 父项目标识符、名称或数字 ID |
--inherit-members | 继承父项目的成员 |
--default-assignee | 新工单的默认指派人(登录名、姓名或数字 ID) |
--tracker | 启用的跟踪标签名称或 ID(可重复或以逗号分隔) |
--enable-module | 启用的模块:boards、calendar、documents、files、gantt、issue_tracking、news、repository、time_tracking、wiki |
--issue-custom-field | 启用的工单级自定义字段名称或 ID(可重复) |
--custom-field | 项目自定义字段值,格式为 name=value 或 id=value(可重复) |
redmine projects create \ --name "Platform" --identifier platform \ --homepage https://platform.example.test \ --tracker Bug,Feature \ --enable-module issue_tracking,wiki,time_trackingupdate
Section titled “update”redmine projects update <identifier> [flags]所有标志均为可选;未提供的字段保持不变。
| 标志 | 描述 |
|---|---|
--name | 新项目名称 |
--description | 新描述 |
--homepage | 新主页 URL |
--public | 设置为公开可见 |
--parent | 新父项目(标识符、名称或数字 ID)。空值表示从当前父项目中分离。 |
--inherit-members | 切换是否继承父项目成员 |
--default-assignee | 默认指派人(登录名、姓名或数字 ID)。空值会尝试清除(部分 Redmine 版本会忽略该清除操作)。 |
--default-version | 默认版本(名称或数字 ID)。空值会尝试清除(部分 Redmine 版本会忽略该清除操作)。 |
--tracker | 替换启用的跟踪标签集合 |
--enable-module | 替换启用的模块集合 |
--issue-custom-field | 替换工单级自定义字段集合 |
--custom-field | 项目自定义字段值,格式为 name=value 或 id=value(可重复) |
archive
Section titled “archive”redmine projects archive <identifier> [flags]| 标志 | 描述 |
|---|---|
-f, --force | 跳过确认提示 |
已归档的项目会从默认项目列表中隐藏,在恢复之前无法编辑。
unarchive
Section titled “unarchive”redmine projects unarchive <identifier>恢复先前归档的项目,使其再次出现在默认列表中。
delete
Section titled “delete”redmine projects delete <identifier> [flags]| 标志 | 描述 |
|---|---|
-f, --force | 跳过确认提示 |
members
Section titled “members”redmine projects members <identifier> [flags]列出项目的所有成员及其角色。