fly-atc 0.0.8-aarch64-linux → 0.1.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab93d628279892241631af3055cc6df6d5b9d9a0877f45d1ace04f3e85bc75d5
-  data.tar.gz: f563e17400220d6f8424b58435432398062a58a3465773594325ea207f9c3fca
+  metadata.gz: 4813dfbfe74117324c8b7c6a71d18e46695d2e1192822799d411a3c476602ab1
+  data.tar.gz: 6538664f35cf29e6f49225ab96fbdec1146314e9ed8a33673590fcec5fe1f618
 SHA512:
-  metadata.gz: b8c1f1f52b031feaaa23fb60a1b584eda723981ef5890813900fbbac1bee457e0f2c3f61f07dd58b5df617103f66f2eac3660ced7246be8bcdffdb5fce13e210
-  data.tar.gz: 5bb8c4e255ce92865661300a21e833cd2504ec0cc2b0352134f3064ea07b208acda020fe231730587ee6bac18dd3132eec63b41357fcf89d7dfa5afbc297a199
+  metadata.gz: b07d7963fe13b9b4bc39785a397a92ecc7b7c999d90ca6808d88eceef9d1e6f18fddd21f32921380c1216c4375829fee51c6ae94dd1c28ec8dd4de929a1c2d9e
+  data.tar.gz: b4b709fec938ec7c08380220fc18b27d8771bd72557d91be24e7af95e7e1ce5f0395247bbfb13b00354db44008fc0739d3700c9d627bd95222b08d5b8ff7770e

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: aarch64-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