fly-atc 0.0.8-x86_64-darwin → 0.1.0-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2987ad87a06d0de1a8849f1f61dd8bb4bbefae893d5eb9d54a89dd83b1486ea
-  data.tar.gz: f3c0ae8ed4da0487adaf0527c8074ab340e8d05060dbcf7eaf9be2d75a85bd01
+  metadata.gz: bd8823145ba563360f9cc1fac635024beff602a710c5011bf1f5a6197737973b
+  data.tar.gz: 1773340329b4de8961f1dbf003e01e278abd1be78897e0426a452155e10d1530
 SHA512:
-  metadata.gz: 7522a5fd98a0d23836330bc13bd6fd1d1a18a45181b8ae77043d92fec2e082bffbe1722e55d68506b009c3b9f50c622954bda89705c15a71740e5c0b110f80d9
-  data.tar.gz: 87e239909efffb9546ec5720d3ec3d62c797e77d58c3d30dbe204d010cb258baa3c114512e0d94b582615cad52d5b07f08a2b9978cc99e8cd7ba350492e67783
+  metadata.gz: 848656baa452dc6a94d63e4b56bf4c27a85654172193fb79c66b5bedac64331c7c63ebc7bbe08cfe932d0fccf73f00ba1eb3e8ef77f11346a658f199c083ad4f
+  data.tar.gz: e26b80bde7d8b212cbc5a1f353f4a2afd445177e34ab4aad721b49796e945729ffb00a01ac6ef48ef0c0ebde0e97a3fbae3d19d679633d0b7aebca53c74ebdd3

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-darwin
 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