Sincronización GitHub

Antes de conectar

La sincronización GitHub conecta un proyecto a un repositorio de su propiedad. Requiere la capacidad correspondiente en el plan del propietario del proyecto. Las conexiones existentes aún se pueden ver y eliminar cuando esa capacidad no está disponible, pero las nuevas conexiones y la sincronización están bloqueadas. Esta restricción no impide que el agente edite su proyecto o guarde versiones de archivos locales.

Elija un repositorio GitHub sin una rama principal y copie su HTTPS URL completo. Se permiten otras ramas, archivos y confirmaciones. Amazi crea principal automáticamente con el historial de su proyecto; usted mismo crea o elige el repositorio.

Si main ya existe, conserve cualquier trabajo que necesite en otra rama antes de eliminarlo. GitHub requiere otra rama predeterminada antes de poder eliminar la rama principal predeterminada; la protección de sucursales también puede restringir la eliminación. En su lugar, puedes elegir otro repositorio. Para restaurar el acceso a un repositorio ya conectado, use Actualizar conexión y mantenga principal.

Conecta el proyecto

1. Abra el cuadro de diálogo de conexión GitHub del proyecto.
2. Ingrese el HTTPS URL del repositorio.
3. Complete el flujo de instalación y autorización GitHub para ese repositorio.
4. Regrese a Amazi y verifique el estado de la conexión.

Puede conectar un nuevo proyecto antes de crear archivos o confirmaciones. Amazi crea la revisión inicial del proyecto automáticamente al publicar en GitHub. Después de hacer clic en Continuar en GitHub, el botón muestra Abriendo GitHub… y permanece no disponible mientras se abre la autorización. Si la solicitud falla, puede volver a intentarlo.

Amazi crea la rama principal durante la conexión inicial y sincroniza esa rama. Otras ramas permanecen intactas. La rama predeterminada GitHub puede tener otro nombre; puede hacer que el nuevo principal sea el predeterminado en GitHub después de conectarse.

Una vez conectado, el cuadro de diálogo muestra el repositorio, un enlace Abrir GitHub, cualquier error de sincronización y controles de conexión. Revise las confirmaciones en GitHub o en la pestaña Historial del proyecto. Las secciones expandibles del cuadro de diálogo explican la sincronización y le permiten desconectar el repositorio.

Nunca pegue un token de acceso GitHub en el chat para resolver un problema de autorización. Utilice el flujo de conexión y verifique que la instalación tenga acceso al repositorio deseado.

Si la conexión falla, Amazi muestra el motivo y los pasos de recuperación. Una red principal existente impide una nueva conexión, incluso si su última confirmación coincide con el proyecto. La notificación de error permanece visible hasta que la descarta.

Si la sincronización informa un error, también aparece una advertencia amarilla debajo del campo de mensaje en el chat del proyecto, incluso mientras las acciones pendientes están abiertas. Haga clic en cualquier lugar de la advertencia para abrir la integración GitHub y revisar el error completo. El elemento GitHub en el menú del proyecto es amarillo mientras persiste un error, verde para una conexión sin errores y usa el color de texto normal cuando se desconecta. La advertencia de chat desaparece después de que desaparece el error o se elimina la conexión.

Actualizar una conexión existente

La acción Actualizar conexión tiene su propia fila justo encima de Desconectar GitHub en el cuadro de diálogo GitHub. Su explicación aparece en la misma fila.

Utilice Actualizar conexión en el cuadro de diálogo GitHub cuando el acceso deje de funcionar, incluso después de reinstalar la aplicación GitHub. Autorice GitHub nuevamente y otorgue a la aplicación acceso al repositorio conectado. Amazi verifica el mismo repositorio, incluso después de un cambio de nombre, y actualiza la conexión.

Luego, Amazi vuelve a intentar la sincronización: los cambios entrantes se aceptan mediante avance rápido y las confirmaciones locales se envían cuando los historiales permiten una inserción normal. Si los historiales divergen o la sincronización falla, la conexión restaurada se mantiene y el error de sincronización permanece visible. Revise el error en el cuadro de diálogo GitHub. Actualizar el acceso no requiere eliminar el historial del repositorio principal ni borrarlo.

¿Qué hace la sincronización?

Antes de una tarea de agente, Amazi verifica el principal remoto y acepta el historial entrante solo cuando puede avanzar sin fusionar cambios divergentes. Después de un punto de control comprometido, realiza un empujón normal. Las pulsaciones externas también pueden desencadenar la sincronización; una tarea activa puede interrumpirse antes de que cambie el árbol de trabajo local.

Amazi no fuerza automáticamente la inserción, no cambia la base de historiales en conflicto ni descarta archivos locales para que la sincronización sea exitosa.

Si las historias divergen

Un error de sincronización es independiente del resultado del trabajo del agente local. El trabajo local y los puntos de control pueden tener éxito mientras la conexión GitHub informa una sincronización fallida.

Cuando se confirma la divergencia, Amazi detiene la sincronización automática para esa versión remota para que los reintentos repetidos no interrumpan las nuevas tareas de chat. Después de resolver el historial, use Actualizar conexión para volver a intentarlo. Una nueva versión remota también inicia un nuevo intento de sincronización.

Lea el error informado y compare los historiales local y remoto antes de elegir una recuperación. Solicite primero un diagnóstico si no está seguro de qué cambios conservar. Resuelva la divergencia deliberadamente o conecte otro repositorio sin principal; no active repetidamente comandos destructivos de Git para ocultar el error.

Desconexión y copias de seguridad

La desconexión elimina la conexión Amazi, no el repositorio en GitHub. Eliminar el proyecto Amazi tampoco autoriza eliminar ese repositorio.

GitHub almacena archivos de proyecto versionados, no una copia de seguridad de las filas de la base de datos, el almacenamiento de objetos o el estado del servicio externo. Consulte Historial y restauración y Base de datos y almacenamiento antes de tratar la sincronización de origen como recuperación ante desastres.