Instale la aplicación de GitHub de Zinn® para que podamos realizar despliegues sin un token de larga duración

Qué ventajas le ofrece conectarla

Instalar la aplicación de GitHub de Zinn® permite que un sitio web se despliegue desde sus repositorios —y que un tablero de proyectos se mantenga sincronizado con GitHub— sin necesidad de entregarnos un token personal. Solo conservamos el número de instalación de la aplicación, el cual no sirve de nada por sí solo, y generamos un token con una validez de una hora cada vez que lo necesitamos. Es la opción más adecuada para una organización, ya que no pertenece a ninguna persona en particular y no deja de funcionar cuando alguien se marcha.

Antes de comenzar

Una cuenta de GitHub, o permisos de propietario en la organización donde desee instalar la aplicación. Las organizaciones que prohíben aplicaciones de terceros requieren que un propietario lo autorice; si esto no es posible, utilice en su lugar un token con permisos específicos (Conectar su cuenta de GitHub).

1. Cree la clave en GitHub

No hay ninguna clave que deba crear. Instale la aplicación de GitHub de Zinn® en su cuenta personal o en su organización, y seleccione todos los repositorios o únicamente aquellos que desee que despleguemos.

A continuación, busque el número de instalación:

• Cuenta personal — Settings → Applications → Installed GitHub Apps, y Configure junto a la aplicación de Zinn®.
• Organización — Your organizations → Settings → GitHub Apps, y Configure junto a la aplicación de Zinn®.

El número que figura al final de la barra de direcciones en esa página —por ejemplo github.com/settings/installations/12345678— es el número de instalación.

2. Conéctela aquí

La aplicación se selecciona en el lugar donde se utiliza, en lugar de en la pantalla de Integraciones:

• En la conexión del repositorio de un sitio, elija GitHub (instalación de app).
• En el enlace de GitHub de un tablero de proyectos, elija La aplicación de GitHub de Zinn®.

Pegue el Número de instalación y continúe. Verificamos la instalación antes de guardar cualquier dato; un número al que no podamos acceder nunca se almacena.

Qué sucede a continuación

• Los repositorios que haya concedido a la aplicación aparecerán para que el sitio se despliegue desde ellos, y un push lo desplegará.
• Cada acción que realizamos aparece en el registro de auditoría de la instalación en GitHub bajo el nombre de la aplicación, no el suyo.
• Para concedernos acceso a más repositorios, modifique el acceso a repositorios de la aplicación en la misma página de Configure — no es necesario volver a conectar nada.

Si no se conecta

Falta un repositorio. La instalación solo cubre los repositorios que haya seleccionado. Abra Configure y añádalo.

El número es rechazado. Compruebe que se trate del número de instalación de la barra de direcciones, no del ID propio de la aplicación, y que la aplicación siga instalada — una aplicación desinstalada no tiene ninguna instalación.

Indica que la clave fue rechazada. Casi siempre se debe a una de estas tres razones: se copió un espacio o un salto de línea junto con ella, la clave ha caducado, o la clave 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 que la acción requiere. Cree una nueva clave con los permisos indicados anteriormente, luego desconecte la conexión anterior y conecte la nueva clave.

Desconexión

Abra Integraciones, busque la cuenta y pulse Desconectar. Esto elimina la clave almacenada de inmediato. Todo lo 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 forma silenciosa.

Desconectar no deshace lo que ya se ha realizado — los registros, despliegues o ajustes que hayamos modificado en su cuenta permanecerán tal como están. Si considera que la propia clave ha podido filtrarse, revóquela también en el proveedor; desconectarla elimina nuestra copia, no la suya.