piku

dokkuからインスピレーションを得たpiku使用すると、サーバーがどれほど小さいかに関係なく、独自のサーバーにgit pushデプロイメントを行うことができます。

デモ

ドキュメント: インストール | | を使用するプロファイル |環境 |例 |ロードマップ |貢献する | LinuxConf トーク |高速 Web アプリのチュートリアル |ディスカッションフォーラム

インストール

TL;DR:

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

また、 cloud-initや手動インストールなど、他のインストール方法も利用できます。

プロジェクト活動

piku STABLE とみなされます。これはアクティブに保守されていますが、ここでの「アクティブ」とは、機能セットがほぼ完成していることを意味するため、新しい言語ランタイムが追加されるか、再現可能なバグが発生した場合にのみ更新されます。

現在、Python 3.7 以降が必要です。Ubuntu LTS 20.04 では 3.8 以降がベースライン Python 3 バージョンであり、Debian 11 はすでに 3.9 に移行していますが、これらのバージョン間に大きな違いはありません。

モチベーション

私たちは、いくつかのARMボードに内容をデプロイするための Heroku/CloudFoundry のような方法を望んでいましたが、当時のARMではdokkuが機能せず、 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 の場合、Gem は分離されたフォルダーにbundle installされます。
• 次に、 Procfileを調べ、汎用プロセス マネージャーとしてuwsgi使用して関連するワーカーを開始します。
• オプションで、アプリのデプロイ時に 1 回実行されるreleaseワーカーを指定することもできます。
• その後、アプリケーション設定をリモートで変更したり ( config:set )、ワーカー プロセスをスケールアップ/スケールダウンしたり ( ps:scale ) したりできます。
• アプリケーションとnginx設定をENVファイルにベイクすることもできます。また、ルート パスを引数としてstaticワーカー タイプを使用してgh-pagesスタイルの静的サイトをデプロイし、 git pushの後にreleaseタスクを実行してサーバー上で何らかの処理を実行することもできます。

仮想ホストとSSL

piku仮想ホストを完全にサポートしています。つまり、同じ VPS 上で複数のアプリをホストし、DNS エイリアスを使用して異なるホスト名でそれらのアプリにアクセスできます。

また、 pikuプライベート証明書をセットアップするか、Let's Encrypt 経由で証明書を取得して SSL を有効にします。

LAN 上にいて、macOS/iOS/Linux クライアントからpikuにアクセスしている場合は、 piku/avahi-aliases使用して、Avahi/mDNS/Bonjour 経由で同じ IP アドレスの異なるホストをアナウンスしてみることができます。

キャッシュと静的パス

静的サイトに加えて、 piku特定の URL プレフィックスをファイルシステム パスに直接マッピングする (静的アセットを提供するため) か、バックエンド応答をキャッシュする (アプリケーションから負荷を取り除くため) こともサポートしています。

これらの機能は、 ENVファイルに適切な値を設定することによって構成されます。

サポートされているプラ​​ットフォーム

piku 、Python、 nginx 、 uwsgi 、SSH が存在する POSIX に似た環境で動作することを目的としており、Linux、FreeBSD、Cygwin、および Linux 用 Windows サブシステムにデプロイされています。

ベースラインとして、オリジナルの 256MB Raspberry Pi Model B で開発が開始され、現在でもその上で確実に動作しています。

しかし、その主な用途は、Debian と Ubuntu Linux をターゲット プラットフォームとして、Intel と ARM CPU の両方を搭載したクラウド サーバー上でアプリケーションを実行するためのマイクロ PaaS としてです。

サポートされているランタイム

piku現在、Python、Node、Clojure、Java、および開発中の他のいくつかの言語 (Go など) で書かれたアプリをサポートしています。

ただし、一般的なルールとして、シェルから呼び出すことができる場合は、 piku内で実行できます。

コアバリュー

• ローエンドのデバイスで実行します。
• 愛好家や幼稚園から高校までの学校が利用できます。
• ~1500 行の読み取り可能なコード。
• 関数コードのスタイル。
• 依存関係が少ない (単一?)
• 12ファクターアプリ。
• ユーザーエクスペリエンスを簡素化します。
• 一般的なユースケースの 80% をカバーします。
• すべての機能の適切なデフォルト。
• Raspbian/Debian/Ubuntu のディストリビューション パッケージを活用します (Alpine および RHEL のサポートは WIP です)
• 標準ツール ( git 、 ssh 、 uwsgi 、 nginx ) を活用します。
• 可能な限り下位互換性を維持する