Integrazione Git (anteprima)

33 Integrazione Git (anteprima)

Puoi connettere la tua istanza di Oracle AI Data Platform per includere, leggere e scrivere dati in e da repository Git esterni.

L'integrazione Git in AI Data Platform funziona fornendo le credenziali di login per gli account Git e creando cartelle che si connettono AI repository Git con tali credenziali per includere i dati. È possibile memorizzare più set di credenziali per connettersi a repository Git diversi o gestire livelli di accesso diversi agli stessi repository. Gli amministratori possono selezionare un set di credenziali come profilo predefinito per gli utenti ed eliminare le credenziali quando non sono più necessarie.

Puoi gestire i tuoi file Git interamente dall'interno di AI Data Platform, con utility che ti consentono di eseguire operazioni di push, pull, commit e unione dei file, nonché di gestire eventuali conflitti di unione che si verificano senza dover uscire dalla piattaforma.

AI Data Platform ti consente anche di diramare il codice dal repository Git, nonché di cambiare, unire, confrontare ed eliminare le diramazioni.

Nota

AI Data Platform attualmente supporta repository Git ospitati su provider Git pubblici come GitHub, GitLab, Bitbucket e Oracle Cloud Infrastructure DevOps. Il supporto per Git ospitato su reti private dei clienti sarà disponibile in un aggiornamento futuro.

Cartelle Git in Oracle AI Data Platform (anteprima)

Le cartelle Git in Oracle AI Data Platform consentono di interagire con i dati ospitati in un repository Git senza uscire dalla piattaforma.

Le cartelle Git vengono create nel catalogo principale utilizzando le credenziali impostate nelle impostazioni di AI Data Platform. È possibile connettere la cartella a un repository Git e utilizzare l'interfaccia utente di AI Data Platform per eseguire il push, il pull, l'unione, il rebase e il reset dei file nel repository.

È possibile gestire le autorizzazioni RBAC per la cartella Git per controllare chi può visualizzare la cartella e quali operazioni Git sono in grado di eseguire. Per ulteriori informazioni, vedere Autorizzazioni cartella Git (anteprima).

Regole pattern cono (anteprima)

I checkout parziali dei contenuti Git in Oracle AI Data Platform supportano la modalità Cone.

Il comando sparse-checkout in Git viene utilizzato per creare checkout con sparsità, che modificano l'albero di lavoro per tenere traccia di un sottoinsieme di tutti i file tracciati. In AI Data Platform, è necessario utilizzare la modalità Cone quando si forniscono le directory con il comando sparse-checkout. I pattern devono rappresentare i percorsi delle cartelle repository-root-relative.

Valori consentiti dal pattern cono sparse-checkout

La modalità Cono consente di utilizzare i seguenti valori nei pattern quando si utilizza sparse-checkout:

Valori vuoti. L'immissione di un valore vuoto indica una modalità non conica. L'intero repository è duplicato.
Percorsi cartella relativi alla radice del repository:
- project-a
- project-a/src
- notebooks/jobs/
Nomi delle cartelle che non contengono caratteri limitati (vedere di seguito)

Valori non consentiti dal pattern cono sparse-checkout

I seguenti valori non sono accettati nei pattern quando si utilizza la modalità Cono per sparse-checkout:

Valore non consentito	Esempio
Pattern di esclusione	`!src`
Sintassi glob non conica	`*.py`, `src/[abc]`, `src?`
Percorso assoluto/radicato	`/src`, `/`
Barre rovesciate	`src\main`
Indicatore radice repository	`.`, `./`
Iniziale `./`	`./src`
Segmenti percorso vuoti	`src//main`
Attraversamento padre	`../src`, `src/../main`
Cruscotto principale	`-src`
Caratteri di controllo	ad esempio nuove righe, ritorni a capo, caratteri nulli

Limiti modalità cono

Quando si utilizza la modalità Cone per sparse-checkout, si applicano i seguenti limiti:

Componente	Limite
Numero di modelli	100 pattern
Lunghezza dei modelli	1000 caratteri
Pattern vuoti	Consentito

Percorsi cartella Git

I percorsi delle cartelle Git vengono convalidati come percorso relativo. Ogni segmento di percorso può contenere solo:

Lettere: a-z, A-Z
Numeri: 0-9
Carattere di sottolineatura: _
trattino: -
Punto: .
Spazio
Simbolo: @

I percorsi validi sono i seguenti:

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

