Integración de Git (vista previa)

34 Integración de Git (vista previa)

Puede conectar su instancia de Oracle AI Data Platform para ingerir, leer y escribir datos en repositorios Git externos y desde ellos.

La integración de Git en AI Data Platform funciona proporcionando credenciales de inicio de sesión para cuentas de Git y creando carpetas que se conectan a repositorios de Git con esas credenciales para ingerir datos. Puede almacenar varios juegos de credenciales para conectarse a diferentes repositorios de Git o gestionar diferentes niveles de acceso a los mismos repositorios. Los administradores pueden seleccionar un juego de credenciales como perfil por defecto para los usuarios y suprimir credenciales cuando ya no sean necesarias.

Puede gestionar sus archivos Git por completo desde AI Data Platform, con utilidades que le permiten transferir, extraer, confirmar y fusionar archivos, así como gestionar cualquier conflicto de fusión que surja sin tener que salir de la plataforma.

AI Data Platform también le permite bifurcar código desde su repositorio de Git, así como cambiar, fusionar, comparar y suprimir bifurcaciones.

Note:

AI Data Platform soporta actualmente repositorios de Git alojados en proveedores públicos de Git, como GitHub, GitLab, Bitbucket y Oracle Cloud Infrastructure DevOps. El soporte para Git alojado en redes privadas de clientes estará disponible en una actualización futura.

Carpetas de Git en Oracle AI Data Platform (vista previa)

Las carpetas Git de Oracle AI Data Platform le permiten interactuar con los datos alojados en un repositorio de Git sin salir de la plataforma.

Las carpetas de Git se crean en su catálogo maestro con las credenciales que haya configurado en la configuración de AI Data Platform. Conecta la carpeta a un repositorio de Git y utiliza la interfaz de usuario de AI Data Platform para transferir, extraer, fusionar, reorganizar y restablecer archivos en el repositorio.

Puede gestionar permisos de RBAC para su carpeta Git para controlar quién puede ver la carpeta y qué operaciones de Git pueden realizar. Para obtener más información, consulte Permisos de carpeta de Git (vista previa).

Reglas de patrón de cono (vista previa)

Las desprotecciones dispersas del contenido de Git en Oracle AI Data Platform admiten el modo Cone.

El comando sparse-checkout de Git se utiliza para crear desprotecciones dispersas, que cambian el árbol de trabajo para realizar un seguimiento de un subjuego de todos los archivos con seguimiento. En AI Data Platform, debe utilizar el modo Cone al proporcionar directorios con el comando sparse-checkout. Los patrones deben representar rutas de carpetas relativas a la raíz del repositorio.

Valores permitidos por el patrón de cono sparse-checkout

El modo de código permite los siguientes valores en patrones al utilizar sparse-checkout:

Valor vacío. Esto significa sólo archivos de repositorio de nivel raíz.
Valor en blanco/solo espacios en blanco. Se trata como vacío/sólo raíz.
Rutas de acceso de carpeta relativas a la raíz del repositorio:
- project-a
- project-a/src
- notebooks/jobs/
Los nombres de carpeta que no contienen caracteres restringidos (consulte a continuación)

Valores no permitidos por el patrón de cono sparse-checkout

Los siguientes valores no se aceptan en patrones al utilizar el modo Cone para sparse-checkout:

Valor no permitido	Ejemplo
Patrones de exclusión	`!src`
Sintaxis de glob sin cono	`*.py`, `src/[abc]`, `src?`
Ruta de acceso absoluta/raíz	`/src`, `/`
Barras inversas	`src\main`
Marcador raíz de repositorio	`.`, `./`
`./` inicial	`./src`
Segmentos de ruta vacíos	`src//main`
Recorrido principal	`../src`, `src/../main`
Guion principal	`-src`
Caracteres de control	por ejemplo, nuevas líneas, retornos de carro, caracteres nulos

Límites de modo de cono

Los siguientes límites se aplican al utilizar el modo Cone para sparse-checkout:

Componente	Límite
Número de patrones	100 patrones
Longitud de los patrones	1000 caracteres
Patrones vacíos	Permitido

Rutas de carpeta de Git

Las rutas de la carpeta Git se validan como una ruta relativa. Cada segmento de ruta solo puede contener:

Cartas: a-z, A-Z
Números: 0-9
Guión bajo: _
Guión: -
Punto: .
Espacio
Al signo: @

