fly-atc 0.0.8-x86_64-linux → 0.1.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92c7c265599b137b6b6a50b8994f4263d22f9d0a35f6711881492e1a42661fb4
-  data.tar.gz: 216946eb1e2643d7b50f70f5097ec4343bad9ac3c0579014ffaeadb11ad24b74
+  metadata.gz: f1ccd9a81da62e5fb58e7e97fd1a48e4685ee257d6e6d7ad899bbf6d21ccc6f9
+  data.tar.gz: ba6d2e0732265c2758444f9b16bc4afc140e4865f5fc953c2f3e1b087a46c195
 SHA512:
-  metadata.gz: 4abd272ce7389d948b0b6e28b01334099951ea76e9c14f25d888e2daa4a6068810cc8ef5bc41e8e365caf903f42cb6e30990cee5270ba9769966afb38e706cb5
-  data.tar.gz: df5f12fc4d970890f39f16e79dd8b0725e8ad3a06576bba6e604163c6d2f89053aa5ecbdc2bbb9a1ce9c0ba4580f25bc417eeac9504ee6b0cfd67ca8503601b4
+  metadata.gz: f0f46fe44b23b2f189d2842e9dc4c69c60196c5e290f2345ccad0922a047b6c69b5a42cbe39f1afffbd0d8b106a2c9ee28a28b27a451313382e037ec847fefe3
+  data.tar.gz: 2f31738ab78eada42fef5a7eda7ae5174bd0e93f6f8801be1d63d38cdaee8a53993787acae852e58e0057f78a07d9e0f6162ce2891fed304169ec3ad2a0cd44d

data/README.md

@@ -2,7 +2,9 @@
 
 A SaaS toolkit for converting a personal application into a efficient, siloed, multi-tenant application, where each user of your application is assigned a dedicated virtual machine.
 
-** Work in Progress **
+*** **Work in Progress** ***
+
+Do not use in production just yet.
 
 ## Usage
 
@@ -24,79 +26,13 @@ bin/rails generate atc
 
 Edit `config/atc.yml` as needed.
 