Non sono consentiti i percorsi Git utilizzati con sparse-checkout:

Percorsi assoluti
Attraversamento padre
Caratteri speciali: !, #, $, %, *, ?, [, ], \, :

Crea una cartella Git (anteprima)

È possibile creare una cartella nell'area di lavoro di Oracle AI Data Platform connessa a un repository Git esterno.

Nella home page, andare all'area di lavoro.
Fare clic su Crea, quindi fare clic su Cartella Git. È inoltre possibile fare clic su Aggiungi in alto a destra e fare clic su Cartella Git.
Dall'elenco a discesa Seleziona credenziali Git, selezionare le credenziali Git necessarie per accedere al repository Git.
Fornire l'URL del repository Git. Ad esempio: example.git.path.
Fornire un nome per la cartella Git nell'area di lavoro.
Fornire la diramazione dal repository Git per connettersi alla cartella.
Fornire pattern cono di checkout con sparsità per le cartelle che si desidera duplicare. Lasciare vuoto questo campo per duplicare l'intero repository.
Fare clic su Crea.

Creare una cartella Git per un repository DevOps OCI (anteprima)

È possibile creare una cartella Git in Oracle AI Data Platform per un repository DevOps creato in Oracle Cloud Infrastructure.

È necessario aver già creato il repository DevOps in OCI. Per ulteriori informazioni, vedere Creazione di un repository.

È necessario aver già creato le credenziali per accedere al progetto DevOps in AI Data Platform. Per ulteriori informazioni, vedere Crea credenziali (anteprima).

Nota

Quando si creano le credenziali per il progetto DevOps, il nome utente deve escludere il valore @tenancyname normalmente incluso per i progetti DevOps. Ad esempio, se il nome utente del progetto DevOps è Acme/oracleidentitycloudservice/alice.jones@acme.com, il nome utente per le credenziali di AI Data Platform è Acme/oracleidentitycloudservice/alice.jones.

Nella home page, andare all'area di lavoro.
Fare clic su Crea, quindi fare clic su Cartella Git. È inoltre possibile fare clic su Aggiungi in alto a destra e fare clic su Cartella Git.
Dall'elenco a discesa Seleziona credenziali Git, selezionare le credenziali Git necessarie per accedere al repository DevOps.
Fornire l'URL del repository DevOps. Ad esempio, https://<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git.
Fornire un nome per la cartella DevOps nell'area di lavoro.
Fornire la diramazione dal repository DevOps per connettersi alla cartella.
Fare clic su Crea.

Modifica cartella Git (anteprima)

È possibile modificare nome e descrizione di una cartella Git nell'area di lavoro.

Nella home page, andare all'area di lavoro.
Avanti alla cartella Git che si desidera modificare, fare clic su Azioni, quindi fare clic su Modifica.
Modificare nome e descrizione per la cartella.
Aggiornare le regole del pattern cono di checkout con sparsità.
Fare clic su Save.

Elimina cartella Git (anteprima)

È possibile eliminare le cartelle Git personali dall'area di lavoro.

L'eliminazione di una cartella Git comporta l'eliminazione della cartella e delle eventuali modifiche di cui non è stato eseguito il commit e il push nel repository.

Nella home page, andare all'area di lavoro.
Avanti alla cartella Git che si desidera modificare, fare clic su Azioni, quindi fare clic su Elimina.
Fare clic su Elimina.

Modifica impostazioni cartella Git (anteprima)

È possibile modificare le credenziali e l'URL del repository utilizzati da una cartella Git nell'area di lavoro.

Nella home page, andare all'area di lavoro.
Fare clic sulla cartella Git per la quale si desidera modificare le impostazioni.
Fare clic sulla scheda Impostazioni.
Dall'elenco a discesa, selezionare le nuove credenziali per la cartella Git.
Immettere il nuovo URL del repository Git.
Fare clic su Save.

Visualizza cronologia cartella Git (anteprima)

È possibile visualizzare la cronologia dei commit nella cartella Git dalla scheda Cronologia.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Cronologia.
Fare clic sul pulsante Git per visualizzare la cronologia dei commit sul sito Git.

Crea diramazione Git (anteprima)

È possibile creare nuove diramazioni Git dalle diramazioni esistenti dalle cartelle Git nell'area di lavoro.

