Per collaborare con le parti interessate e altri data scientist, è possibile pubblicare i notebook nei repository GitHub . Puoi anche utilizzare GitHub per eseguire il backup dei notebook per la gestione del codice sorgente.
Guarda questo video per vedere come abilitare l'integrazione GitHub .
Questo video fornisce un metodo visivo per apprendere i concetti e le attività in questa documentazione.
Trascrizione del video Ora Trascrizione 00:00 Questo video mostra come pubblicare i blocchi note dal progetto al proprio account GitHub. 00:07 Passare al profilo e alle impostazioni. 00:11 Nella scheda "Integrations", visita il link per creare un token di accesso personale GitHub . 00:17 Fornire un nome descrittivo per il token e selezionare gli ambiti repo e gist, quindi generare il token. 00:29 Copia il token, torna alle impostazioni di integrazione GitHub e incolla il token. 00:36 Il token viene convalidato quando lo si salva nelle impostazioni del profilo. 00:42 Ora, vai ai tuoi progetti. 00:44 L'integrazione GitHub viene abilitata a livello di progetto nella scheda "Impostazioni". 00:50 Scorri verso il basso e incolla l'URL del repository GitHub esistente. 00:56 Lo troverai nella scheda "Codice" nel repository. 01:01 Fare clic su "Aggiorna" per effettuare la connessione. 01:05 Ora, vai alla scheda "Asset" e apri il notebook che vuoi pubblicare. 01:14 Si noti che questo notebook ha le credenziali sostituite con X. 01:19 È consigliabile rimuovere o sostituire le credenziali prima della pubblicazione in GitHub. 01:24 Quindi, questo notebook è pronto per la pubblicazione. 01:27 È possibile fornire il percorso di destinazione con un messaggio di commit. 01:31 Si ha anche la possibilità di pubblicare il contenuto senza codice nascosto, il che significa che tutte le celle nel notebook che iniziano con il commento della cella nascosta non verranno pubblicate. 01:42 Quando sei pronto, fai clic su "Pubblica". 01:45 Il messaggio indica che il notebook è stato pubblicato correttamente e fornisce collegamenti al notebook, al repository e al commit. 01:54 Diamo un'occhiata al commit. 01:57 Quindi, c'è il commit, ed è possibile navigare al repository per vedere il notebook pubblicato. 02:04 Infine, è possibile pubblicare come un gist. 02:07 I gist sono un altro modo per condividere i tuoi lavori su GitHub. 02:10 Ogni gist è un repository git, quindi può essere biforcato e clonato. 02:15 Ci sono due tipi di gists: pubblico e segreto. 02:19 Se inizi con un gist segreto, puoi convertirlo in un gist pubblico in un secondo momento. 02:24 E ancora una volta, hai la possibilità di rimuovere le celle nascoste. 02:29 Segui il link per vedere il gist pubblicato. 02:32 Ecco le basi dell'integrazione con GitHub. 02:37 Trova ulteriori video nella documentazione Cloud Pak for Data as a Service .
Abilitazione dell'accesso a GitHub dal tuo account
Prima di poter pubblicare i notebook su GitHub, è necessario abilitare il proprio account Cloud Pak for Data as a Service all'accesso a GitHub. Abilita l'accesso creando un token di accesso personale con l'ambito di accesso richiesto in GitHub e collegando il token al tuo account Cloud Pak for Data as a Service .
Attenersi alla seguente procedura per creare un token di accesso personale:
- Fare clic sul proprio avatar nell'intestazione, quindi fare clic su Profilo e impostazioni.
- Vai alla scheda Integrations e fai clic sul link dei token di accesso personali GitHub sulla finestra di dialogo e genera un nuovo token.
- Nella pagina Nuovo token di accesso personale, selezionare l'ambito del repository e fare clic per generare un token.
- Copia il token di accesso generato e incollalo nella finestra di dialogo di integrazione GitHub in Cloud Pak for Data as a Service.
Collegamento di un progetto a un repository GitHub
Dopo aver salvato il token di accesso, il tuo progetto deve essere connesso a un repository GitHub esistente. Puoi collegare solo un repository GitHub esistente da un progetto. Sono supportati i repository privati.
Per collegare un progetto a un repository GitHub esistente, devi avere l'autorizzazione di amministratore per il progetto. Tutti i collaboratori del progetto, che hanno l'autorizzazione di amministratore o editor, possono pubblicare i file in questo repository GitHub . Tuttavia, questi utenti devono disporre dell'autorizzazione per accedere al repository. La concessione delle autorizzazioni utente ai repository deve essere eseguita in GitHub.
Per collegare un progetto a un repository GitHub esistente:
- Seleziona la scheda Manage e vai alla pagina Services and Integrations .
- Fare clic sulla scheda Integrazioni di terzi .
- Fai clic su Connect integration.
- Immetti il tuo token di accesso generato da Github.
Ora puoi iniziare a pubblicare i notebook su GitHub.
Per informazioni su come modificare l'integrazione Git , fare riferimento a Gestione delle integrazioni.
Pubblicazione di un notebook su GitHub
Per pubblicare un blocco note su GitHub:
- Aprire il notebook in modalità di modifica.
- Fai clic sull'icona GitHub
e seleziona Pubblica su GitHub GitHub dalla barra delle azioni del notebook aperto.
Quando si inserisce il nome del file che si desidera pubblicare su GitHub, è possibile specificare un percorso di cartella nel repository GitHub. Tenere presente che i file notebook vengono sempre inviati al ramo principale.
Se si riceve questo errore: An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist. assicurarsi che:
- Hai generato il tuo token di accesso personale, come descritto in Abilitazione dell'accesso a GitHub dal tuo account e il token non è stato eliminato.
- Il repository in cui si desidera pubblicare il notebook esiste ancora.
Argomento principale: Gestione del ciclo di vita di notebook e script