Skip to main content

Getting started with GitHub Team

With GitHub Team groups of people can collaborate across many projects at the same time in an organization account.

This guide will walk you through setting up, configuring and managing your GitHub Team account as an organization owner.

Part 1: Configuring your account on GitHub.com

As the first steps in starting with GitHub Team, you will need to create a personal account or log into your existing account on GitHub, create an organization, and set up billing.

1. About organizations

Organizations are shared accounts where businesses and open-source projects can collaborate across many projects at once. Owners and administrators can manage member access to the organization's data and projects with sophisticated security and administrative features. For more information on the features of organizations, see "About organizations."

2. Creating an organization and signing up for GitHub Team

Before creating an organization, you will need to create a personal account or log in to your existing account on GitHub.com. For more information, see "Signing up for a new GitHub account."

Once your personal account is set up, you can create an organization and pick a plan. This is where you can choose a GitHub Team subscription for your organization. For more information, see "Creating a new organization from scratch."

3. Managing billing for an organization

You must manage billing settings, payment method, and paid features and products for each of your personal accounts and organizations separately. You can switch between settings for your different accounts using the context switcher in your settings. For more information, see "Switching between settings for your different accounts."

Your organization's billing settings page allows you to manage settings like your payment method, billing cycle and billing email, or view information such as your subscription, billing date and payment history. You can also view and upgrade your storage and GitHub Actions minutes. For more information on managing your billing settings, see "Managing your GitHub billing settings."

Only organization members with the owner or billing manager role can access or change billing settings for your organization. A billing manager is someone who manages the billing settings for your organization and does not use a paid license in your organization's subscription. For more information on adding a billing manager to your organization, see "Adding a billing manager to your organization."

Part 2: Adding members and setting up teams

After creating your organization, you can invite members and set permissions and roles. You can also create different levels of teams and set customized levels of permissions for your organization's repositories, project boards, and apps.

1. Managing members of your organization

您可以邀请任何人成为您组织的成员,只要他们在 GitHub 上拥有个人帐户。 您还可以移除成员并恢复以前的成员。 更多信息请参阅“管理组织中的成员资格”。

2. Organization permissions and roles

组织中的每个人都有一个角色,用于定义他们对组织的访问级别。 成员角色是默认角色,您可以分配所有者和帐单管理员角色以及“团队维护者”权限。 更多信息请参阅“组织中的角色”。

3. About and creating teams

团队是组织成员的组,您可以创建这些组以反映具有级联访问权限和提及的公司或组的结构。 组织成员可以向团队发送通知或请求审阅,并且团队可以是可见的或机密的。 更多信息请参阅“关于团队”。

您可以创建独立团队或拥有多个级别的嵌套团队,以反映您的组或公司的层次结构。 更多信息请参阅“创建团队”。

4. Managing team settings

您可以指定“团队维护者”来管理团队设置和讨论,以及其他权限。 更多信息请参阅“将团队维护者角色分配给团队成员”。

您可以在团队的设置中管理团队的代码审阅分配、更改团队可见性、管理团队的计划提醒等。 更多信息请参阅“将员组织成团队”。

5. Giving people and teams access to repositories, project boards and apps

您可以向组织成员、团队和外部协作者授予对具有存储库角色的组织拥有的存储库不同级别的访问权限。 更多信息请参阅“组织的仓库角色”。

您还可以自定义对组织项目板的访问权限,并允许各个组织成员管理组织的 GitHub 应用程序。 更多信息请参阅“管理对组织项目板的访问”和“管理对组织应用程序的访问”。

Part 3: Managing security for your organization

You can help to make your organization more secure by recommending or requiring two-factor authentication for your organization members, configuring security features, and reviewing your organization's audit log and integrations.

1. Requiring two-factor authentication

您可以查看您的组织成员是否启用了双重身份验证,并选择在您的组织中要求双重身份验证。 更多信息请参阅“您的组织中需要双重身份验证”。

2. Configuring security features for your organization

为保持 您的组织 安全,您可以使用各种 GitHub 安全功能,包括安全策略、依赖关系图、秘密扫描以及 Dependabot 安全和版本更新。 更多信息请参阅“保护组织”和“管理组织的安全和分析设置”。

3. Reviewing your organization's audit log and integrations

组织的审核日志允许您作为组织所有者查看组织成员在本月和前六个月内执行的操作。 更多信息请参阅“查看组织的审核日志”。

您还可以查看和配置组织已安装集成的权限级别。 更多信息请参阅“>审查组织已安装的集成”。

Part 4: Setting organization level policies

1. Managing organization policies

您可以管理组织中许多不同操作和功能的权限和策略。

例如,为了保护组织的数据,您可以限制在组织中创建存储库。 您还可以选择允许或阻止复刻您的组织拥有的私有仓库。 更多信息请参阅“限制组织中中的存储库创建”和“管理组织的复刻策略”。

有关可为组织配置的设置的完整列表,请参阅“管理组织设置”。

2. Managing repository changes

您可以配置在组织中创建、传输和删除存储库的权限,包括成员可以创建的类型。 更多信息请参阅“限制组织中的存储库创建”和“设置删除或传输存储库的权限”。

您还可以限制或授予更改存储库可见性的功能。 更多信息请参阅“限制组织的仓库可见性更改”。

3. Using organization-level community health files and moderation tools

您可以为组织创建默认的社区运行状况文件,例如 CONTRIBUTING.md 文件、CODE_OF_CONDUCT.md 文件,甚至是议题和拉取请求模板。 这些默认文件将用于您的组织拥有、不包含其自己的此类文件的任何存储库。 更多信息请参阅“创建默认社区健康文件”。

GitHub 提供了多种工具来审核和管理您的社区。 更多信息请参阅“用于主持社区的工具”。

Part 5: Customizing and automating your work on GitHub

您可以使用 GitHub Marketplace、GitHub API 中的工具以及现有的 GitHub 功能来自定义和自动化您的工作。

1. Using GitHub Marketplace

GitHub Marketplace contains integrations that add functionality and improve your workflow. You can discover, browse, and install free and paid tools, including GitHub 应用程序s, OAuth 应用程序s, and GitHub Actions, in GitHub Marketplace. For more information, see "About GitHub Marketplace."

2. Using the GitHub API

There are two versions of the GitHub API: the REST API and the GraphQL API. You can use the GitHub APIs to automate common tasks, back up your data, or create integrations that extend GitHub. For more information, see "About GitHub's APIs."

3. Building GitHub Actions

With GitHub Actions, you can automate and customize GitHub.com's development workflow on GitHub. You can create your own actions, and use and customize actions shared by the GitHub community. For more information, see "Learn GitHub Actions."

4. Publishing and managing GitHub Packages

GitHub Packages 是一种软件包托管服务,允许您私下或公开托管软件包,并将包用作项目中的依赖项。 更多信息请参阅“GitHub Packages 简介”。

Part 6: Participating in GitHub's community

参与 GitHub 社区的方式有很多种。 您可以为开源项目做出贡献,与 GitHub Community Support 中的人员互动,或通过 GitHub Learning Lab 学习。

1. Contributing to open source projects

在 GitHub 上为开源项目做出贡献可能是一种有益的方式,可以学习,教授和积累您能想象到的任何技能的经验。 更多信息请参阅开源指南中的“如何为开源做贡献”。

您可以根据您过去的贡献、星标和其他活动在 Explore 中找到针对项目的个性化推荐,以及好的第一议题。 更多信息请参阅“在 GitHub 上查找为开源做贡献的方法”。

2. Interacting with the GitHub Community Support

您可以与世界各地的开发人员联系,以提出和回答问题,学习并直接与 GitHub 员工互动。 要开始对话,请参阅“GitHub Community Support”。

3. Reading about GitHub Team on GitHub Docs

You can read documentation that reflects the features available with GitHub Team. For more information, see "About versions of GitHub Docs."

4. Learning with GitHub Learning Lab

您可以通过 GitHub Learning Lab 在自己的 GitHub 存储库中完成有趣,逼真的项目来学习新技能。 每门课程都是由 GitHub 社区创建的实践课程,由友好的学习实验室机器人授课。

更多信息请参阅“Git 和 GitHub 学习资源”。

5. Supporting the open source community

GitHub 赞助者 允许您每月定期向设计、创建或维护您所依赖的开源项目的开发人员或组织付款。 更多信息请参阅“关于 GitHub 赞助者”。

6. Contacting GitHub 支持

GitHub 支持 可帮助您排除在使用 GitHub 时遇到的问题。 更多信息请参阅“关于 GitHub 支持”。

Further reading