跳转到主要内容

云基础设施上QHub的管理

项目描述

Qhub logo on white background

信息 链接
项目 License QHUb documentation PyPI version
社区 GH discussions Open an issue
CI Kubernetes Tests Tests

目录

自动化数据科学平台。从 JupyterHub 到带有 Dask Gateway 的云环境。

QHub 是一个开源工具,它允许用户在 HPC 或在 Kubernetes 上,只需最少 DevOps 经验即可构建和维护成本效益高且可扩展的计算/数据科学平台。

此存储库详细说明了 QHub(Kubernetes)版本。

不确定该选择什么?请查看我们的 设置初始化 页面。

QHub HPC

基于 OpenHPC 的 QHub 版本。

注意:该工具目前正在开发中。好奇吗?请查看 Qhub HPC 存储库。

QHub

QHub 的 Kubernetes 版本使用 TerraformHelmGitHub Actions 构建。Terraform 处理基础设施的构建、更改和版本控制。Helm 帮助定义、安装和管理 Kubernetes。GitHub Actions 用于在配置文件(qhub-config.yaml)渲染时自动创建提交,以及启动部署操作。

QHub 的目标是为其用户抽象化所有这些复杂性。因此,您不必了解上述任何一种技术即可成功部署您的项目。

TLDR:如果您熟悉 GitHub 并且能够轻松生成和使用 API 密钥,那么您应该具备部署和维护系统所需的所有技能,无需专门的 DevOps 团队。无需学习 Kubernetes、Terraform 或 Helm。

:cloud: 云提供商

QHub 为 Digital Ocean、Amazon AWSGCP 和 Microsoft Azure 提供即插即用的支持。

High-level illustration of QHub architecture

有关更多详细信息,请查看发布 博客文章

:computer: 安装

先决条件

  • QHub 支持 macOS 和 Linux 操作系统(目前不支持 Windows)。
  • 兼容 Python 3.7+。Python 是新手?我们建议使用 Anaconda
  • 鼓励采用虚拟环境(condapipenvvenv)。

安装QHub

要安装 QHub,请在您的命令行中输入以下命令

  • 使用 conda 安装

    conda install -c conda-forge qhub
    
  • 使用 pip 安装

    pip install qhub
    

完成后,您可以通过输入以下内容来检查 QHub 的版本(以及额外的 CLI 参数)

qhub --help

如果成功,CLI 输出将类似于以下内容

usage: qhub [-h] [-v] {deploy,destroy,render,init,validate} ...

QHub command line

positional arguments:
  {deploy,destroy,render,init,validate}
                        QHub

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         QHub version

:label: 使用

QHub 需要设置环境变量以完全自动化部署。有关如何获取这些变量的详细信息,请参阅文档中的 安装指南

一旦收集到所有必要的凭据并将它们设置为 UNIX 环境变量,您就可以在不到 20 分钟内使用以下内容部署 QHub

qhub init   ... # generates initial config file and optionally automates deployment steps
qhub deploy ... # creates and configures the cloud infrastructure

:question: 有问题?

请查看我们的 常见问题解答,看看您的问题是否已得到解答。

我们将 QHub 的查询分为

  • GitHub Discussions 用于提出有关主题的讨论,例如:“使用 QHub 做 X 的推荐方法是什么?”

  • 问题 用于查询、错误报告、功能请求、文档等。

我们全天候努力使 QHub 更好,但有时您的问题可能需要一段时间才能得到回复。我们提前道歉,并请您耐心等待 :pray:。

:book: 行为准则

为确保社区友好和欢迎,我们要求贡献者遵守我们的行为准则

齿轮: 安装 QHub 的开发版本

要安装最新开发者版本(不稳定版),请使用

pip install git+https://github.com/Quansight/qhub.git@dev

握手: 贡献

考虑贡献?请查看我们的贡献指南

持续支持

v0.4.0版本引入了许多更改,如果您尝试就地升级,将不可避免地破坏您的部署;详细信息请参阅我们的版本说明。为了专注于项目的未来方向,我们团队决定将只提供对旧版本的有限支持。任何新用户都鼓励使用v0.4.0或更高版本。

如果您正在使用QHub的旧版本并且需要专业支持,请联系Quansight。

许可

QHub遵循BSD3许可证.

项目详情


下载文件

下载您平台对应的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

qhub-0.4.5.tar.gz (366.6 kB 查看哈希值)

上传于 源代码

构建发行版

qhub-0.4.5-py3-none-any.whl (407.9 kB 查看哈希值)

上传于 Python 3

由以下支持