Las rutas válidas son las siguientes:

repo
repo.name_test-1@dev
folder name
jobs/git_provider/TASK1

No se permiten las siguientes rutas de Git utilizadas con sparse-checkout:

Rutas absolutas
Recorrido principal
Caracteres Especiales: !, #, $, %, *, ?, [, ], \, :

Crear una carpeta de Git (vista previa)

Puede crear una carpeta en el espacio de trabajo de Oracle AI Data Platform conectado a un repositorio de Git externo.

En la página inicial, vaya al espacio de trabajo.
Haga clic en Crear y, a continuación, en Carpeta Git. También puede hacer clic en Agregar en la parte superior derecha y en Carpeta Git.
En la lista desplegable Seleccionar credenciales de Git, seleccione las credenciales de Git necesarias para acceder al repositorio de Git.
Proporcione la URL del repositorio de Git. Por ejemplo: example.git.path.
Proporcione un nombre para la carpeta Git en el espacio de trabajo.
Proporcione la rama del repositorio de Git para conectarse a su carpeta.
Proporcione patrones de cono de confirmación de orden dispersos para las carpetas que desea clonar. Deje este campo en blanco para clonar todo el repositorio.
Haga clic en Create.

Creación de una carpeta de Git para un repositorio DevOps de OCI (vista previa)

Puede crear una carpeta de Git en Oracle AI Data Platform para un repositorio DevOps creado en Oracle Cloud Infrastructure.

Ya debe haber creado el repositorio DevOps en OCI. Para obtener más información, consulte Crear un repositorio.

Debe haber creado las credenciales para acceder a su proyecto DevOps en AI Data Platform. Para obtener más información, consulte Creación de credenciales (vista previa).

Note:

Al crear credenciales para el proyecto DevOps, el nombre de usuario debe excluir el @tenancyname normalmente incluido para los proyectos DevOps. Por ejemplo, si el nombre de usuario del proyecto DevOps es Acme/oracleidentitycloudservice/alice.jones@acme.com, el nombre de usuario de las credenciales de AI Data Platform es Acme/oracleidentitycloudservice/alice.jones.

En la página inicial, vaya al espacio de trabajo.
Haga clic en Crear y, a continuación, en Carpeta Git. También puede hacer clic en Agregar en la parte superior derecha y en Carpeta Git.
En la lista desplegable Seleccionar credenciales de Git, seleccione las credenciales de Git necesarias para acceder al repositorio DevOps.
Proporcione la URL del repositorio DevOps. Por ejemplo, https://<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git.
Proporcione un nombre para la carpeta DevOps en el espacio de trabajo.
Proporcione la rama del repositorio DevOps para conectarse a la carpeta.
Haga clic en Create.

Editar carpeta de Git (vista previa)

Puede cambiar el nombre y descripción de una carpeta de Git en el espacio de trabajo.

En la página inicial, vaya al espacio de trabajo.
Junto a la carpeta Git que desea modificar, haga clic en Acciones y, a continuación, en Editar.
Modifique el nombre y descripción de la carpeta.
Actualice las reglas de patrón de cono de finalización de compra dispersa.
Haga clic en Guardar.

Suprimir carpeta de Git (vista previa)

Puede eliminar las carpetas de Git de su espacio de trabajo.

Al suprimir una carpeta de Git, se suprime la carpeta y todos los cambios que no se hayan confirmado y transferido al repositorio.

En la página inicial, vaya al espacio de trabajo.
Junto a la carpeta de Git que desea modificar, haga clic en Acciones y, a continuación, en Suprimir.
Haga clic en Suprimir.

Modificar configuración de carpeta de Git (vista previa)

Puede modificar las credenciales y la URL del repositorio que utiliza una carpeta de Git en el espacio de trabajo.

En la página inicial, vaya al espacio de trabajo.
Haga clic en la carpeta Git para la que desea modificar la configuración.
Haga clic en el separador Configuración.
En la lista desplegable, seleccione las nuevas credenciales para la carpeta Git.
Introduzca la nueva URL del repositorio de Git.
Haga clic en Guardar.

Ver historial de carpetas de Git (vista previa)

Puede ver el historial de confirmaciones en la carpeta Git desde la ficha Historial.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Historial.
Haga clic en el botón Git para ver el historial de confirmaciones en el sitio de Git.

Crear rama de Git (vista previa)

