Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Instalación de una instancia de GitHub App desde GitHub Marketplace en las organizaciones

Puedes instalar GitHub App desde GitHub Marketplace para usarla en tus organizaciones.

Acerca de GitHub Marketplace

Este artículo se aplica a la instalación y compra de instancias de GitHub App desde GitHub Marketplace. Para más información sobre la instalación de instancias de GitHub App desde un origen distinto de GitHub Marketplace, consulta "Instalación de una instancia de GitHub App desde un tercero".

Si instalas una instancia de GitHub App en tu cuenta de organización y eliges un plan de pago, la suscripción de la aplicación se paga en la fecha de facturación actual de la organización de acuerdo con el método de pago existente.

Si eliges un plan pagado con prueba gratuita, puedes cancelarlo en cualquier momento durante tu periodo de prueba sin que se te cobre, pero perderás acceso a la app automáticamente. Tu suscripción paga comenzará al finalizar la prueba de 14 días. Para obtener más información, vea «Acerca de la facturación para el Mercado GitHub».

Para más información sobre la instalación de una instancia de OAuth App desde GitHub Marketplace, consulta "Instalación de una aplicación de OAuth en la organización".

Acerca de la instalación de instancias de GitHub App

Para usar una instancia de GitHub App en tus repositorios u organización, debes instalar la aplicación.

Cuando instalas una aplicación, le concedes permiso para acceder a los recursos de la organización y del repositorio solicitados. Durante el proceso de instalación, GitHub te indicará qué permisos solicitó la instancia de GitHub App. Para más información sobre las solicitudes de la API REST que GitHub App puede crear con esos permisos, consulta "Permisos que requieren las Github Apps".

Al instalar una aplicación, también elegirás a qué repositorios se va a conceder acceso a la instancia de GitHub App.

Antes de instalar una instancia de GitHub App, debes asegurarte de que confías en el propietario de esta. También debes revisar los permisos que solicita la instancia de GitHub App y asegurarte de que te sientes a gusto con la idea de concederlos. Para más información sobre las solicitudes de la API REST que GitHub App puede crear con esos permisos, consulta "Permisos que requieren las Github Apps".

No hay ningún límite en el número de aplicaciones que se pueden instalar.

Diferencia entre autorización e instalación

Después de instalar una instancia de GitHub App, también se te pedirá que autorices la aplicación.

Al instalar la GitHub App en tu cuenta u organización, concedes a la aplicación permiso para acceder a los recursos de la organización y del repositorio que ha solicitado. También se especifica a qué repositorios puede acceder la aplicación. Durante el proceso de instalación, la GitHub App indicará qué repositorio y permisos de organización vas a conceder. Para obtener más información sobre qué permite cada permiso que haga una GitHub App, consulta "Choosing permissions for a GitHub App".

Por ejemplo, puedes conceder el permiso GitHub App para escribir problemas y leer metadatos del repositorio, y podrías conceder el acceso a la GitHub App a todos los repositorios.

Captura de pantalla de la página para instalar una aplicación de GitHub. La aplicación solicita acceso de lectura a los metadatos y acceso de escritura a problemas. La aplicación también puede solicitar autorización de usuario para el acceso de lectura a los correos electrónicos y el acceso de escritura a gists.

Al autorizar una GitHub App, concedes a la aplicación acceso a tu cuenta de GitHub, en función de los permisos de cuenta que solicitó la aplicación. Durante el proceso de autorización, la aplicación indicará a qué recursos puede acceder la aplicación en tu cuenta. Al autorizar una GitHub App, también se concede el permiso de la aplicación para actuar en tu nombre.

Por ejemplo, puedes conceder el permiso a la GitHub App para ver las direcciones de correo electrónico y escribir gists.

Captura de pantalla de la página para autorizar una aplicación de GitHub. La aplicación solicita acceso de lectura al correo electrónico y acceso de escritura a los gists.

Puedes instalar GitHub App sin autorizar la aplicación. Del mismo modo, puedes autorizar la aplicación sin instalar la aplicación.

Para más información sobre cómo autorizar las GitHub App, consulta "Autorizar GitHub Apps".

Requisitos para instalar una instancia de GitHub App en una organización

Los propietarios de la organización pueden instalar GitHub App en sus organizaciones.

Los administradores de repositorios que son propiedad de una organización también pueden instalar instancias de GitHub App en la organización si solo conceden a la aplicación acceso a repositorios de los que son administradores y si la aplicación no solicita ningún recurso de la organización. Los propietarios de la organización pueden impedir que colaboradores externos que sean administradores del repositorio instalen instancias de GitHub App.

El rol "administrador de aplicaciones" de una organización no otorga a una persona el derecho a instalar una instancia de GitHub App en la organización. Para obtener más información, vea «About GitHub App managers».

Instalar una GitHub App en tu organización

  1. En la barra de navegación, en la parte superior de cualquier página, haz clic en Marketplace.

    Captura de pantalla de la barra de navegación de GitHub. Un vínculo a GitHub Marketplace se resalta en color naranja oscuro. 1. Vaya a la aplicación que quiera instalar y, después, haga clic en el nombre de la aplicación. 1. En la página de la aplicación, debajo de "Configuración y precios", haz clic en el plan de precios que quieres utilizar. 1. Haga clic en Instalar de forma gratuita, Comprar con GitHub o Probar gratis durante 14 días. 1. Elige una organización de instalación para la aplicación. En función de los términos de servicio de la organización, este proceso será ligeramente diferente.

    • Si has concedido permiso a GitHub para recopilar información de nombre y dirección de la organización, en la sección "Información de facturación", selecciona el menú desplegable Cambiar de cuenta de facturación y, después, haz clic en la organización en la que quieras instalar la aplicación.

      Captura de pantalla de la pantalla de compra de aplicaciones de GitHub Marketplace. Un menú desplegable azul contraído con la etiqueta "Cambiar de cuenta de facturación" se resalta en naranja oscuro.

    • De lo contrario, en "Revisar el pedido", selecciona el menú desplegable Cuenta y, después, haz clic en la organización en la que quieras instalar la aplicación.

      Captura de pantalla de la pantalla de compra de aplicaciones de GitHub Marketplace. Un menú desplegable de color gris contraído con la etiqueta "Cuenta" se resalta en naranja oscuro. 1. Si eliges un plan pago, revisa tu método de pago.

    • A fin de cambiar el método de pago existente para la organización, haz clic en Editar... y, después, completa el formulario para agregar un método de pago nuevo.

    • Si no hay un método de pago en el archivo para la organización, haga clic en Agregar un método de pago y, después, complete el formulario para agregar una tarjeta de crédito o una cuenta de PayPal. 1. Haga clic en Complete order and begin installation.

  2. Si la aplicación necesita acceso a los repositorios, selecciona Todos los repositorios o Solo repositorios seleccionados.

    Si la aplicación crea algún repositorio, esta también tendrá automáticamente acceso a esos repositorios.

  3. Si eliges otorgar acceso a la app para ingresar a repositorios limitados en vez de a todos tus repositorios, teclea el nombre de cada repositorio al cual quieras otorgarle acceso, y posteriormente da clic en el nombre de cada repositorio para seleccionarlo. 1. Revisa los permisos de acceso de la app y haz clic en Instalar.

Información adicional