Aller au contenu principal

Administration Guides

Etat du service​

VĂ©rifier l'Ă©tat Running des pods depuis l'IHM de Rancher (namespace : kosmos-data)

VBF Datalab

Le pod nommé hub-* est le proxy JupyterHUB. Les pods préfixés par jupyter- sont les serveurs (LABS) des utilisateurs métiers qui sont actuellement démarrés.

Gestion des ressources d'un notebook​

Le but de cette procédure est de pouvoir changer les capacités mémoire de Jupyterhub, par exemple les ressources allouées à chaque user et au PV déployé, ainsi que le nombre de CPU alloués à chaque lab.

Les volumes des labs sont déployés en même temps que Jupyter. Il faut donc changer la taille des volumes déployés dans la configuration de Jupyter.

Modifier la taille des volumes​

- jupyterhubuserpv_capacity_storage: 5Gi
- jupyterhub_per_user_capacity_storage: 1Gi

Modifier les paramètres suivants en fonction de ses besoins.

jupyterhubuserpv_capacity_storage : correspond à la capacité maximale du PV déployé pour contenir les labs de tous les utilisateurs.

jupyterhub_per_user_capacity_storage : correspond à la capacité maximale de l'espace réservé par utilisateur dans le PV déployé.

Editer le fichier de configuration de jupyterhub depuis Rancher.

attention

Ces modifications ne seront pas persistés pour un prochain déploiement, il est nécessaire de prévenir le gestionnaire de configuration pour faire persister la modification.

Modifier le nombre de CPU​

On peut augmenter de la même façon le nombre de CPU associés à chaque lab dans la configuration de Jupyter.

Dans la partie Jupyter Hardware configuration, augmenter la limite de CPU de la façon suivante :

# Jupyterhub hardware configuration
jupyterhub_per_user_cpu_requests: nombredecpu
jupyterhub_per_user_cpu_limit: nombredecpu

Par défaut cpu request est égal à 1 et cpu limit est égal à 2.

Augmentation de l'espace disque du serveur de l'utilisateur​

à l'usage, l'utilisateur peut saturer son serveur, le PVC dédié à son serveur peut être augmenté comme tout PVC (cf. Kubernetes - Augmenter la taille d'un PVC) par la commande suivante:

kubectl -n kosmos-data patch pvc <nom du PVC> -p '{"spec":{"resources":{"requests":{"storage":"5Gi"}}}}'
#ex: kubectl -n kosmos-data patch pvc claim-umla-pour-52lab -p '{"spec":{"resources":{"requests":{"storage":"5Gi"}}}}'

L'augmentation sera prise en compte Ă  la relance du serveur (pod)

Ajoutez une image personnalisée​

Vous pouvez ajouter une image à la liste des images fournies en modifiant le fichier YAML de déploiement JupyterHub.

singleuser:
 profileList:
   # ... other provided images
  - display_name: "My custom image (without GPU required)"
    description: "Description about my custom image"
    kubespawner_override:
      image: "registry.kosmos.athea/jupyter/my-custom-notebook:1.0.0"

  - display_name: "My custom image (with GPU required)"
    description: "Description about my custom image"
    kubespawner_override:
      image: "registry.kosmos.athea/jupyter/my-custom-notebook:1.0.0"
      extra_resource_guarantees:
        nvidia.com/gpu: 1
      extra_resource_limits:
        nvidia.com/gpu: 1