Polynote项目安装与配置完全指南

Polynote项目安装与配置完全指南

polynote A better notebook for Scala (and more) 项目地址: https://gitcode.com/gh_mirrors/po/polynote

前言：安全注意事项

在开始安装Polynote之前，必须了解其潜在的安全注意事项。Polynote作为一款笔记本工具，允许代码执行，这意味着：

1. 浏览网页时运行Polynote可能存在安全注意事项，某些网站可能利用Polynote作为访问媒介
2. 在可被互联网访问的计算机上运行Polynote需要特别注意
3. 即使在容器中运行Polynote也不能完全保证安全，可能存在权限提升或容器逃逸问题

建议用户：

• 定期检查更新，及时修复安全问题
• 在企业环境中使用前，务必咨询技术团队
• 自行承担因不安全配置导致的任何风险

系统兼容性说明

Polynote目前主要在以下环境中测试通过：

• 操作系统：Linux和MacOS
• 浏览器：Chrome

其他环境情况：

• Firefox：虽然未经全面测试，但团队欢迎用户反馈问题
• Windows：可通过WSL(Windows Subsystem for Linux)运行，原生Windows不支持

安装前准备

Java环境要求

Polynote支持以下Java版本：

• Java 8
• Java 11

Spark支持配置

Polynote支持以下Spark版本：

• Spark 2.1（需搭配Scala 2.11）
• Spark 2.4（支持Scala 2.11和2.12）
• Spark 3.0（部分用户报告可在Scala 2.12下运行）

关键要求：

• spark-submit命令必须可用且配置正确
• 相关环境变量必须正确设置

Spark安装示例

Mac系统安装步骤：

1. 安装Java 8（推荐使用SDKMAN）
2. 下载并解压Spark二进制包
3. 设置环境变量：

   export SPARK_HOME=/path/to/spark
   export PATH=$PATH:$SPARK_HOME/bin:$SPARK_HOME/sbin
   

Linux系统安装步骤：

1. 更新软件包列表
2. 安装默认JDK
3. 下载并解压Spark
4. 设置环境变量：

   export JAVA_HOME=/usr/lib/jvm/default-java/
   export SPARK_HOME=/path/to/spark
   export PATH=$PATH:$SPARK_HOME/bin:$SPARK_HOME/sbin
   

Mac用户特别提示： 可通过Homebrew安装特定版本Spark，但需注意版本兼容性。

Python环境要求

Polynote需要：

• Python 3.7（官方推荐版本）
• 支持Python 3.6和3.8（部分功能可能受限）

安装Python依赖：

pip install -r ./requirements.txt

安装步骤

1. 下载最新版本的Polynote发布包
2. 解压文件：

   tar -zxvpf polynote-dist.tar.gz
   cd polynote
   

配置说明

初次使用时，默认配置即可满足本地运行需求。如需自定义配置，可参考以下方面：

• 网络端口设置
• 安全配置
• 存储路径配置
• 内核配置

（详细配置选项请参考官方配置文档）

启动与使用

1. 启动服务：

   ./polynote.py
   

2. 在浏览器中访问：

   http://localhost:8192
   

Docker运行方案

对于希望快速体验的用户，推荐使用Docker方式运行Polynote。这种方式：

• 避免了复杂的本地环境配置
• 提供了隔离的运行环境
• 可能需要额外配置网络以访问远程Spark集群

（具体Docker配置方法请参考相关文档）

常见问题排查

1. Spark无法启动：

   • 检查spark-submit是否在PATH中
   • 验证环境变量设置是否正确
   • 确认Spark版本兼容性

2. Python支持问题：

   • 确保使用Python 3.7
   • 检查所有依赖是否安装完成

3. 浏览器兼容性问题：

   • 优先使用Chrome浏览器
   • Firefox用户遇到问题可提供反馈

最佳实践建议

1. 开发环境：

   • 使用隔离的Python虚拟环境
   • 为不同项目配置不同的Spark版本

2. 生产环境：

   • 严格限制网络访问
   • 定期备份重要笔记本
   • 实施适当的访问控制

3. 性能优化：

   • 根据硬件配置调整JVM参数
   • 合理设置Spark资源配置

通过以上步骤，您应该能够成功安装并运行Polynote。如在安装过程中遇到任何问题，建议查阅详细的错误日志并参考社区讨论。

polynote A better notebook for Scala (and more) 项目地址: https://gitcode.com/gh_mirrors/po/polynote