tp admin

tp admin users
tp admin set-quota alice --gpus 16 --jobs 6

控制台里对应的是用户和设置。

用户与角色

tp admin users                                  # 每个账号
tp admin user-add bob --role operator           # 一个本地账号；密码会提示输入
tp admin user-add bob --role operator --email bob@example.com
tp admin set-role bob admin
tp admin disable bob --on                       # 停用这个账号
tp admin disable bob --off                      # 重新启用

三种角色：admin、operator 和 auditor。auditor 能到审计轨迹，别的什么都到不了 —— 作用域和 operator 一样、被拒绝的方式和 operator 一样、不获得任何高级功能，也从不豁免配额。见角色与配额。

配额

tp admin set-quota alice \
  --gpus 16 \
  --jobs 6 \
  --daily-gpu-hours 200 \
  --max-storage-gb 2000 \
  --profiles h200,h100 \
  --priority 10

你从没设过时的默认值：并发 8 张卡、并发 4 个作业、每日 GPU 小时不限、存储不限、所有 profile 都允许、优先级 0。那两个数值上限里 0 表示不限，--profiles 为空表示全部。

存储配额和 GPU 配额工作方式不同。GPU 是预留的：提交一个作业就把它的卡先划出去。存储只能 事后测量 —— 训练进程往盘上写东西不会告诉平台，而一个作业也说不出它会写多少。所以规则是”已经超了就不出队新作业”，在跑的作业不受影响。用量来自一次周期性扫描（TUNEPLANE_STORAGE_SCAN_INTERVAL_S，默认 600 秒），所以它略有滞后，有人可能短时间超过上限。扫描卡住时，这道闸门放行而不是拒绝：显示一个过期的数字，好过让所有人都提交不了。

维护

tp admin maintenance status     # 当前状态，以及能否安全重启
tp admin maintenance drain      # 进入维护并排空。幂等；没排干就再跑一次
# ... 升级集群或平台 ...
tp admin maintenance resume     # 退出维护；被暂停的作业自己恢复

排空会停止新作业出队，并暂停在跑的作业、保留它们的 checkpoint。恢复会把一切自动拉回来，不需要对每个作业做操作。见维护模式。

`tp admin`

Manage users and quotas

tp admin <subcommand>

命令	说明
`tp admin disable`	Disable or enable a user
`tp admin maintenance`	Drain, upgrade and resume the cluster
`tp admin set-quota`	Set a user’s compute and storage quota
`tp admin set-role`	Change a user’s role
`tp admin user-add`	Create a local account
`tp admin users`	List every user

`tp admin disable`

Disable or enable a user

tp admin disable <USERNAME> [options]

参数	说明
`USERNAME`	必填

选项	说明
`--on`	—on disables, —off enables

`tp admin maintenance`

Drain, upgrade and resume the cluster

tp admin maintenance <subcommand>

命令	说明
`tp admin maintenance drain`	Enter maintenance mode and drain
`tp admin maintenance resume`	Leave maintenance mode
`tp admin maintenance status`	Show maintenance state and safety

`tp admin maintenance drain`

Enter maintenance mode and drain

tp admin maintenance drain [options]

选项	说明
`--note`	Maintenance note, echoed back to anyone whose submission is blocked

`tp admin maintenance resume`

Leave maintenance mode

tp admin maintenance resume

除 --help 外没有其他选项。

`tp admin maintenance status`

Show maintenance state and safety

tp admin maintenance status

除 --help 外没有其他选项。

`tp admin set-quota`

Set a user’s compute and storage quota

tp admin set-quota <USERNAME> [options]

参数	说明
`USERNAME`	必填

选项	说明
`--gpus` `<int>`	Concurrent GPU cap (默认 `8`)
`--jobs` `<int>`	Concurrent job cap (默认 `4`)
`--daily-gpu-hours` `<int>`	GPU-hours per day (0 = unlimited) (默认 `0`)
`--max-storage-gb` `<int>`	Cap on the user’s run directories in GiB (0 = unlimited). Enforced against a periodic scan: going over blocks new jobs, running ones continue (默认 `0`)
`--profiles`	Allowed profiles (comma separated, empty = all)
`--priority` `<int>`	Queue priority (默认 `0`)

`tp admin set-role`

Change a user’s role

tp admin set-role <USERNAME> <ROLE>

参数	说明
`USERNAME`	必填
`ROLE`	admin \| auditor \| operator (必填)

除 --help 外没有其他选项。

`tp admin user-add`

Create a local account

tp admin user-add <USERNAME> [options]

参数	说明
`USERNAME`	必填

选项	说明
`--password`, `-p`	必填
`--role`	admin \| auditor \| operator (默认 `operator`)
`--email`	—

`tp admin users`

List every user

tp admin users

除 --help 外没有其他选项。

CLI 参考

配置

实验

训练

产物与评测

资源

管理

用户与角色

配额

维护

`tp admin`

`tp admin disable`

`tp admin maintenance`

`tp admin maintenance drain`

`tp admin maintenance resume`

`tp admin maintenance status`

`tp admin set-quota`

`tp admin set-role`

`tp admin user-add`

`tp admin users`

​用户与角色

​配额

​维护

​tp admin

​tp admin disable

​tp admin maintenance

​tp admin maintenance drain

​tp admin maintenance resume

​tp admin maintenance status

​tp admin set-quota

​tp admin set-role

​tp admin user-add

​tp admin users

用户与角色

配额

维护

`tp admin`

`tp admin disable`

`tp admin maintenance`

`tp admin maintenance drain`

`tp admin maintenance resume`

`tp admin maintenance status`

`tp admin set-quota`

`tp admin set-role`

`tp admin user-add`

`tp admin users`