JupyterHub on Kubernetes-Helm安裝

JupyterHub on Kubernetes-Helm安裝

• 本文編譯自 https://zero-to-jupyterhub.readthedocs.io/en/latest/setup-jupyterhub.html
• 本文地址，http://www.javashuo.com/article/p-waqkfjkq-em.html，by openthings, 2018.06.28.
• 更多內容，參考 JupyterHub on Kubernetes部署與應用指南 。

當咱們有了 Kubernetes cluster 和 helm 安裝好後，就能夠開始安裝 JupyterHub了。

一、快速安裝指南

• 參考配置和一些腳本工具在 github.com/openthings/kubernetes-tools/jupyter 。
• 下面的helm安裝方法中，helm .... -f config.yaml會出錯，報缺失參數錯誤。
  • 直接複製Helm Chart到本身的目錄，而後修改。
• 修改proxy:secretToken:爲執行 openssl rand -hex 32產生的字符串，帶引號。
• 在values.yaml文件中，搜索「storageClass」，有兩處，改成"nfs"或其它的存儲引擎。
  • 修改singleuser:storage:capacity:爲 1Gi，以避免=耗用資源過多。
  • 若是須要持久化，參考：Kubernetes搭建NFS原生服務 。
• 全部的image的tag改成具體的版本號。目前安裝時自動替換佔位符功能不可用。
  • 參考：github.com/openthings/kubernetes-tools/jupyter/getimages.sh
  • 最好使用上面的腳本事先下載，以避免安裝時等待時間過長或超時退出。
• 修改proxy:service: type:爲 NodePort。
• 運行安裝：
  • helm install ./jupyterhub --version=v0.6 --name=jupyter --namespace=jupyter
• 運行 kubectl --namespace=jupyter get svc proxy-public，查看端口。
  • 顯示相似PORT(S)80:32600/TCP，瀏覽器打開 localhost:32600便可。

如下爲官方文檔描述的方法，目前按照下面方法自建的config.yaml安裝時會出錯，可能與helm chart編寫、Helm版本等都有關係，還須要完善。建議參照上面的方法來安裝。

二、準備配置文件

準備一個配置文件 (config file). 使用 YAML 文件格式來指定JupyterHub的配置參數。

保存該配置文件到安全的地方，之後還會用來更新JupyterHub的設置。

執行下面的步驟，咱們使用 nano 編輯器。

• 建立文件 config.yaml，執行 nano config.yaml而後編輯。

• 建立隨機hex string做爲安全令牌，運行：

  openssl rand -hex 32

  複製下來。

• 插入文件 config.yaml 。當編輯YAML 文件時，使用空格縮進，不要用tab鍵。替換 RANDOM_STRING 爲上面 openssl rand -hex 32 生成的字符串。

  proxy:
    secretToken: "<OUTPUT-OF-`openssl rand -hex 32`>"

• Azure AKS有效，若是使用 Azure AKS, 必須關閉RBAC，設置以下的配置：

  rbac:
     enabled: false

  查看 RBAC documentation 得到更多細節。

• ctl+x保存 config.yaml 文件。

三、安裝 JupyterHub

• 添加 JupyterHub helm repository 到本地 repo中，以便從中直接安裝JupyterHub。這使使用 JupyterHub chart 更爲方便，而沒必要輸入長長的URL。

  helm repo add jupyterhub https://jupyterhub.github.io/helm-chart/
  helm repo update

  輸出以下：

  Hang tight while we grab the latest from your chart repositories...
  ...Skip local chart repository
  ...Successfully got an update from the "stable" chart repository
  ...Successfully got an update from the "jupyterhub" chart repository
  Update Complete. ⎈ Happy Helming!⎈

• 從包含 config.yaml 文件的目錄運行以下命令，來安裝JupyterHub：

  helm install jupyterhub/jupyterhub \
      --version=v0.6 \
      --name=<YOUR-RELEASE-NAME> \
      --namespace=<YOUR-NAMESPACE> \
      -f config.yaml

  建議 --name 和 --namespace 設爲同樣，以減小混淆，雖然不是必須。

  注意：

  • --name helm deployment的名稱，可以使用helm list查看。
  • --namespace 是 Kubernetes (among other things) 的命名空間，安裝時會自動建立。後續的 kubectl執行操做須要指明在特定的命名空間下操做，如 -n mynamespace。
  • 這須要一些時間，沒有任何輸出，請耐心等待一會。JupyterHub安裝在後臺執行。
  • 若是返回release named <YOUR-RELEASE-NAME> already exists error,經過運行 helm delete --purge <YOUR-RELEASE-NAME> 來刪除已有的安裝。若是換是不行，使用 kubectl delete <YOUR-NAMESPACE> 來刪除，再從新安裝。
  • 完全刪除使用 helm delete --purge <YOUR-RELEASE-NAME> 。
  • 若是拉去大的Docker Image，可能報錯 Error: timed out waiting for the condition error, 添加 --timeout=SOME-LARGE-NUMBER 到 helm install 命令。
  • 這裏的 --version 對應於helm chart的版本，而不是JupyterHub版本。每個JupyterHub helm chart 對應於JupyterHub的版本，好比v0.5的 helm chart運行JupyterHub v0.8。

四、使用JupyterHub

查看安裝後產生的pod：

kubectl --namespace=<YOUR-NAMESPACE> get pod

等到 hub 和 proxy pod 開始運行。

查到JupyterHub的服務 IP，以下：

kubectl --namespace=<YOUR-NAMESPACE> get svc

這裏的 proxy-public service 的external IP一下子就能夠訪問了。

注意：

若是proxy-public 輸出過長，可使用：

kubectl --namespace=<YOUR-NAMESPACE> describe svc proxy-public --output=wide

到瀏覽器，輸入proxy-public service 的 external IP。在登陸頁面輸入任何username 和 password 的組合均可以進入jupyterhub頁面。

你還能夠不少種方式 extend it ，可使用預先構建的用戶容器鏡像，或者本身構建一個，使用不一樣的權限和安裝不一樣的軟件，裏面的軟件包使用conda管理。後續再介紹詳細的方法。