Puede crear nuevas ramas de Git a partir de las ramas existentes de las carpetas de Git en el espacio de trabajo.

Vaya a la carpeta Git y haga clic en el separador Git.
En la lista desplegable Rama actual, seleccione la rama en la que desea basar la nueva rama.
Haga clic en Crear sucursal.
Proporcione un nombre para la nueva rama.
Haga clic en Create.

Suprimir rama de Git (vista previa)

Puede suprimir bifurcaciones de Git del repositorio de Git desde el espacio de trabajo de Oracle AI Data Platform.

Vaya a la carpeta Git y haga clic en el separador Git.
En la lista desplegable Bifurcación actual, seleccione la rama que desea suprimir.
Haga clic en Suprimir rama.
Seleccione todas las bifurcaciones que desea suprimir.
Opcional: seleccione Forzar supresión independientemente del estado de fusión para ignorar las advertencias de las bifurcaciones que no se hayan fusionado.
Haga clic en Suprimir.

Git Pull (vista previa)

Puede seleccionar una rama para realizar una extracción de Git desde una carpeta de Git en el espacio de trabajo.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Extraer.
En la lista desplegable, seleccione la rama de la que desea extraer.
Haga clic en Extraer.
Resuelva los conflictos.
- Haga clic en Mantener local para sobrescribir con la versión local.
- Haga clic en Mantener remoto para sobrescribir con la versión remota.
- También puede realizar sus propios cambios para resolverlos y, a continuación, hacer clic en Marcar como resuelto.
- Haga clic en Abortar extracción para cancelar la solicitud de extracción.
Introduzca un mensaje de confirmación y, opcionalmente, una descripción para la extracción.
Haga clic en Recuperar confirmación.

Push de Git (vista previa)

Puede seleccionar una rama para realizar una transferencia de Git desde dentro de una carpeta de Git en el espacio de trabajo.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Push.
Seleccione los archivos que desea transferir al repositorio de Git. Haga clic en un archivo para ver los cambios en la ventana de código.
Introduzca un mensaje de confirmación y, opcionalmente, una descripción para la transferencia.
Haga clic en Confirmar transferencia.

Fusionar bifurcaciones de Git en principal (vista previa)

Puede fusionar ramas en el tronco principal desde dentro de una carpeta Git en el espacio de trabajo.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Fusionar.
En la lista desplegable, seleccione la rama que desea combinar con la principal.
Haga clic en Fusionar.
Resuelva los conflictos.
- Haga clic en Mantener local para sobrescribir con la versión local.
- Haga clic en Mantener remoto para sobrescribir con la versión remota.
- También puede realizar sus propios cambios para resolverlos y, a continuación, hacer clic en Marcar como resuelto.
- Haga clic en Abortar fusión para cancelar la solicitud de fusión.
Introduzca un mensaje de confirmación y, opcionalmente, una descripción para la combinación.
Haga clic en Confirmar fusión.

Git Rebase (vista previa)

Puede reorganizar una rama en la carpeta Git para aplicar los cambios de esa rama de Git a otra.

Note:

La reorganización de una rama requiere un empuje de fuerza. Forzar la transferencia modifica el historial en el repositorio remoto y puede causar problemas de control de versiones para los colaboradores que trabajan en el mismo repositorio.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Reorganizar.
En la lista desplegable Bifurcación actual, seleccione la rama que desea reorganizar.
En la lista desplegable Reorganizar en rama, seleccione la rama a la que desea reorganizar la rama actual.
Seleccione Confirmar nueva base.
Haga clic en Reorganizar.

Restablecimiento de Git (vista previa)

Puede restablecer una rama en la carpeta Git para revertir el contenido de esa rama a un estado anterior.

Note:

Para restablecer una rama se necesita una transferencia forzada. Forzar la transferencia modifica el historial de la rama actual tanto localmente en el espacio de trabajo como en el repositorio remoto. El historial de la rama se suprime y se restablece en el historial de la rama de restablecimiento remoto.

Vaya a la carpeta Git y haga clic en el separador Git.
Haga clic en el separador Reset (Restablecer).
En la lista desplegable Bifurcación actual, seleccione la rama que desea restablecer.
En la lista desplegable Seleccionar la rama remota a la que desea que se restablezca la rama actual "principal", seleccione la rama en el repositorio de Git remoto a la que desea restablecer la rama actual.
Seleccione Confirmar restablecimiento completo.
Haga clic en Restablecer.