Commit 6e33d5ea authored by Evan Read's avatar Evan Read

Merge branch 'docs-jupyter-git' into 'master'

Add Jupyter git extension section

See merge request gitlab-org/gitlab-ce!29078
parents dd0d9b27 8e2bb09a
...@@ -140,8 +140,8 @@ that installs additional useful packages on top of the base Jupyter. You ...@@ -140,8 +140,8 @@ that installs additional useful packages on top of the base Jupyter. You
will also see ready-to-use DevOps Runbooks built with Nurtch's [Rubix library](https://github.com/amit1rrr/rubix). will also see ready-to-use DevOps Runbooks built with Nurtch's [Rubix library](https://github.com/amit1rrr/rubix).
More information on More information on
creating executable runbooks can be found in [our Nurtch creating executable runbooks can be found in [our Runbooks
documentation](../project/clusters/runbooks/index.md#nurtch-executable-runbooks). Note that documentation](../project/clusters/runbooks/index.md#executable-runbooks). Note that
Ingress must be installed and have an IP address assigned before Ingress must be installed and have an IP address assigned before
JupyterHub can be installed. JupyterHub can be installed.
...@@ -152,6 +152,33 @@ chart is used to install this application with a ...@@ -152,6 +152,33 @@ chart is used to install this application with a
[`values.yaml`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/vendor/jupyter/values.yaml) [`values.yaml`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/vendor/jupyter/values.yaml)
file. file.
#### Jupyter Git Integration
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/28783) in GitLab 12 for project-level clusters.
When installing JupyterHub onto your Kubernetes cluster, [JupyterLab's Git extension](https://github.com/jupyterlab/jupyterlab-git)
is automatically provisioned and configured using the authenticated user's:
- Name
- Email
- Newly created access token
JupyterLab's Git extension enables full version control of your notebooks as well as issuance of Git commands within Jupyter.
Git commands can be issued via the **Git** tab on the left panel or via Jupyter's command line prompt.
NOTE: **Note:**
JupyterLab's Git extension stores the user token in the JupyterHub DB in encrypted format
and in the single user Jupyter instance as plain text. This is because [Git requires storing
credentials as plain text](https://git-scm.com/docs/git-credential-store). Potentially, if
a nefarious user finds a way to read from the file system in the single user Jupyter instance
they could retrieve the token.
![Jupyter's Git Extension](img/jupyter-git-extension.gif)
You can clone repositories from the files tab in Jupyter:
![Jupyter clone repository](img/jupyter-gitclone.png)
### Knative ### Knative
> Available for project-level clusters since GitLab 11.5. > Available for project-level clusters since GitLab 11.5.
......
...@@ -17,13 +17,15 @@ Modern implementations have introduced the concept of an "executable ...@@ -17,13 +17,15 @@ Modern implementations have introduced the concept of an "executable
runbooks", where, along with a well-defined process, operators can execute runbooks", where, along with a well-defined process, operators can execute
pre-written code blocks or database queries against a given environment. pre-written code blocks or database queries against a given environment.
## Nurtch Executable Runbooks ## Executable Runbooks
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/45912) in GitLab 11.4. > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/45912) in GitLab 11.4.
The JupyterHub app offered via GitLab’s Kubernetes integration now ships The JupyterHub app offered via GitLab’s Kubernetes integration now ships
with Nurtch’s Rubix library, providing a simple way to create DevOps with Nurtch’s Rubix library, providing a simple way to create DevOps
runbooks. A sample runbook is provided, showcasing common operations. runbooks. A sample runbook is provided, showcasing common operations. While Rubix makes it
simple to create common Kubernetes and AWS workflows, you can also create them manually without
Rubix.
**<i class="fa fa-youtube-play youtube" aria-hidden="true"></i> **<i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
Watch this [video](https://www.youtube.com/watch?v=Q_OqHIIUPjE) Watch this [video](https://www.youtube.com/watch?v=Q_OqHIIUPjE)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment