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

Puedes invitar a cualquiera para que sea un miembro de tu organización, siempre y cuando tengan una cuenta personal en GitHub. También puedes eliminar a los miembros y reinstaurar a los miembros anteriores. Para más información, vea "Administración de la pertenencia en la organización".

2. Organization permissions and roles

Cada persona en tu organización tiene un rol que define su nivel de acceso a esta. El rol de miembro es el predeterminado y puedes asignar roles de propietario y gerente de facturación así como permisos de "mantenedor de equipo". Para más información, vea "Roles en una organización".

3. About and creating teams

Los equipos son grupos de miembros de una organización que puedes crear para reflejar la estructura de tu empresa o grupo con menciones y permisos de acceso en cascada. Los miembros de una organización pueden enviar notificaciones a un equipo o solicitar revisiones y los equipos pueden ser visibles o secretos. Para más información, vea "Acerca de los equipos".

Puedes crear equipos independientes o tener niveles múltiples de equipos anidados para reflejar la jerarquía de tu grupo o compañía. Para más información, vea "Creación de un equipo".

4. Managing team settings

Puedes designar un "mantenedor de equipo" para administrar los ajustes y debates del equipo, entre otros privilegios. Para más información, vea "Asignación del rol de mantenedor de equipo a un miembro del equipo".

Puedes administrar las tareas de revisión de código para tu equipo, cambiar la visibilidad de los equipos, administrar los recordatorios programados para tus equipos y más en los ajustes de equipo. Para más información, vea "Organización de miembros en equipos".

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

Con los roles de repositorio, puedes otorgar diferentes niveles de acceso a los miembros de la organización, equipos y colaboradores externos para los repositorios que pertenezcan a tu organización. Para más información, vea "Roles de repositorio para una organización".

También puedes personalizar el acceso a los tableros de proyecto de tu organización y permitir que miembros individuales de esta administren las GitHub Apps de ella. Para más información, vea "Administración del acceso a los paneles de proyecto de la organización" y "Administración del acceso a las aplicaciones de la organización".

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

Puedes ver si los miembros de tu organización tienen habilitada la autenticación bifactorial y elegir requerir la autenticación bifactorial en tu organización. Para más información, vea "Exigencia de la autenticación en dos fases en la organización".

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

La bitácora de auditoría de tu organización te permite, como propietario de la organización, revisar las acciones que llevan a cabo los miembros de la organización dentro del mes actual y los últimos seis meses. Para más información, vea "Revisión del registro de auditoría de la organización".

También puedes revisar y configurar los niveles de permiso de las integraciones instaladas en tu organización. Para más información, vea "Revisión de las integraciones instaladas de la organización".

Part 4: Setting organization level policies

1. Managing organization policies

Puedes administrar permisos y políticas para varias acciones y características diferentes de tu organización.

Por ejemplo, para proteger los datos de tu organización, puedes restringir la creación de repositorios en la misma. También puedes elegir permitir o prevenir la bifurcación de los repositorios privados que pertenecen a tu organización. Para más información, vea "Restricción de la creación de repositorios en la organización" y "Administración de la directiva de bifurcación para la organización".

Para obtener la lista completa de opciones que puede configurar para la organización, vea "Administración de la configuración de la organización".

2. Managing repository changes

Puedes configurar los permisos para crear, transferir y borrar los repositorios de tu organización, incluyendo qué tipos pueden crear los miembros. Para más información, vea "Restricción de la creación de repositorios en la organización" y "Establecimiento de permisos para eliminar o transferir repositorios".

También puedes restringir u otorgar la capacidad de cambiar la visibilidad de los repositorios. Para más información, vea "Restricción de los cambios de visibilidad del repositorio en la organización".

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

Puedes crear archivos de salud comunitaria, tales como el archivo CONTRIBUTING.md, un archivo CODE_OF_CONDUCT.md o incluso plantillas de propuestas y de solicitudes de cambios para tu organziación. Estos archivos predeterminados pueden utilizarse para cualquier repositorio que le pertenezca a tu organización y no contenga su propio archivo de este tipo. Para más información, vea "Creación de un archivo de estado de la comunidad predeterminado".

GitHub ofrece varias herramientas para moderar y mantener tu comunidad. Para más información, ea "Herramientas de moderación para la comunidad".

Part 5: Customizing and automating your work on GitHub

Puedes utilizar las herramientas del GitHub Marketplace, la API de GitHub y características existentes de GitHub para personalizar y automatizar tu trabajo.

1. Using GitHub Marketplace

GitHub Marketplace contiene integraciones que agregan funcionalidad y mejoran tu flujo de trabajo. En GitHub Marketplace, puede descubrir, buscar e instalar herramientas gratuitas y de pago, incluidas GitHub App, OAuth App y GitHub Actions. Para más información, vea "Acerca de GitHub Marketplace".

2. Using the GitHub API

Hay dos versiones de la API de GitHub: la API de REST y la API de GraphQL. Puede usar las API de GitHub para automatizar tareas comunes, realizar copias de seguridad de los datos o crear integraciones que amplíen GitHub. Para más información, vea "Acerca de las API de GitHub".

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 es un servicio de alojamiento de paquete de software que te permite alojar tus paquetes de software de forma privada o pública y usar paquetes como dependencias en tus proyectos. Para más información, vea "Introducción a GitHub Packages".

Part 6: Participating in GitHub's community

Hay muchas formas de participar en la comunidad de GitHub. Puedes contribuir con los proyectos de código abierto, interactuar con las personas en GitHub Community Support o aprender con GitHub Skills.

1. Contributing to open source projects

El contribuir con proyectos de código abierto en GitHub puede ser una forma gratificante de aprender, enseñar y crear una experiencia sobre cualquier habilidad que te puedas imaginar. Para más información, vea "Procedimiento para contribuir al código abierto" en las Guías de código abierto.

Puede encontrar recomendaciones personalizadas para proyectos e incidencias correctas en función de sus contribuciones anteriores, estrellas y otras actividades en Explorar. Para más información, vea "Búsqueda de formas de contribuir al código abierto en GitHub".

2. Interacting with the GitHub Community Support

Puedes contactar con desarrolladores de todo el mundo para hacer preguntas o responder a ellas, aprender e interactuar directamente con el personal de GitHub. Para comenzar la conversación, consulta "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 Skills

Puede aprender aptitudes nuevas si completa proyectos divertidos y realistas en un repositorio de GitHub propio con GitHub Skills. Cada curso es una lección práctica que ha creado la comunidad de GitHub y lo imparte un simpático bot.

Para más información, vea "Recursos de aprendizaje para Git y GitHub".

5. Supporting the open source community

GitHub Sponsors te permite hacer un pago mensual recurrente a un desarrollador u organización que diseñe, cree o mantenga proyectos de código abierto de los cuales dependas. Para más información, vea "Acerca de GitHub Sponsors".

6. Contacting Soporte de GitHub

Soporte de GitHub puede ayudarte a solucionar los problemas con los que te encuentres cuando utilices GitHub. Para más información, vea "Acerca de Soporte de GitHub".

Further reading