如何通过代码自动化创建GitHub团队并配置仓库权限？

前置准备 #

• 生成GitHub个人访问令牌（PAT），需勾选 admin:org、repo 权限
• 选择以下两种常用实现方式之一：Python脚本或GitHub CLI脚本

方法一：Python + PyGitHub库 #

1. 安装依赖 #

pip install pygithub

2. 自动化脚本示例 #

from github import Github

# 替换为你的实际配置
GITHUB_PAT = "your-personal-access-token"
ORG_NAME = "your-org-name"

# 初始化客户端
g = Github(GITHUB_PAT)
org = g.get_organization(ORG_NAME)

# 创建新团队
team_name = "new-dev-team"
new_team = org.create_team(
    name=team_name,
    description="Team for new project development",
    privacy="closed"  # 可选值：open/closed/secret
)

# 批量添加成员
members = ["user1", "user2", "user3"]
for member in members:
    try:
        new_team.add_to_members(g.get_user(member))
        print(f"已添加 {member} 到 {team_name}")
    except Exception as e:
        print(f"添加 {member} 失败：{str(e)}")

# 设置仓库权限
repo_name = "target-repo"
repo = org.get_repo(repo_name)
new_team.set_repo_permission(repo, "push")  # 可选权限：pull/push/admin/maintain/triage
print(f"已为 {team_name} 配置 {repo_name} 的push权限")

方法二：GitHub CLI（gh） #

1. 配置认证 #

gh auth login --with-token < your-pat-file.txt

2. Bash自动化脚本示例 #

#!/bin/bash

# 替换为你的实际配置
ORG_NAME="your-org-name"
TEAM_NAME="new-dev-team"
MEMBERS=("user1" "user2" "user3")
REPO_NAME="target-repo"
PERMISSION="push"

# 创建团队
gh api --method POST /orgs/$ORG_NAME/teams \
  -f name="$TEAM_NAME" \
  -f description="Team for new project development" \
  -f privacy="closed"

# 批量添加成员
for member in "${MEMBERS[@]}"
do
  gh api --method PUT /orgs/$ORG_NAME/teams/$TEAM_NAME/memberships/$member \
    -f role="member"  # 可选角色：member/maintainer
done

# 设置仓库权限
gh api --method PUT /orgs/$ORG_NAME/teams/$TEAM_NAME/repos/$ORG_NAME/$REPO_NAME \
  -f permission="$PERMISSION"

关键注意事项 #

• 确保PAT权限覆盖所有操作需求，避免因权限不足失败
• 批量操作时建议加入错误捕获逻辑，防止单个任务失败中断整个流程
• 私有组织环境下，需保证脚本运行网络能正常访问GitHub API
• 可根据需求扩展脚本，比如批量创建多团队、批量配置多仓库权限

内容的提问来源于stack exchange，提问作者denim