Merge branch 'docs-jupyter-git' into 'master'
Add Jupyter git extension section See merge request gitlab-org/gitlab-ce!29078
This commit is contained in:
commit
6e33d5ea9f
4 changed files with 33 additions and 4 deletions
|
@ -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
|
||||||
[`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.
|
||||||
|
|
BIN
doc/user/clusters/img/jupyter-git-extension.gif
Normal file
BIN
doc/user/clusters/img/jupyter-git-extension.gif
Normal file
Binary file not shown.
After Width: | Height: | Size: 2 MiB |
BIN
doc/user/clusters/img/jupyter-gitclone.png
Normal file
BIN
doc/user/clusters/img/jupyter-gitclone.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 63 KiB |
|
@ -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)
|
||||||
|
|
Loading…
Reference in a new issue