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 GitHub account

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

1. 关于组织

组织是共享帐户,其中业务和开源项目可一次协助处理多个项目。 所有者和管理员可通过复杂的安全和管理功能管理成员对组织数据和项目的访问。 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 user account or log in to your existing GitHub account. 更多信息请参阅“注册新 GitHub 帐户”。

Once your user 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. 更多信息请参阅“从头开始创建新组织”。

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. 更多信息请参阅“在不同帐户的设置之间切换”。

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

You can invite anyone to be a member of your organization, as long as they have a personal account on GitHub. You can also remove members and reinstate former members. For more information, see "Managing membership in your organization."

2. Organization permissions and roles

Each person in your organization has a role that defines their level of access to the organization. The member role is the default, and you can assign owner and billing manager roles as well as "team maintainer" permissions. 更多信息请参阅“组织的权限级别”。

3. About and creating teams

Teams are groups of organization members that you can create to reflect your company or group's structure with cascading access permissions and mentions. Organization members can send notifications to a team or request reviews, and teams can be visible or secret. 更多信息请参阅“关于团队”。

You can create independent teams or have multiple levels of nested teams to reflect your group or company's hierarchy. For more information, see "Creating a team."

4. Managing team settings

You can designate a "team maintainer" to manage team settings and discussions, among other privileges. For more information, see "Giving "team maintainer" permissions to an organization member."

You can manage code review assignments for your team, change team visibility, manage scheduled reminders for your team, and more in your team's settings. For more information, see "Organizing members into teams."

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

You can give organization members, teams, and outside collaborators different levels of access to repositories owned by your organization with granular permission levels. 更多信息请参阅“组织的仓库权限级别”。

You can also customize access to your organization's project boards and allow individual organization members to manage your organization's GitHub 应用程序. For more information, see "Managing access to your organization's project boards" and "Managing access to your organization's apps."

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

You can view whether your organization members have two-factor authentication enabled and choose to require two-factor authentication in your organization. 更多信息请参阅“您的组织中需要双重身份验证”。

2. Configuring security features for your organization

To keep your organization secure, you can use a variety of GitHub security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates. For more information, see "Securing your organization" and "Managing security and analysis settings for your organization."

3. Reviewing your organization's audit log and integrations

The audit log for your organization allows you, as an organization owner, to review the actions performed by members of the organization within the last 90 days. For more information, see "Reviewing the audit log for your organization."

You can also review and configure the permission levels for your organization's installed integrations. For more information, see "Reviewing your organization's installed integrations."

Part 4: Setting organization level policies

1. Managing organization policies

You can manage permissions and policies for a number of different actions and features in your organization.

For example, to protect your organization's data and number of paid licenses, you can choose to allow only organization owners to invite outside collaborators to organization repositories. You can also choose to allow or prevent the forking of private repositories owned by your organization. For more information, see "Setting permissions for adding outside collaborators" and "Managing the forking policy for your organization."

For the full list of settings you can configure for your organization, see "Managing organization settings."

2. Managing repository changes

You can configure permissions for creating, transferring and deleting repositories in your organization, including which types members can create. For more information, see "Restricting repository creation in your organization" and "Setting permissions for deleting or transferring repositories."

You can also restrict or grant the ability to change repository visibility. 更多信息请参阅“限制组织的仓库可见性更改”。

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

You can create default community health files, such as a file, a file, or even issue and pull request templates, for your organization. These default files will be used for any repository owned by your organization that does not contain its own file of that type. 更多信息请参阅“创建默认社区健康文件”。

GitHub offers multiple tools for moderating and managing your community. For more information, see "Tools for moderating your community."

Part 5: Customizing and automating your work on GitHub

You can use tools from the GitHub Marketplace, the GitHub API, and existing GitHub features to customize and automate your work.

1. Using GitHub Marketplace

GitHub Marketplace contains integrations that add functionality and improve your workflow. 在 GitHub Marketplace 中,您可以发现、浏览和安装免费及付费工具,包括 GitHub 应用程序、OAuth 应用程序 和 GitHub Actions。 更多信息请参阅“关于 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's development workflow on GitHub. 您可以创建自己的操作,以及使用和自定义 GitHub 社区分享的操作。 更多信息请参阅“Learn GitHub Actions”。

4. Publishing and managing GitHub Packages

GitHub Packages 是一种软件包托管服务,允许您私下或公开托管软件包,并将包用作项目中的依赖项。 For more information, see “Introduction to GitHub Packages."

Part 6: Participating in GitHub's community

There are many ways to participate in the GitHub community. You can contribute to open source projects, interact with people in the GitHub Community Support, or learn with GitHub Learning Lab.

1. Contributing to open source projects

Contributing to open source projects on GitHub can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine. For more information, see “How to Contribute to Open Source" in the Open Source Guides.

You can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in Explore. For more information, see “Finding ways to contribute to open source on GitHub."

2. Interacting with the GitHub Community Support

You can connect with developers around the world in GitHub Community Support to ask and answer questions, learn, and interact directly with GitHub staff.

3. Learning with GitHub Learning Lab

You can learn new skills by completing fun, realistic projects in your very own GitHub repository with GitHub Learning Lab. Each course is a hands-on lesson created by the GitHub community and taught by the friendly Learning Lab bot.

For more information, see “Git and GitHub learning resources."

4. Supporting the open source community

GitHub 赞助者 allows you to make a monthly recurring payment to a developer or organization who designs, creates, or maintains open source projects you depend on. For more information, see “About GitHub 赞助者."

5. 联系 GitHub 支持

GitHub 支持 可帮助您排除在使用 GitHub 时遇到的问题。 For more information, see “About GitHub 支持."





所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。


或, 了解如何参与。