glab-repo

# glab repo 管理 GitLab 仓库和项目。 ## 快速入门 ```bash # Clone a repository glab repo clone group/project # Create new repository glab repo create my-new-project --public # Fork a repository glab repo fork upstream/project # View repository details glab repo view # Search for repositories glab repo search "keyword" ``` ## 常用工作流 ### 创建新项目 1. **创建仓库：** ```bash glab repo create my-project \ --public \ --description "My awesome project" ``` 2. **克隆到本地：** ```bash glab repo clone my-username/my-project cd my-project ``` 3. **初始化内容：** ```bash echo "# My Project" > README.md git add README.md git commit -m "Initial commit" git push -u origin main ``` ### Fork 工作流 1. **Fork 上游仓库：** ```bash glab repo fork upstream-group/project ``` 2. **克隆你的 Fork：** ```bash glab repo clone my-username/project cd project ``` 3. **添加上游远程仓库：** ```bash git remote add upstream https://gitlab.com/upstream-group/project.git ``` 4. **保持 Fork 同步：** ```bash git fetch upstream git merge upstream/main ``` **自动同步：** 使用同步脚本一键更新 Fork： ```bash scripts/sync-fork.sh main scripts/sync-fork.sh develop upstream ``` 该脚本自动完成：拉取 → 合并 → 推送到 origin。 ### 仓库管理 **查看仓库信息：** ```bash glab repo view glab repo view group/project # Specific repo glab repo view --web # Open in browser ``` **更新仓库设置：** ```bash glab repo update \ --description "Updated description" \ --default-branch develop ``` **归档仓库：** ```bash glab repo archive download main # Downloads .tar.gz glab repo archive download main --format zip ``` **转移到新命名空间：** ```bash glab repo transfer my-project --target-namespace new-group ``` **删除仓库：** ```bash glab repo delete group/project ``` ### 成员管理 **列出协作者：** ```bash glab repo members list ``` **添加成员：** ```bash glab repo members add @username --access-level maintainer ``` **移除成员：** ```bash glab repo members remove @username ``` **更新成员权限：** ```bash glab repo members update @username --access-level developer ``` ### 批量操作 **克隆群组中所有仓库：** ```bash glab repo clone -g my-group ``` **搜索并克隆：** ```bash glab repo search "api" --per-page 10 # Then clone specific result glab repo clone group/api-project ``` **列出你的仓库：** ```bash glab repo list glab repo list --member # Only where you're a member glab repo list --mine # Only repos you own ``` ## 故障排除 **克隆失败（权限错误）：** - 验证是否有访问权限：`glab repo view group/project` - 检查认证状态：`glab auth status` - 对于私有仓库，确保使用正确的账户登录 **Fork 操作失败：** - 检查你的命名空间中是否已存在相同的 Fork - 确认你有 Fork 权限（部分仓库禁用了 Fork 功能） - 尝试指定路径：`glab repo fork --fork-path username/new-name` **转移失败：** - 确认你有 Owner/Maintainer 权限 - 检查目标命名空间是否存在且你有创建权限 - 部分项目可能启用了转移保护 **群组克隆失败：** - 确认群组存在且你有访问权限 - 检查是否有足够的磁盘空间 - 大型群组可能会超时 —— 建议逐个克隆特定仓库 ## 相关技能 **认证与访问：** - 参见 `glab-auth` 了解登录和认证设置 - 参见 `glab-ssh-key` 了解 SSH 密钥管理 - 参见 `glab-deploy-key` 了解部署认证 **项目配置：** - 参见 `glab-config` 了解 CLI 默认设置 - 参见 `glab-variable` 了解 CI/CD 变量 **Fork 同步：** - 脚本：`scripts/sync-fork.sh` 自动化上游同步 ## 命令参考 完整的命令文档和所有参数请参见 [references/commands.md](references/commands.md)。 **可用命令：** - `clone` - 克隆仓库或群组 - `create` - 创建新项目 - `fork` - Fork 仓库 - `view` - 查看项目详情 - `update` - 更新项目设置 - `delete` - 删除项目 - `search` - 搜索项目 - `list` - 列出仓库 - `transfer` - 转移到新命名空间 - `archive` - 下载仓库归档 - `contributors` - 列出贡献者 - `members` - 管理项目成员 - `mirror` - 配置仓库镜像 - `publish` - 发布项目资源