Install the Zinn® GitHub app so we can deploy without a long-lived token

Qué le aporta esta conexión

Instalar la aplicación de Zinn® en GitHub permite que un sitio se despliegue desde sus repositorios y que un tablero de proyecto se mantenga sincronizado con GitHub, todo ello sin entregarnos un token personal. Únicamente 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 hora de duración cada vez que lo necesitamos. Es la mejor opción para una organización, ya que no pertenece a ninguna persona en concreto y no deja de funcionar cuando alguien se marcha.

Antes de comenzar

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

1. Crear la clave en GitHub

No hay ninguna clave que crear. Instale la aplicación de Zinn® para GitHub en su cuenta personal o en su organización, y elija todos los repositorios o únicamente aquellos desde los que desea que realicemos despliegues.

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

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

El número que aparece 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. Conectarlo 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 (app install).
• En el enlace de GitHub de un tablero de proyecto, elija The Zinn® GitHub app.

Pegue el Installation number y continúe. Comprobamos la instalación antes de guardar nada; un número al que no podamos acceder no se almacena jamás.

Qué ocurre a continuación

• Los repositorios a los que haya concedido acceso a la aplicación aparecerán disponibles para que el sitio se despliegue a partir de ellos, y cualquier push realizará un despliegue.
• Cada acción que llevamos a ejecución aparece en el registro de auditoría de la instalación en GitHub bajo el nombre de la aplicación, no el suyo.
• Para proporcionarnos más repositorios, modifique el acceso a los repositorios de la aplicación en la misma página Configure; no es necesario volver a conectar nada.

Si no se conecta

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

El número es rechazado. Compruebe que se trata del número de instalación de la barra de direcciones, y no del ID propio de la aplicación, y que esta sigue instalada (una aplicación desinstalada no tiene ninguna instalación).

Indica que la clave ha sido rechazada. Casi siempre se debe a una de estas tres causas: un espacio o salto de línea copiado junto con la clave, una clave caducada, o una clave que ha sido revocada o regenerada después de que la copiara. Cree una clave nueva y vuelva a pegarla.

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

Desconexión

Abra Integrations, busque la cuenta y pulse Disconnect. Esto elimina de inmediato la clave almacenada. 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 silenciosamente.

La desconexión no deshace lo que ya se había realizado; los registros, despliegues o ajustes que hayamos modificado en su cuenta permanecerán tal como están. Si sospecha que la clave en sí misma pudo haber quedado expuesta, revóquela también en el proveedor; la desconexión elimina nuestra copia, no la suya.