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

Qué le aporta conectarlo

Conectar GitHub mediante un token permite que un sitio se despliegue desde uno de sus repositorios: haga un push a la rama y el sitio se actualizará. También nos permite publicar en GitHub Pages en su cuenta cuando elija esa opción como alojamiento para un sitio.

Si sus repositorios pertenecen a una organización, prefiera en su lugar la aplicación de Zinn® para GitHub — consulte Instalar la aplicación de Zinn® para GitHub. Un token pertenece a una sola persona y deja de funcionar cuando esta se va.

Antes de comenzar

Una cuenta de GitHub con acceso a los repositorios que desea desplegar. Si pertenecen a una organización, es posible que un propietario deba aprobar los tokens con permisos detallados (fine-grained) 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 los que despliega — el acceso más restringido que funcione.

En Repository permissions, conceda Read and write en:

• Contents
• Pages
• Administration

Presione Generate token y cópielo — GitHub solo lo muestra una vez.

2. Conéctelo aquí

Abra Integraciones en su panel de control y elija Conectar una cuenta. Seleccione Alojamiento de código como grupo y GitHub como la cuenta, complete Token de API y presione Conectar cuenta.

Probamos lo que usted pega antes de guardar nada. Una clave que no funcione nunca se almacena, y la respuesta indica cuál fue el problema. Una clave que funcione se guarda cifrada en nuestra bóveda de secretos — nunca en nuestra base de datos — y jamás se vuelve a mostrar, ni siquiera a usted.

Qué sucede a continuación

• Un sitio puede desplegarse directamente desde un repositorio en esta cuenta: selecciónelo en la

conexión de repositorios del sitio, elija el repositorio y la rama, y un push iniciará el despliegue.

• Cada una de las demás ramas puede obtener su propia vista previa, de modo que pueda comprobar un cambio antes de que llegue al

sitio en producción.

• Los alojamientos estáticos generados por Git, como Render y Azure Static Web Apps, utilizan esta conexión como

la fuente del código del sitio.

Si no se conecta

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

Funcionaba y luego dejó de hacerlo. Los tokens con permisos detallados caducan en la fecha que haya elegido. Genere uno nuevo y conéctelo; GitHub le enviará un correo electrónico antes de que venza un token.

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 ella, una clave que ha caducado, o una clave que fue revocada o regenerada después de haberla copiado. Cree una nueva y péguela de nuevo.

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

Desconexión

Abra Integraciones, busque la cuenta y presione Desconectar. Eso elimina la clave almacenada de inmediato. Cualquier elemento que la estuviera utilizando se detendrá en su siguiente acción, y las pantallas que dependían de ella lo indicarán en lugar de fallar de manera silenciosa.

Desconectar no deshace lo que ya se realizó: los registros, despliegues o configuraciones que hayamos modificado en su cuenta permanecerán tal como están. Si cree que la clave en sí misma puede haberse filtrado, revoque también su validez en el proveedor; desconectar elimina nuestra copia, no la de ellos.