Passare alla cartella Git e fare clic sulla scheda Git.
Dall'elenco a discesa Diramazione corrente selezionare la diramazione su cui si desidera basare la nuova diramazione.
Fare clic su Crea ramo.
Fornire un nome per la nuova diramazione,
Fare clic su Crea.

Elimina diramazione Git (anteprima)

È possibile eliminare le diramazioni Git dal repository Git dall'interno dell'area di lavoro di Oracle AI Data Platform.

Passare alla cartella Git e fare clic sulla scheda Git.
Dall'elenco a discesa Diramazione corrente, selezionare la diramazione che si desidera eliminare.
Fare clic su Elimina ramo.
Selezionare tutte le diramazioni da eliminare.
Facoltativo: selezionare Forza eliminazione indipendentemente dallo stato di unione per ignorare le avvertenze per le diramazioni non unite.
Fare clic su Elimina.

Pull Git (anteprima)

È possibile selezionare una diramazione da cui eseguire un'estrazione Git all'interno di una cartella Git nell'area di lavoro.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Pull.
Dall'elenco a discesa, selezionare la diramazione da cui si desidera estrarre.
Fare clic su Ritiro.
Risolvere eventuali conflitti.
- Fare clic su Conserva locale per sovrascrivere con la versione locale.
- Fare clic su Conserva remoto per eseguire la sovrascrittura con la versione remota.
- È inoltre possibile apportare modifiche personalizzate per la risoluzione, quindi fare clic su Contrassegna come risolto.
- Fare clic su Interrompi pull per annullare la richiesta Pull.
Immettere un messaggio di commit e, facoltativamente, una descrizione per il pull.
Fare clic su Esegui commit pull.

Push Git (anteprima)

È possibile selezionare una diramazione da cui eseguire un push Git all'interno di una cartella Git nell'area di lavoro.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Push.
Selezionare i file che si desidera inviare al repository Git. Fare clic su un file per visualizzare le modifiche nella finestra del codice.
Immettere un messaggio di commit e, facoltativamente, una descrizione per il push.
Fare clic su Esegui commit push.

Unisci diramazioni Git in principale (anteprima)

È possibile unire di nuovo i rami nel giuntore principale dall'interno di una cartella Git nell'area di lavoro.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Unisci.
Dall'elenco a discesa, selezionare la diramazione che si desidera unire con la principale.
Fare clic su Unisci.
Risolvere eventuali conflitti.
- Fare clic su Conserva locale per sovrascrivere con la versione locale.
- Fare clic su Conserva remoto per eseguire la sovrascrittura con la versione remota.
- È inoltre possibile apportare modifiche personalizzate per la risoluzione, quindi fare clic su Contrassegna come risolto.
- Fare clic su Interrompi unione per annullare la richiesta di unione.
Immettere un messaggio di commit e, facoltativamente, una descrizione per l'unione.
Fare clic su Esegui commit unione.

Git Rebase (anteprima)

È possibile unire di nuovo una diramazione nella cartella Git per applicare le modifiche da tale diramazione Git a un'altra diramazione.

Nota

Il rebasing di una diramazione richiede un push forzato. Il push forzato modifica la cronologia nel repository remoto e può causare problemi di controllo delle versioni per i collaboratori che lavorano sullo stesso repository.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Rapplica.
Dall'elenco a discesa Diramazione corrente selezionare la diramazione da unire di nuovo.
Dall'elenco a discesa Rapplica a diramazione, selezionare la diramazione a cui eseguire nuovamente l'unione di base della diramazione corrente.
Selezionare Conferma base.
Fare clic su Rapplica.

Reimpostazione Git (anteprima)

È possibile reimpostare una diramazione nella cartella Git per ripristinare lo stato precedente del contenuto di tale diramazione.

Nota

La reimpostazione di una diramazione richiede un push forzato. Il push forzato modifica la cronologia della diramazione corrente sia localmente nell'area di lavoro che nel repository remoto. La cronologia della diramazione viene eliminata e reimpostata sulla cronologia della diramazione di reimpostazione remota.

Passare alla cartella Git e fare clic sulla scheda Git.
Fare clic sulla scheda Reimposta.
Dall'elenco a discesa Diramazione corrente selezionare la diramazione da reimpostare.
Dall'elenco a discesa Scegliere la diramazione remota in cui si desidera reimpostare la diramazione corrente "main", selezionare la diramazione nel repository Git remoto in cui reimpostare la diramazione corrente.
Selezionare Conferma reimpostazione permanente.
Fare clic su Reimposta.