Como publicar o Jupyter Notebook na Zenifra
O Jupyter Notebook pode ser publicado na Zenifra como um projeto HTTP a partir da imagem oficial. Este guia mostra a configuração recomendada, as variáveis necessárias e como validar o resultado.
Pré-requisitos
- Conta verificada e acesso ao console.
- Permissão para criar projetos na organização (
project.create). - Crédito ou cartão cadastrado para o plano escolhido; veja Modelos de pagamento.
Opção rápida: template
O Jupyter Notebook está no catálogo público de Templates. Use Implantar para criar a aplicação com a configuração recomendada, ou Personalizar para revisar plano, armazenamento e variáveis antes de confirmar. Os passos abaixo mostram uma configuração manual a partir da imagem oficial.
Passo 1: criar o projeto HTTP
No console, clique em + Criar Projeto, escolha HTTP e preencha:
| Campo | Valor |
|---|---|
| Origem do projeto | Imagem Docker |
| Imagem | quay.io/jupyter/scipy-notebook:2025-03-14 |
| Registry | Público, sem autenticação |
| Plano | Basic é suficiente para testes e notebooks leves. Para processamento pesado, escolha um plano maior e confira no console se há opções com GPU. |
| Porta | 8888 |
| Instâncias | 1. O Jupyter não distribui sessões entre instâncias. |
| Armazenamento persistente | Sim, 5 GB, diretório /home/jovyan/work |
Escolha um nome entre 6 e 32 caracteres, com letras minúsculas, números e hífens; ele também define o endereço *.clients.zenifra.com. Para testes, o modelo por hora é o mais barato; para uso contínuo, compare com o mensal.
Armazenamento
Recomendado se você quer manter notebooks e arquivos entre reinícios. Salve os notebooks dentro de work.
Passo 2: configurar variáveis de ambiente
Cadastre as variáveis abaixo no passo Variáveis de ambiente:
JUPYTER_TOKEN=<token-longo-e-aleatorio>O token funciona como senha de acesso. Use um valor longo e aleatório: qualquer pessoa com o token executa código no seu projeto. Veja Variáveis de ambiente.
Passo 3: criar e validar
Revise o custo estimado e clique em Criar Projeto. Ao final, o console abre a página do projeto com o endereço público.
Abra a URL do projeto, informe o token e crie um notebook dentro da pasta work. Execute uma célula simples, como import pandas; pandas.__version__.
Se a aplicação não responder, confira os logs do projeto, a porta configurada e o guia de solução de problemas.
Recomendações para produção
- Restrinja o acesso por IP com controle de acesso quando o plano permitir.
- Use o modelo por hora e pause o projeto quando não estiver em uso.
- Guarde credenciais de bancos em variáveis de ambiente, nunca dentro dos notebooks.
Para remover o projeto, abra-o em Projetos e clique em Excluir. A exclusão é permanente e apaga o armazenamento.
Próximos passos
Última atualização em