Pour collaborer avec les parties prenantes et d'autres spécialistes des données, vous pouvez publier vos blocs-notes dans les référentiels GitHub . Vous pouvez également utiliser GitHub pour sauvegarder des blocs-notes pour la gestion du code source.
Regardez cette vidéo pour voir comment activer l'intégration à GitHub.
Cette vidéo fournit une méthode visuelle pour apprendre les concepts et les tâches de cette documentation.
Retranscription de la vidéo Heure Transcription 00:00 Cette vidéo vous montre comment publier des carnets de notes de votre projet sur votre compte GitHub. 00:07 Accédez à votre profil et à vos paramètres. 00:11 Dans l'onglet "Intégrations", visitez le lien pour générer un jeton d'accès personnel GitHub. 00:17 Indiquez un nom descriptif pour le jeton et sélectionnez les portées repo et gist, puis générele jeton. 00:29 Copiez le jeton, retournez aux paramètres d'intégration de GitHub et collez le jeton. 00:36 Le jeton est validé lorsque vous l'enregistrez dans vos paramètres de profil. 00:42 Maintenant, naviguez jusqu'à vos projets. 00:44 Vous activez l'intégration GitHub au niveau du projet dans l'onglet "Paramètres". 00:50 Il suffit de faire défiler vers le bas et de coller l'URL du référentiel GitHub. 00:56 Vous trouverez cela sur l'onglet "Code" du repo. 01:01 Cliquez sur "Mettre à jour" pour établir la connexion. 01:05 Maintenant, allez à l'onglet "Actifs" et ouvrez le bloc-notes que vous voulez publier. 01:14 Notez que ce bloc-notes possède les données d'identification remplacées par X's. 01:19 Il est préférable de supprimer ou de remplacer les données d'identification avant de les publier sur GitHub. 01:24 Ce bloc-notes est donc prêt pour la publication. 01:27 Vous pouvez indiquer le chemin cible avec un message de validation. 01:31 Vous avez également la possibilité de publier du contenu sans code caché, ce qui signifie que toutes les cellules du bloc-notes qui ont commencé avec le commentaire de cellule masquée ne seront pas publiées. 01:42 Lorsque vous êtes prêt, cliquez sur "Publier". 01:45 Le message vous indique que le bloc-notes a été publié avec succès et qu'il fournit des liens vers le bloc-notes, le référentiel et la validation. 01:54 Examinons la validation. 01:57 Donc, il y a la validation, et vous pouvez naviguer vers le référentiel pour voir le bloc-notes publié. 02:04 Enfin, vous pouvez publier en tant que gist. 02:07 Les gistes sont une autre façon de partager votre travail sur GitHub. 02:10 Chaque giste est un dépôt git, donc il peut être foré et cloné. 02:15 Il existe deux types de gistes : le public et le secret. 02:19 Si vous commencez avec un giste secret, vous pouvez le convertir à un giste public plus tard. 02:24 Et encore une fois, vous avez l'option de supprimer les cellules cachées. 02:29 Suivez le lien pour voir l'essentiel de la publication. 02:32 Voilà donc les bases de l'intégration de GitHub. 02:37 Trouvez d'autres vidéos dans la documentation de Cloud Pak for Data as a Service.
Activation de l'accès à GitHub depuis votre compte
Avant de pouvoir publier des notebooks sur GitHub, vous devez activer votre compte Cloud Pak for Data as a Service pour accéder à GitHub. Vous activez l'accès en créant un jeton d'accès personnel avec la portée d'accès requise dans GitHub et en liant le jeton à votre compte Cloud Pak for Data as a Service .
Procédez comme suit pour créer un jeton d'accès personnel :
- Cliquez sur votre avatar dans l'en-tête, puis sur Profil et paramètres.
- Accédez à l'onglet Intégrations et cliquez sur le lien des jetons d'accès personnels GitHub dans la boîte de dialogue et générez un nouveau jeton.
- Sur la page New personal access token, sélectionnez la portée du référentiel, puis cliquez pour générer un jeton.
- Copiez le jeton d'accès généré et collez-le dans la boîte de dialogue d'intégration GitHub dans Cloud Pak for Data as a Service.
Liaison d'un projet à un référentiel GitHub
Une fois que vous avez sauvegardé le jeton d'accès, votre projet doit être connecté à un référentiel GitHub existant. Vous pouvez uniquement établir un lien vers un référentiel GitHub existant à partir d'un projet. Les référentiels privés sont pris en charge.
Pour lier un projet à un référentiel GitHub existant, vous devez disposer des droits d'administrateur sur le projet. Tous les collaborateurs du projet dotés d'autorisations d'administrateur ou d'éditeur peuvent publier des fichiers dans ce référentiel GitHub. Ces utilisateurs doivent tout de même être autorisés à accéder au référentiel. L'octroi d'autorisations d'utilisateur sur les référentiels doit être effectué dans GitHub.
Pour connecter un projet à un référentiel GitHub existant :
- Sélectionnez l'onglet Gérer et accédez à la page Services et intégrations.
- Cliquez sur l'onglet Intégrations de tiers.
- Cliquez sur Intégration de la connexion.
- Entrez votre jeton d'accès généré à partir de Github.
Vous pouvez maintenant commencer à publier des blocs-notes sur GitHub.
Pour plus d'informations sur la modification de votre intégration Git , voir Gestion de vos intégrations.
Publication d'un bloc-notes sur GitHub
Pour publier un bloc-notes sur GitHub :
- Ouvrez le bloc-notes en mode édition.
- Cliquez sur l' icône d'intégrationGitHub
et sélectionnez Publier sur GitHub dans la barre d'actions du bloc-notes ouvert.
Lorsque vous entrez le nom du fichier que vous souhaitez publier sur GitHub, vous pouvez spécifier un chemin de dossier dans le référentiel GitHub. Notez que les fichiers de bloc-notes sont toujours poussés vers la branche principale.
Si vous obtenez cette erreur: An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist. assurez-vous que:
- Vous avez généré votre jeton d'accès personnel, comme décrit dans Activation de l'accès à GitHub à partir de votre compte et le jeton n'a pas été supprimé.
- Le référentiel dans lequel vous souhaitez publier votre bloc-notes existe toujours.
Rubrique parent: Gestion du cycle de vie des blocs-notes et des scripts