jhub apps

Iniciador de aplicativos JupyterHub

JupyterHub Apps Launcher é um inicializador de servidor generalizado. O objetivo deste projeto é oferecer suporte ao lançamento de qualquer coisa como, digamos, um servidor Flask, servidor FastAPI ou um painel de controle por meio de um comando fornecido pelo usuário. Atualmente, as seguintes estruturas são suportadas:

• Painel
• Bokeh
• Streamlit
• Traço plotado
• Voilá
• Gradio
• Laboratório Jupyter
• Comando Python genérico

Instalação

 pip install jhub-apps

ou via conda

conda install -c conda-forge jhub-apps

Instalação de desenvolvimento

Instalar dependências

conda env create -f environment-dev.yml
conda activate jhub-apps-dev
pip install -e .

Para desenvolver o frontend React UI, execute também:

 cd ui
npm install
cd -

Iniciando o JupyterHub

Defina a seguinte variável de ambiente:

 export JHUB_APP_JWT_SECRET_KEY= $( openssl rand -hex 32 )

Inicie o JupyterHub:

jupyterhub -f jupyterhub_config.py

Agora vá para http://127.0.0.1:8000/hub/home para acessar o JHub Apps Launcher

Terminais de API

O serviço Hub é exposto por meio de endpoints FastAPI. A documentação do mesmo pode ser acessada em: http://127.0.0.1:10202/services/japps/docs

Para testar endpoints autenticados, clique no botão Autorizar no canto superior direito do URL acima e escolha OAuth2AuthorizationCodeBearer e clique em Autorizar.

Desenvolvendo Localmente

Observação: para desenvolver localmente, tanto o back-end do JupyterHub quanto o front-end do React UI devem estar em execução.

1. Para iniciar o back-end do JupyterHub, execute o seguinte em um terminal:

jupyterhub -f jupyterhub_config.py

2. Para iniciar o frontend React UI, execute o seguinte em um terminal separado do diretório ui :

npm run watch

Executando testes

Testes unitários

pytest jhub_apps/tests

Testes E2E

pytest jhub_apps/tests/tests_e2e -vvv -s --headed

Uso

JHub Apps foi testado com JupyterHub local usando SimpleLocalProcessSpawner e com The Littlest JupyterHub usando SystemdSpawner .

• Instale aplicativos JHub

 pip install git + https : // github . com / nebari - dev / jhub - apps . git

• Adicione o seguinte em jupyterhub_config.py do The Littlest JupyterHub

 from tljh . user_creating_spawner import UserCreatingSpawner
from jhub_apps . configuration import install_jhub_apps

c . JupyterHub . bind_url = "<YOUR_JUPYTERHUB_URL>"
c . SystemdSpawner . unit_name_template = 'jupyter-{USERNAME}{JHUBSERVERNAME}'
c . JAppsConfig . apps_auth_type = "oauth" # or none (if you don't want authentication on apps)
c . JAppsConfig . python_exec = "python3"
# Pass in the path to jupyterhub config
c . JAppsConfig . jupyterhub_config_path = "jupyterhub_config.py"
# Either a static list of conda environments to show in the
# create panel apps form or a callable to fetch conda enviornments
# dynamically, e.g. from conda-store API
c . JAppsConfig . conda_envs = []
c = install_jhub_apps ( c , UserCreatingSpawner )