Skip to main content

Easily create a Saagie Python job from a Jupyter notebook

Project description

This plugin allows you to easily create a Saagie Python job from a local Jupyter notebook.

Install

In your Jupyter Python environment, run: pip install jupyter-saagie-plugin

Usage

Simply run jupyter notebook as always, you will see a new button in the toolbar. Use it to log in to your account and deploy a job using the code in your notebook. You can update an existing job as well.

For deploying to a Python job, Python 3.5 & 2.7 are supported.

If you want to pre-fill your Saagie root URL (used in the plugin’s login form), you can setup a SAAGIE_ROOT_URL environment variable before you run the notebook.

Uninstall

pip uninstall jupyter-saagie-plugin
jupyter nbextension uninstall saagie --user

Modifying this extension

In dev mode, you can use a Docker of Jupyter notebook and install this extension in it. First, run a Jupyter Docker in bash mode:

docker run -it --rm -p 8888:8888 --user root -e GRANT_SUDO=yes -v [your_project_path]/jupyter-saagie-plugin/:/jupyter-saagie-plugin/ [--env SAAGIE_ROOT_URL="https://xxx-manager.prod.saagie.io/"] saagie/jupyter-python-nbk:latest /bin/bash

(Seting up the ``SAAGIE_ROOT_URL`` environment variable is optional)

Then install the Jupyter extension in your Docker container:

cd /jupyter-saagie-plugin/
python3 setup.py install
cd /notebooks-dir
/usr/local/bin/start-notebook.sh --NotebookApp.token='' --NotebookApp.password=''

Build and share

In order to build this plugin, run the following command:

python setup.py sdist

This will generate a tar.gz archive in the dist directory.

If you want to share it on Pypi, just install twine (with pip install twine) and run:

twine upload dist/jupyter-saagie-plugin-x.x.x.tar.gz

But first, You can test your Pypi deployment on TestPypi test environment. If so, just run:

twine upload --repository-url https://test.pypi.org/legacy/ dist/jupyter-saagie-plugin-x.x.x.tar.gz

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
jupyter-saagie-plugin-1.0.6.tar.gz (34.1 kB) Copy SHA256 hash SHA256 Source None Mar 1, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page