Conecte su cuenta de GitHub con un token para que sus sitios se implementen desde un repositorio

Lo que la conexión hace por usted

Conectar GitHub mediante un token permite que un sitio se implemente desde uno de sus repositorios: envíe cambios a la rama y el sitio se actualizará. También nos permite publicar en GitHub Pages en su cuenta cuando elija eso como el alojamiento del sitio.

Si sus repositorios pertenecen a una organización, prefiera the Zinn® GitHub app en su lugar — consulte Install the Zinn® GitHub app. Un token pertenece a una sola persona y deja de funcionar cuando esta se marcha.

Antes de empezar

Una cuenta de GitHub con acceso a los repositorios que desea implementar. Si pertenecen a una organización, es posible que un propietario deba aprobar tokens detallados para ella.

1. Cree la clave en GitHub

En GitHub, haga clic en su foto de perfil y luego en Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Asígnele un nombre y elija una fecha de caducidad. En Repository access, elija Only select repositories y seleccione aquellos que va a implementar (el acceso más limitado posible que funcione).

En Repository permissions, otorgue permisos de Read and write en:

• Contents
• Pages
• Administration

Pulse Generate token y cópielo; GitHub solo lo muestra una vez.

2. Conéctelo aquí

Abra Integrations en su panel de control y elija Connect an account. Seleccione Code hosting como grupo y GitHub como cuenta, complete API token y pulse Connect account.

Comprobamos lo que pega antes de que se guarde nada. Una clave que no funciona nunca se almacena, y la respuesta indica cuál fue el problema. Una clave que funciona se guarda cifrada en nuestro almacén de secretos (nunca en nuestra base de datos) y no se vuelve a mostrar jamás, ni siquiera a usted.

Qué ocurre después

• Un sitio puede implementarse directamente desde un repositorio en esta cuenta: elíjalo en la conexión del repositorio del sitio, seleccione el repositorio y la rama, y un envío (push) realizará la implementación.
• Cualquier otra rama puede obtener su propia vista previa, lo que le permite comprobar un cambio antes de que llegue al sitio activo.
• Los hosts estáticos compilados con Git, como Render y Azure Static Web Apps, utilizan esta conexión como la fuente del código del sitio.

Si no se conecta

Un repositorio no aparece. El acceso a repositorios del token no lo incluye. Edite el token en GitHub y añada el repositorio.

Funcionó y luego se detuvo. Los tokens detallados caducan en la fecha que usted eligió. Genere uno nuevo y conéctelo; GitHub le envía un correo electrónico antes de que un token caduque.

Indica que la clave fue rechazada. Casi siempre se debe a una de estas tres cosas: se copió un espacio o un salto de línea junto con la clave, la clave ha caducado, o bien la clave fue revocada o regenerada después de que la copiara. Cree una nueva y vuelva a pegarla.

Se conecta, pero algo falla más adelante. La clave se autentica pero carece de un permiso que la acción necesita. Cree una nueva clave con los permisos enumerados anteriormente, desconecte la conexión antigua y conecte la nueva clave.

Desconexión

Abra Integrations, busque la cuenta y pulse Disconnect. Esto elimina la clave almacenada de inmediato. Todo lo que la estuviera utilizando se detiene en su siguiente acción, y las pantallas que dependían de ella lo notifican en lugar de fallar silenciosamente.

Desconectarse no deshace lo que ya se ha hecho; los registros, las implementaciones o la configuración que hayamos cambiado en su cuenta se mantienen tal cual. Si cree que la clave en sí pudo haberse filtrado, revóquela también en el proveedor; la desconexión elimina nuestra copia, no la de ellos.