piku

piku，受dokku启发而生,允许您将应用程序通过git push部署到自己的服务器,无论服务器有多小。

演示

文档: 安装 | 使用 | Procfile | ENV | 示例 | 路线图 | 贡献 | LinuxConf 演讲 | 快速 Web 应用程序教程 | 讨论论坛

安装

TL;DR:

curl https://piku.github.io/get | sh

还有其他安装方法,包括 cloud-init 和 手动安装。

项目活动

piku 被视为稳定。它正在积极维护,但"积极"在此意味着功能集已基本完成,因此只有在添加新的语言运行时或出现可重现的错误时才会更新。

它当前需要 Python 3.7 或更高版本,因为即使 3.8+ 现在是 Ubuntu LTS 20.04 和 Debian 11 中的 Python 3 的基准版本,但这些版本之间没有实质性的差异。

动机

我们希望拥有一种类似于 Heroku/CloudFoundry 的方式来部署一些 ARM 主板上的东西,但由于 dokku 当时不适用于 ARM, 即使 docker 有时也可能过于复杂,因此需要一个更简单的解决方案。

piku 目前能够在 ARM 和 Intel 架构上独立部署、管理和扩展多个应用程序,并在任何可以运行 Python、nginx 和 uwsgi 的云提供商(以及裸机)上工作。

工作流程

piku 支持类似于 Heroku 的工作流程:

• 创建一个指向您的 piku 服务器的 git SSH 远程,以应用程序名称作为仓库名称: git remote add piku piku@yourserver:appname。
• 推送您的代码: git push piku master(或者如果您想推送一个不同于当前分支的分支,请使用 git push piku release-branch-name)。
• piku 确定运行时并为您的应用程序安装依赖项(构建所需的任何内容)。
  • 对于 Python,它会将每个应用程序的依赖项隔离到一个 virtualenv 中。
  • 对于 Go,它为每个应用程序定义一个单独的 GOPATH。
  • 对于 Node,它会将 package.json 中的内容安装到 node_modules。
  • 对于 Java,它会根据 pom.xml 或 build.gradle 文件来构建您的应用程序。
  • 对于 Clojure,它可以使用 leiningen 或 Clojure CLI 和 deps.edn 文件。
  • 对于 Ruby,它会在一个隔离的文件夹中执行 bundle install 来安装您的 gems。
• 然后它会查看 Procfile 并使用 uwsgi 作为通用进程管理器启动相关的工作进程。
• 您还可以选择指定一个 release 工作进程,该工作进程在应用程序部署时运行一次。
• 您可以远程更改应用程序设置(config:set)或扩展/缩减工作进程(ps:scale)。
• 您还可以将应用程序和 nginx 设置纳入 ENV 文件。 您还可以使用 static 工作类型和根路径作为参数来部署一个 gh-pages 风格的静态站点,并在 git push 后运行一个 release 任务来对服务器进行一些处理。

虚拟主机和 SSL

piku 拥有完整的虚拟主机支持,也就是说,您可以在同一台 VPS 上托管多个应用程序,并使用 DNS 别名通过不同的主机名访问它们。

piku 还会设置私有证书或通过 Let's Encrypt 获取证书来启用 SSL。

如果您在局域网上,并且从 macOS/iOS/Linux 客户端访问 piku,您可以尝试使用 piku/avahi-aliases 通过 Avahi/mDNS/Bonjour 为同一 IP 地址公布不同的主机。

缓存和静态路径

除了静态站点,piku 还支持直接将特定的 URL 前缀映射到文件系统路径(用于提供静态资产)或缓存后端响应(以减轻应用程序的负载)。

这些特性是通过在 ENV 文件中设置适当的值来配置的。

支持的平台

piku 旨在在任何有 Python、nginx、uwsgi 和 SSH 的 POSIX 类环境中工作:它已经在 Linux、FreeBSD、Cygwin 和 Windows 子系统 for Linux 上部署过。

作为一个基准,它是从一台 256MB 树莓派 Model B 开始开发的,并且仍然可以可靠地运行在上面。

但它的主要用途是作为一个微型 PaaS,在具有 Intel 和 ARM CPU 的云服务器上运行应用程序,以 Debian 和 Ubuntu Linux 作为目标平台。

支持的运行时

piku 目前支持用 Python、Node、Clojure、Java 等语言编写的应用程序(Go 等其他一些语言也在开发中)。

但一般来说,只要可以从 shell 调用,就可以在 piku 中运行。

核心价值观

• 在低端设备上运行。
• 对业余爱好者和 K-12 学校可访问。
• ~1500 行可读代码。
• 函数式编程风格。
• 少量(单个?)依赖项
• 12 因素应用。
• 简化用户体验。
• 覆盖 80% 的常见用例。
• 为所有功能提供合理的默认值。
• 在 Raspbian/Debian/Ubuntu 中利用发行版软件包(对 Alpine 和 RHEL 的支持正在进行中)
• 利用标准工具(git、ssh、uwsgi、nginx)。
• 尽可能保持向后兼容性