將筆記本儲存至 GitHub

如要備份使用者管理的筆記本執行個體並供他人使用,請將使用者管理的筆記本執行個體內容儲存至 GitHub。

建立 GitHub 存放區

如果您目前沒有 GitHub 存放區,則必須建立一個。

建立 GitHub 存放區時,請選取「Initialize this repository with a README」核取方塊,確保您的 GitHub 存放區可以複製。

使用 README 檔案初始化 GitHub 存放區。

在使用者管理的筆記本執行個體中複製 GitHub 存放區

如要在使用者管理的筆記本執行個體中複製 GitHub 存放區,請完成下列步驟:

  1. 在 GitHub 存放區中,按一下「Code」按鈕,然後點選「Local」分頁。

  2. 複製 HTTPS 網址。

  3. 前往 Google Cloud 控制台的「使用者管理的 Notebook」頁面。

    前往「使用者自行管理的筆記本」

  4. 按一下「Open JupyterLab」,即可開啟使用者管理的筆記本執行個體。

  5. 在 JupyterLab 「檔案瀏覽器」中,選取要複製 GitHub 存放區的資料夾。例如主資料夾。

    筆記本首頁資料夾。

  6. 在 JupyterLab 中,依序選取「Git」「Clone a Repository」

  7. 出現提示時,請輸入憑證。

    • 如果您使用 GitHub 使用者名稱和密碼,請輸入 GitHub 使用者名稱和密碼。

    • 如果您搭配 GitHub 使用雙重驗證功能,請建立並使用個人存取權杖

  8. 在「Clone a repo」對話方塊中,貼上 GitHub 存放區的 HTTPS 網址。

    貼上存放區網址並複製。

  9. 按一下 [Clone] (複製)。

根據您的 GitHub 使用者資訊設定由使用者管理的筆記本執行個體

  1. 在 JupyterLab 中,選取「Git」>「在終端機中開啟 Git 存放區」,以開啟 Git 終端機視窗。

  2. 在 Git 終端機視窗中,輸入下列指令以設定您的 Git 使用者名稱和電子郵件:

    git config --global user.name "YOUR_NAME"
    git config --global user.email "YOUR_EMAIL"
  3. 如果 GitHub 帳戶需要 SSH 驗證,請完成下列步驟連結帳戶:

    1. 在使用者管理的筆記本執行個體中,透過 Git 終端機按照 GitHub 的操作說明產生新的安全殼層金鑰。

    2. 請按照操作說明將該 SSH 金鑰新增至 GitHub 帳戶。

  4. 關閉 Git 終端機視窗。

將修訂過的檔案新增至 GitHub 存放區

  1. 使用者管理的筆記本執行個體會以新資料夾的形式顯示您的存放區。如果複製的 GitHub 存放區未以資料夾形式顯示,請點選「Refresh File List」按鈕。

    「Refresh File List」(重新整理檔案清單) 按鈕。

  2. 按兩下存放區資料夾,以開啟此資料夾。

  3. 將新筆記本新增至使用者自行管理的筆記本執行個體。

    如要新增筆記本檔案,可以使用選單或啟動器。

    1. 如要透過選單新增筆記本檔案,請依序選取「File」「New」「Notebook」

      新增筆記本檔案。

    2. 在「Select kernel」對話方塊中,選取新筆記本的核心,例如「Python 3」,然後按一下「Select」

      新的筆記本檔案隨即開啟。

    啟動器

    1. 如要透過啟動器新增筆記本檔案,請依序選取「File」>「New」>「Launcher」

    2. 按一下要使用的核心資訊方塊。

      新增筆記本檔案。

      新的筆記本檔案隨即開啟。

  4. 重新命名新的筆記本檔案。

    1. 依序選取「File」>「Rename notebook」。系統會開啟「Rename file」對話方塊。

    2. 在「New name」(新名稱) 欄位中,將 Untitled.ipynb 變更為有意義的名稱,例如 install.ipynb

    3. 按一下 [重新命名]

    啟動器

    1. Untitled.ipynb 分頁上按一下滑鼠右鍵,然後點選「Rename notebook」。系統會隨即開啟「Rename file」對話方塊。

    2. 在「New name」(新名稱) 欄位中,將 Untitled.ipynb 變更為有意義的名稱,例如 install.ipynb

    3. 按一下 [重新命名]

  5. 選取 [Git] 分頁標籤。您的新筆記本會列在「Untracked」的群組中。

  6. 如要將新筆記本以檔案的形式新增到 GitHub 存放區,請以滑鼠右鍵按一下新筆記本,然後選取「Track」。在「Git」分頁中,您的筆記本現在會新增到「Staged」群組。

  7. 如要修訂新筆記本並儲存到 GitHub 存放區,請在「Git」分頁新增修訂註解,然後按一下「Commit」

  8. 如要開啟 Git 終端機視窗,請依序選取「Git」>「在終端機中開啟 Git 存放區」

  9. 在 Git 終端機視窗中輸入 git push 指令。

    • 如果您使用 GitHub 使用者名稱和密碼,請在系統提示時輸入 GitHub 使用者名稱和密碼。

    • 如果您搭配 GitHub 使用雙重驗證功能,請建立個人存取權杖

    git push 指令執行完畢之後,您修訂過的檔案就會儲存在 GitHub 存放區。