About GitHub Marketplace
This article applies to installing and purchasing GitHub Apps from GitHub Marketplace. For more information on installing GitHub Apps from a source other than GitHub Marketplace, see "Installing a GitHub App from a third party."
If you install a GitHub App on your organization account and you choose a paid plan, you will pay for your app subscription on your organization's current billing date using your organization's existing payment method.
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».
For more information about installing an OAuth App from GitHub Marketplace, see "Instalación de una aplicación de OAuth en la organización."
About installing GitHub Apps
In order to use a GitHub App on your repositories or organization, you must install the app.
When you install an app, you grant the app permission to access the organization and repository resources that it requested. During the installation process, GitHub will tell you which permissions the GitHub App requested. For more information about the REST API requests the GitHub App can make with those permissions, see "Permisos que requieren las Github Apps."
When you install an app, you will also choose which repositories to grant the GitHub App access to.
Before installing a GitHub App, you should ensure you trust the owner of the GitHub App. You should also review the permissions that the GitHub App is requesting and make sure you are comfortable granting those permissions. For more information about the REST API requests the GitHub App can make with those permissions, see "Permisos que requieren las Github Apps."
There is no limit to how many apps you can install.
Difference between installation and authorization
After you install a GitHub App, you may also be asked to authorize the app.
Al instalar 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.
Cuando autorizas 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. También autorizas a la aplicación a actuar en tu nombre.
Puedes instalar GitHub App sin autorizar la aplicación. Del mismo modo, puedes autorizar la aplicación sin instalar la aplicación.
For more information about authorizing GitHub Apps, see "Autorizar GitHub Apps."
Requirements to install a GitHub App on an organization
Organization owners can install GitHub Apps on their organization.
Admins of repositories that are owned by an organization can also install GitHub Apps on the organization if they only grant the app access to repositories that they are an admin of and if the app does not request any organization resources. Organization owners can prevent outside collaborators who are repository admins from installing GitHub Apps.
The "app manager" role in an organization does not give a person the ability to install a GitHub App in the organization. For more information, see "About GitHub App managers."
Installing a GitHub App in your organization
-
En la barra de navegación, en la parte superior de cualquier página, haz clic en Marketplace.
-
Vaya a la aplicación que quiera instalar y, después, haga clic en el nombre de la aplicación.
-
En la página de la aplicación, debajo de "Configuración y precios", haz clic en el plan de precios que quieres utilizar.
-
Haga clic en Instalar de forma gratuita, Comprar con GitHub o Probar gratis durante 14 días.
-
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.
- 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.
-
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.
-
Haga clic en Complete order and begin installation.
-
If the app requires access to repositories, select All repositories or Only select repositories.
If the app creates any repositories, the app will automatically be granted access to those repositories as well.
-
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.
-
Revisa los permisos de acceso de la app y haz clic en Instalar.
