DragonOS teams structure

This repository contains the structure of the DragonOS teams.

Documentation

• TOML schema reference

Using the CLI tool

It's possible to interact with this repository through its CLI tool.

验证仓库的完整性

此仓库包含一些健全性检查，以避免过时或损坏的数据。

在修改了仓库数据后，请在PR之前，使用 check 命令在本地运行这些检查：

cargo run check

请注意，由于缺少 API 令牌，这些检查中的一些将会被跳过。

向仓库中添加人员

可以获取 GitHub 个人资料中存在的公共信息，并将其存储在人员的 TOML 文件中：

cargo run add-person <github-username>

您还可以添加附加信息，比如某人的 Discord 或 Zulip ID，通过在他们的 .toml 文件中添加额外的字段。

要确定某人的 Zulip ID，请在 Zulip 的右侧人员列表中找到他们，点击“三个点”菜单，并将“User ID”复制到 toml 文件中：

zulip-id = <user id>

Querying information out of the repository

There are a few CLI commands that allow you to get some information generated from the data in the repository.

You can get a list of all the people in a team:

cargo run dump-team all

You can get a list of all the email addresses subscribed to a list:

cargo run dump-list [email protected]

You can get a list of all the users with a permission:

cargo run dump-permission perf

You can also print a list of users with individual access to repositories

# Group the accesses by repository
cargo run dump-individual-access --group-mode repo

# Group the accesses by contributor
cargo run dump-individual-access --group-mode person

Building the static API

You can build locally the content of https://team-api.infra.dragonos.org.cn/v1/ by running the command:

cargo run static-api output-dir/

The content will be placed in output-dir/.

Encrypting email addresses

If an email address in a list needs to be confidential it's possible to encrypt it. Encrypted email addresses look like this:

encrypted+3eeedb8887004d9a8266e9df1b82a2d52dcce82c4fa1d277c5f14e261e8155acc8a66344edc972fa58b678dc2bcad2e8f7c201a1eede9c16639fe07df8bac5aa1097b2ad9699a700edb32ef192eaa74bf7af0a@rust-lang.invalid

The production key is accessible to select Infrastructure Team members, so if you need to add an encrypted email address you'll need to reach out to that team. The key is stored in the following parameter on AWS SSM Parameter Store:

/prod/sync-team/email-encryption-key

The cargo run encrypt-email and cargo run decrypt-email interactive CLI commands are available for infra team members to interact with encrypted emails. The dragonos_team_data (with the email-encryption feature enabled) also provides a module to programmatically encrypt and decrypt.

Thanks

This repo is forked from rust-lang/team, and we are grateful for the original authors!