利害関係者やその他のデータ・サイエンティストとコラボレーションするために、 GitHub リポジトリーでノートブックを公開できます。 GitHub を使用して、ソース・コード管理用のノートブックをバックアップすることもできます。
このビデオを視聴して、GitHub 統合を有効にする方法を確認してください。
このビデオは、本書の概念とタスクを学習するためのビジュアル・メソッドを提供します。
動画のトランスクリプト 時刻 トランスクリプト 00:00 このビデオでは、プロジェクトのノートブックをGitHubアカウントに公開する方法を紹介します。 00:07 自分のプロファイルと設定にナビゲートします。 00:11 「統合」タブで、GitHub パーソナル・アクセス・トークンを生成するためのリンクにアクセスします。 00:17 トークンの記述名を指定し、リポジトリーと gist スコープを選択してから、トークンを生成します。 00:29 トークンをコピーし、GitHub 統合設定に戻り、トークンを貼り付けます。 00:36 トークンは、プロファイル設定に保存するときに検証されます。 00:42 次に、プロジェクトにナビゲートします。 00:44 「設定」タブで、プロジェクト・レベルで GitHub 統合を有効にします。 00:50 下部までスクロールして、既存の GitHub リポジトリー URL を貼り付けるだけです。 00:56 これは、リポジトリーの「コード」タブに表示されます。 01:01 「更新」をクリックして接続します。 01:05 次に、「資産」タブに移動し、公開するノートブックを開きます。 01:14 このノートブックでは、資格情報が X に置き換えられていることに注意してください。 01:19 GitHub に公開する前に資格情報を削除または置換するのがベスト・プラクティスです。 01:24 これで、このノートブックを公開する準備ができました。 01:27 コミット・メッセージとともにターゲット・パスを指定できます。 01:31 また、非表示コードなしでコンテンツを公開するオプションもあります。これは、ノートブック内の非表示セル・コメントで始まるセルは公開されないことを意味します。 01:42 準備ができたら、「公開」をクリックします。 01:45 このメッセージは、ノートブックが正常に公開されたことを示し、ノートブック、リポジトリー、およびコミットへのリンクを提供します。 01:54 コミットについて見てみましょう。 01:57 コミットがあるので、リポジトリーにナビゲートして、公開されたノートブックを確認できます。 02:04 最後に、Gist として公開できます。 02:07 Gist は、GitHub で作業を共有するためのもう 1 つの方法です。 02:10 すべての Gist は Git リポジトリーであるため、フォークして複製することができます。 02:15 Gist には、パブリックとシークレットの 2 つのタイプがあります。 02:19 シークレット Gist を使用して開始した場合は、後でそれをパブリック Gist に変換できます。 02:24 ここでも、非表示のセルを削除するオプションがあります。 02:29 リンクをたどると、公開された Gist が表示されます。 02:32 これがGitHubとの連携の基本です。 02:37 Cloud Pak for Data as a Service の資料には他にもビデオがあります。
アカウントからの GitHub へのアクセスの有効化
GitHub,でノートブックを公開する前に、Cloud Pak for Data as a Serviceアカウントを有効にしてGitHubにアクセスする必要があります。 アクセスを有効にするには、 GitHub で必要なアクセス・スコープを指定して個人用アクセス・トークンを作成し、そのトークンを Cloud Pak for Data as a Service アカウントにリンクします。
個人アクセス・トークンを作成するには、以下のステップを実行します。
- ヘッダーで自分のアバターをクリックし、 「プロファイルと設定 (Profile and settings)」をクリックします。
- 「統合 (Integrations)」 タブに移動し、ダイアログで GitHub 個人用アクセス・トークン・リンクをクリックして、新規トークンを生成します。
- 「新しい個人アクセス・トークン (New personal access token)」ページで、リポジトリー・スコープを選択し、クリックしてトークンを生成します。
- 生成されたアクセス・トークンをコピーして、 Cloud Pak for Data as a Serviceの GitHub 統合ダイアログ・ウィンドウに貼り付けます。
GitHub リポジトリーへのプロジェクトのリンク
アクセス・トークンを保存した後、プロジェクトを既存の GitHub リポジトリーに接続する必要があります。 プロジェクトからリンクできる既存の GitHub リポジトリーは 1 つのみです。 プライベート・リポジトリーがサポートされます。
プロジェクトを既存の GitHub リポジトリーにリンクするには、プロジェクトに対する管理者権限が必要です。 管理者権限または編集者権限を持つすべてのプロジェクト・コラボレーターが、この GitHub リポジトリーにファイルを公開できます。 ただし、これらのユーザーには、リポジトリーにアクセスするための権限が必要です。 リポジトリーに対する権限をユーザーに付与するのは、GitHub 内で行う必要があります。
既存の GitHub リポジトリーにプロジェクトを接続するには、以下のようにします。
- 「管理」タブを選択し、 「サービスと統合」ページに移動します。
- 「サード・パーティー統合」タブをクリックします。
- 「統合の接続」をクリックします。
- Github から生成したアクセス・トークンを入力します。
これで、GitHub でのノートブックの公開を開始できます。
Git 統合の変更方法については、 統合の管理を参照してください。
GitHub でのノートブックの公開
ノートブックを GitHub で公開するには、以下のようにします。
- ノートブックを編集モードで開きます。
- GitHub 統合 アイコン をクリックし、開いたノートブックのアクション・バーから 「 GitHub を選択します。
GitHub で公開するファイルの名前を入力する際、GitHub リポジトリー内のフォルダー・パスを指定できます。 ノートブック・ファイルは常にマスター・ブランチにプッシュされることに注意してください。
「 An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist.
」というエラーが表示された場合は、以下のことを確認してください。
- アカウントからの GitHub へのアクセスの有効化 の説明に従って個人用アクセス・トークンを生成しましたが、そのトークンは削除されませんでした。
- ノートブックの公開先のリポジトリーはまだ存在しています。
親トピック: ノートブックおよびスクリプトのライフサイクルの管理