Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update creating-a-new-kubeflow-notebook.md #131

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ To create a new Kubeflow notebook, you will need to provide a name, select a dev

## Notebook options

:::tipNamespaces
:::tip Namespaces
Always check on the top left corner of the KubeFlow Dashboard that you are creating resources in the correct namespace.
:::

Expand All @@ -30,7 +30,7 @@ For the notebook development environment, choose from the following options:

- **[RStudio](https://posit.co/products/open-source/rstudio/)**, the first party development IDE and ecosystem for the R language. If you’re someone who prefers R over Python, this is the choice for you!

:::tipCustom environments
:::tip Custom environments
If you can’t find what you’re looking for or are the type of person who brings their own IDE, you’re also welcome to pull a custom container. Please ensure they meet the Kubeflow container image requirements [listed here](https://www.kubeflow.org/docs/components/notebooks/container-images/#image-requirements).
:::

Expand All @@ -45,7 +45,7 @@ When creating a new notebook, you must specify the resources you want it to use

### GPUs

:::warningGPU support coming soon
:::warning GPU support coming soon
Please leave all GPU-related fields on the notebook setup page blank to prevent issues with your notebook server being created. Kubeflow will also warn you if you try to add a GPU.
:::

Expand All @@ -59,7 +59,7 @@ GPU support is under development and this documentation will be updated to refle

You can specify a workspace volume (new or existing) to be mounted as a PVC Volume on your home directory.

:::tipPersistent data volumes
:::tip Persistent data volumes
A StatefulSet assigns unique identifiers to each pod and allows you to easily store and track data in a persistent data volume. However, an important thing to remember is that this is a completely separate Kubernetes entity and has an independent lifecycle from the cluster's pods.

The persistent data volume is connected to a particular pod by a Persistent Volume Claim (PVC). These allow a user to consume abstract storage resources. In the case that you delete the notebook server, the data still persists in the persistent data volume assigned to that pod and if a new notebook server is created, it would be able to access the same data from the same persistent data volume.
Expand Down Expand Up @@ -100,4 +100,4 @@ Once your notebook server instance is running, you will be able to connect to it

## The Notebook ServiceAccount

When you create a new notebook Kubeflow by default assigns that Notebook pod the `default-editor` Kubernetes ServiceAccount. This is a highly privileged account and this also allows you to run `kubectl` inside the notebook server without providing additional authentication.
When you create a new notebook Kubeflow by default assigns that Notebook pod the `default-editor` Kubernetes ServiceAccount. This is a highly privileged account and this also allows you to run `kubectl` inside the notebook server without providing additional authentication.