For the complete documentation index, see llms.txt. This page is also available as Markdown.

Información general de las integraciones con Git

Escrito para la antigua interfaz de usuario

Resumen

La integración con Git te permite conectar tu repositorio Git a DevOps, de modo que los metadatos de Salesforce administrados en las ramas de DevOps se sincronizan automáticamente. Esto garantiza que tus ramas y confirmaciones se registren en tu sistema de control de versiones basado en Git. Cuando se fusiona una solicitud de extracción de DevOps, se crea una confirmación para los cambios fusionados. La integración con Git envía esta confirmación a la rama de destino en Git, pero la solicitud de extracción no se sincroniza con Git.

Buenas prácticas

  • Nombra las ramas de DevOps usando solo letras, números y estos símbolos: _ / - .. Evita los espacios o caracteres especiales para garantizar una sincronización fluida con Git.

  • Supervisa la integración con Git Actividades para detectar excepciones y resolverlas rápidamente.

  • Usa filtros para auditar ramas, fechas o estados específicos.

Estructura del repositorio sincronizado

Después de que DevOps completa una sincronización con un trabajo de Enviar a Git, el repositorio Git conectado refleja los estados de las ramas de DevOps. Cada trabajo de sincronización crea una nueva confirmación para fines de trazabilidad. La siguiente tabla explica cómo la integración maneja cada uno de los siguientes elementos.

Ramas

Cada rama de DevOps se crea o actualiza como una rama con el mismo nombre en tu repositorio Git.

Confirmaciones

DevOps envía confirmaciones a la rama. Las confirmaciones siempre tienen Sincronización de DevOps. Una rama se sincroniza. como encabezado. El cuerpo de la confirmación incluye el Hash, el Mensaje y el CreatedAt de todas las confirmaciones de DevOps enviadas a Git durante esta sincronización.

Solicitudes de extracción

Cuando se fusiona una solicitud de extracción de DevOps, se crea una confirmación para los cambios fusionados. La integración con Git envía esta confirmación a la rama de destino en Git, pero la solicitud de extracción no se sincroniza con Git. La confirmación enviada incluye lo siguiente en los detalles de la confirmación: Mensaje: Fusionar rama.

El repositorio está formateado como un Proyecto Salesforce DX, con lo siguiente:

  • Carpetas estándar

    • force-app/

    • config/

    • scripts/

  • Archivos estándar

    • sfdx-project.json

    • package.json

    • README.md

La siguiente captura de pantalla muestra un ejemplo de una rama en un repositorio de GitHub que está sincronizada con DevOps.

Confirmaciones de sincronización de DevOps

Cada confirmación que DevOps envía a Git tiene el siguiente formato:

Encabezado de la confirmación

Cuerpo de la confirmación

El cuerpo de la confirmación puede incluir varias confirmaciones de DevOps, y se proporciona la siguiente información para cada confirmación de DevOps.

Hash

Código hash de la confirmación de DevOps representada por este mensaje.

Mensaje

Mensaje de la confirmación de DevOps.

CreatedAt

La marca de tiempo ISO 8601 en la que se creó la confirmación en DevOps.

A continuación se muestran capturas de pantalla de ejemplo de confirmaciones de DevOps sincronizadas en GitHub.

Creación y sincronización inicial de la rama

Cuando un repositorio Git se conecta a un inquilino de DevOps existente, se crea una rama y se envía una confirmación inicial a Git que incluye todos los mensajes de confirmación en DevOps para esa rama. A continuación se muestra un ejemplo de una confirmación inicial en GitHub.

Confirmación de DevOps

A continuación se muestra un ejemplo de una confirmación de DevOps en GitHub.

Fusión de solicitud de extracción de DevOps

Cuando se fusiona una solicitud de extracción de DevOps, se crea una confirmación para los cambios fusionados. La integración con Git envía esta confirmación a la rama de destino en Git, pero la solicitud de extracción no se sincroniza con Git. La confirmación enviada incluye lo siguiente en los detalles de la confirmación: Mensaje: Fusionar rama. A continuación se muestra un ejemplo de una confirmación de fusión en GitHub.

Commits agrupados

En algunas situaciones, la integración con Git agrupa varias confirmaciones en una sola confirmación que se sincroniza con Git. En Git, el mensaje de la confirmación incluye detalles de cada confirmación de DevOps agrupada. Por ejemplo, cuando se edita un componente en DevOps, la confirmación resultante no se envía a Git hasta que otra acción de la rama desencadena un envío. A continuación se muestra un ejemplo de una confirmación agrupada.

Hosts de Git compatibles

DevOps puede conectarse a los siguientes hosts para repositorios Git.

  • GitHub

  • GitLab

  • Azure

  • Bitbucket

A continuación se proporcionan instrucciones detalladas para conectarse a GitHub en el artículo siguiente, y pueden servir como guía para conectarse a los otros hosts, ya que el proceso es similar.

Última actualización

¿Te fue útil?