Ubuntu 20.04、Python 3.10以及对Node、Rust和Go的支持

我们很高兴地宣布,现在Read the Docs用户可以在其项目中使用较新的生成规范这会将基本图像更改为基于Ubuntu 20.04的图像,发布最新发布的Python 3.10,并允许用户轻松指定Node.js、Rust和Go的版本。这个功能已经制作了很长时间,我们认为这将简化许多项目的配置。

以前的情况

我们的构建者使用的Docker图像基于Ubuntu 18.04。最近,我们为添加了一个新功能安装自定义系统包,这使得许多项目能够更好地控制其构建过程无需使用conda来管理非Python依赖项。

然而,这个Ubuntu版本是三年前发布的,尽管它对大多数项目来说已经足够好了,多年来,我们一直收到升级某些系统包的请求。由于这些是通过操作系统包管理器进行管理的,并且我们不提供添加自定义个人包档案的方法,这样的升级是不可能的。

许多Python项目使用辅助编程语言由于各种原因。建立编译语言,如C、C++和FORTRAN拥有适用于大多数用例的现成编译器。然而,其他较年轻的技术发展速度更快,开发人员通常需要特定版本的工具链无法与系统包管理器一起安装的。这影响了结合后端和前端代码的项目需要Node.js来编译JavaScript源代码,例如Jupyter扩展,以及使用Rust或Go编写的性能关键型代码的库。

我们经常建议指定非Python依赖项的自定义版本使用conda,要指定非Python依赖项的自定义版本,但这需要学习另一种对某些项目可能不熟悉的工具。

新建建造YAML配置

为了克服所有这些问题,我们添加了一个新的配置值,内置工具接收工具链版本字典的。此新配置要求指定基本映像名称在里面内置.os,当前ubuntu-20.04.我们的配置文档包含一个简单的示例:

版本: 2

#设置您可能需要的Python和其他工具的版本
建造:
  操作系统: ubuntu-20.04
  工具:
    蟒蛇: "3.9"
    #还可以指定其他工具版本:
    #节点数:“16”
    #锈蚀:“1.55”
    #戈兰:“1.17”

你可以从一些社区项目中获得灵感已经在使用此功能的:

你认为这个功能对你也有用吗?试试看,让我们知道。

请记住,您可以在我们的阅读文档变更日志.

-

考虑在您的下一个狮身人面像或MkDocs项目中使用Read the Docs?结账我们的文档开始吧!