Bundle e CI/CD (anteprima)

34 Bundle e CI/CD (anteprima)

I bundle definiscono il modo in cui le risorse di Oracle AI Data Platform Workbench sono confezionate, con controllo delle versioni, condivise e distribuite tra aree di lavoro e ambienti.

È possibile creare bundle per job e agenti. Un bundle viene creato in una cartella Git in modo che i file bundle possano essere sottoposti a commit e push in un repository Git. Le risorse incluse nel bundle possono provenire da qualsiasi posizione nell'area di lavoro. Se le risorse selezionate fanno riferimento a file o dipendenze di supporto, ad esempio notebook, script o computazione, tali riferimenti vengono inclusi nel bundle in modo che le risorse possano essere distribuite in un altro ambiente senza ricreare manualmente gli stessi componenti.

È possibile creare bundle dall'area di lavoro e selezionare le risorse di Oracle AI Data Platform Workbench da includere al momento della creazione. I bundle esistenti possono essere modificati per aggiungere o rimuovere risorse. La creazione di bundle di risorse consente di raggruppare i job e gli agenti correlati e di distribuirli in altri ambienti con le relative dipendenze invariate.

È possibile eseguire il commit e il push dei bundle nel repository Git tramite le cartelle Git. Gli utenti possono quindi estrarre i bundle nei propri ambienti e distribuirli. Le modifiche ai file bundle sono disponibili per altri ambienti dopo il commit e il push delle modifiche nel repository Git. Ogni volta che gli utenti estraggono il bundle aggiornato dal repository Git, ricevono gli ultimi file di risorse con commit.

Concetti bundle

Concetto	Significato	Azione utente
Cartella Git	Cartella AI Data Platform connessa a un repository e a una diramazione Git. I bundle possono essere creati solo nelle cartelle Git.	Creare o aprire una cartella Git prima di creare un bundle.
Bundle	Package distribuibile che definisce le risorse selezionate e le relative dipendenze.	Creare il bundle dall'area di lavoro, quindi selezionare risorse quali job o flussi agente.
Contenuto bundle	File generati che descrivono risorse, variabili, impostazioni di destinazione e artifact necessari per la distribuzione.	Rivedere il contenuto generato dopo la creazione o la sincronizzazione. Eseguire il commit e il push del bundle tramite Git quando è pronto.
Obiettivo	Configurazione dell'ambiente o dell'area di lavoro utilizzata durante la distribuzione del bundle al di fuori dell'ambiente di origine.	Fornire i valori che devono essere modificati dall'ambiente, ad esempio la chiave dell'area di lavoro, il nome della credenziale, la chiave token o le impostazioni predefinite dei parametri.
Articolo distribuito	Risorsa creata o aggiornata da una distribuzione bundle nell'area di lavoro di destinazione.	Utilizzare la scheda Distribuzione per distribuire, rivedere gli elementi distribuiti, eseguire i job e rimuovere le risorse distribuite quando necessario.
Sincronizzazione	Azione bundle che aggiorna le risorse e le dipendenze bundle dalle risorse di origine più recenti.	Eseguire la sincronizzazione dopo aver modificato le risorse in bundle, quindi eseguire il commit dei file bundle aggiornati in Git.

Operazioni preliminari

Selezionare questa lista per assicurarsi di disporre di tutti gli elementi necessari per iniziare a utilizzare i bundle Git nell'area di lavoro AI Data Platform:

Creare le credenziali Git e una cartella Git che punta al repository e al ramo utilizzati per i file bundle.
Confermare che le risorse di origine si trovano nell'area di lavoro e che vengono salvate prima di creare o sincronizzare il bundle.
Per la distribuzione tra ambienti, verificare che l'area di lavoro di destinazione disponga delle autorizzazioni necessarie e della capacità di computazione.
Per i job o i notebook che utilizzano i segreti, creare le credenziali denominate richieste nell'area di memorizzazione delle credenziali di destinazione. I file bundle devono fare riferimento alle credenziali per nome o variabile, non devono contenere valori segreti.
Eseguire il commit e il push delle modifiche ai file bundle dopo la creazione o la sincronizzazione di un bundle in modo che altri ambienti possano estrarre la definizione di bundle più recente.

Crea un gruppo di proprietà (anteprima)

È possibile raggruppare risorse di job e agenti di Oracle AI Data Platform per creare un package che può essere distribuito in un'altra cartella Git.

Passare all'area di lavoro.
Fare clic su Azioni, quindi su Crea bundle.
Fornire un nome e una descrizione per il bundle.
Fare clic su Sfoglia e selezionare la cartella Git nell'area di lavoro in cui si desidera creare il bundle.
Selezionare le risorse che si desidera includere nel bundle dalle opzioni elencate.
Fare clic su Crea.

Nota
I bundle vengono creati nelle cartelle Git. Se la posizione selezionata non si trova all'interno di una cartella Git, non è possibile utilizzare Git per spostare i file bundle generati in un altro ambiente.

Distribuisci un bundle (anteprima)

È possibile distribuire bundle da una cartella Git per condividere risorse e dipendenze tra aree di lavoro e ambienti.

Passare al bundle che si desidera distribuire nell'area di lavoro.
Fare clic sulla scheda Distribuzione.
Facoltativo: esaminare i valori e gli override di destinazione, se applicabile.
Fare clic su Distribuisci. Si riceve una notifica al termine della distribuzione.

Nota
Alla prima distribuzione, la scheda Distribuzione potrebbe non mostrare alcun elemento distribuito finché la distribuzione non riesce. Dopo una distribuzione riuscita, rivedere le risorse distribuite, eseguire job o agenti in base alle esigenze e confermare l'output runtime.

Rimuovi un bundle (anteprima)

È possibile rimuovere un bundle distribuito per rimuovere le risorse del bundle dall'area di lavoro.

Passare al bundle per il quale si desidera rimuovere le risorse nell'area di lavoro.
Fare clic sulla scheda Distribuzione.
Fare clic su Rimuovi.
Immettere Rimuovi nel prompt. Fare clic su Rimuovi.