-For approximately $1 US per month, you can run:
-  * [1 performance machine with 2Gb of RAM, 10GB of bandwidth, and 5GB of storage for 15 hours/month](https://fly.io/calculator?m=0_0_0_0_0&f=c&b=iad.10&a=no_none&r=shared_0_1_iad&t=10_100_5&u=0_1_100&g=1_performance_15_1_2048_iad_1024_0).
-  * [1 shared machine with 1Gb of RAM, 10GB of bandwidth, and 5GB of storage for 80 hours/month](https://fly.io/calculator?m=0_0_0_0_0&f=c&b=iad.10&a=no_none&r=shared_0_1_iad&t=10_100_5&u=0_1_100&g=1_shared_80_1_1048_iad_1024_0).
-
 Vertical scaling can be achieved by adding more machines.
 
-## Motivation
-
-I've been running my [Showcase](https://github.com/rubys/showcase?tab=readme-ov-file#showcase) software for nearly three years.  Things have changed over time that I now want to take advantage of.  I want take the opportunity to package those changes in the form of a toolkit that others can take advantage of.
-
-From Wikipedia description of [SaaS](https://en.wikipedia.org/wiki/Software_as_a_service):
-
-> SaaS customers have the abstraction of limitless computing resources, while [economy of scale](https://en.wikipedia.org/wiki/Economy_of_scale) drives down the cost. SaaS architectures are typically [multi-tenant](https://en.wikipedia.org/wiki/Multi-tenant); usually they share resources between clients for efficiency, but sometimes they offer a siloed environment for an additional fee.
-
-The focus of this toolkit is efficient, siloed, multi-tenant applications *with no changes to the application*, taking advantage of:
-
-* [Auto-suspend](https://community.fly.io/t/autosuspend-is-here-machine-suspension-is-enabled-everywhere/20942) -  Virtual Machines that pop into existence when needed and disappear when not in use.
-* [SQLite ready for production](https://rubyonrails.org/2024/11/7/rails-8-no-paas-required#getting-sqlite-ready-for-production) - raw performance coupled with operational compression of complexity; see [Supercharge the One Person Framework with SQLite: Rails World 2024](https://fractaledmind.github.io/2024/10/16/sqlite-supercharges-rails/).
-* [Litestream](https://litestream.io/) -  No-worry backups.  Virtual machines can be literally destroyed and recreated elsewhere and start back up exactly where they left off.
-* [Tigris Global Storage](https://fly.io/docs/tigris/) - globally caching, S3-compatible object storage.
-
-That's a lot of moving parts.  I've documented my [current architecture](https://github.com/rubys/showcase/blob/main/ARCHITECTURE.md) and published a [blueprint](https://fly.io/docs/blueprints/shared-nothing/).
-
-The goal of fly-atc is to enable you configure multiple tenants and then not worry about this further, enabling you to focus on your application.
-
-## Approach
-
-For illustrative purposes consider a SaaS Calender application implemented in Ruby on Rails using SQLite3 as the database.  (My showcase application is a bit more involved than a calendar, but those details aren't important).
-
-Key concepts:
-
-* Each user/customer has a primarly location, and is assigned a single machine near that location.  Such machines can be accessed from anywhere, but have lower latency near that location.
-* Each user can have multiple calendars.  Each calendar is associated with a single tenant on the user's machine.  Each tenant consists a running instance of the web server application with one ([or more](https://rubyonrails.org/2024/11/7/rails-8-no-paas-required#a-solid-reduction-of-dependencies)) databases.
-
-With that in mind, consider the following URL paths:
-
-* `/bellevue/2025/winter/`
-* `/bellevue/2025/summer-medal-ball/`
-* `/bellevue/2025/summer-showcase/`
-* `/boston/2025/april/`
-* `/boston/2025/mini-comp/`
-* `/boston/2025/october/`
-* `/livermore/2025/the-music-of-prince/`
-* `/livermore/2025/james-bond/`
-* `/raleigh/2025/disney/`
-* `/raleigh/2025/in-house/`
-
-The first segment of the path identifies the user, and therefore the machine.  The next two segments combined identify the tenant on that machine.  This is but a subset of the planned showcases, you can see a [full list](https://smooth.fly.dev/showcase/) or even a [map](https://smooth.fly.dev/showcase/regions/) (click on the arrows under the map to move to different continents).
-
-`fly-atc`'s responsibilities are to:
-* Route requests to the correct machine
-* Ensure databases are present/restored from backup
-* Start/stop tenants as required
-* Hand off requests to tenants
-
-Rails 8 introduces [thruster](https://rubyonrails.org/2024/11/7/rails-8-no-paas-required#enter-kamal-2--thruster).  `fly-atc` is a replacement for thruster:
-  * thruster requires no configuration, is limited to a single tenant.
-  * fly-atc enables multiple tenants, based on your configuration.
-
-## Implementation
-
-Based on:
-* [Thruster](https://github.com/basecamp/thruster) ([announcement](https://dev.37signals.com/thruster-released/))
-* [tinyrp](https://github.com/pgaijin66/tinyrp) ([docs](https://prabeshthapa.medium.com/learn-reverse-proxy-by-creating-one-yourself-using-go-87be2a29d1e))
-
-Near term plans:
-
-* Remove certificate/https support
-* Add launch on request / shutdown on idle
-* Add [fly-replay](https://fly.io/docs/networking/dynamic-request-routing/)
-
-On the radar:
+## More information:
 
-* Support for targets other than fly.io.
-* Support for platforms other than Rails, likely starting with Node, and focusing on popular ORMs: [Prisma](https://www.prisma.io/), [TypeORM](https://typeorm.io/), and [Sequelize](https://sequelize.org/).
-* Dashboard.  One should be able to deploy new users and make other configuration changes using only your cell phone.  I [do this today](https://github.com/rubys/showcase/blob/main/ARCHITECTURE.md#administration) with my showcase application.
+ * [Overview](./docs/overview.md) - why this toolkit was created.
+ * [Demo](./docs/demo.md) - up and running in minutes.
+ * [Config](./docs/config.md) - configuration options
+ * [Iaas vs PaaS vs SaaS](./docs/paas.md) - Rails never needed a PaaS; Rails needs a PaaS now more than ever.
+ * [SQlite3](./docs/sqlite3.md) - perhaps Sqlite3 isn't right for you.
+ * [Todos](./docs/todos.md) - where we go from here.

data/lib/fly-atc/version.rb

@@ -1,3 +1,3 @@
 module FlyAtc
-  VERSION = "0.0.8"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fly-atc
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.1.0
 platform: x86_64-linux
 authors:
 - Sam Ruby
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-29 00:00:00.000000000 Z
+date: 2024-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails