thruster 0.0.2-x86_64-darwin → 0.0.3-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8254d138dff1776d25423f673fc4acc41016e978c427151f726cb2805f85dceb
-  data.tar.gz: 6a420cd890a1f92b3365882454d5ee0c63ba7f1bc72717ad714ddcd8dc73e1bc
+  metadata.gz: c4e2b9a1af43be349c566723cf26c1ab0b47fcbfc81be0cdc9e36016db9de51d
+  data.tar.gz: e19ea5d6e223be2f135f7f58f744607da96a03adc82dbeb17fb445691d17a1c9
 SHA512:
-  metadata.gz: 1829454971909c2fe5d82d59ef96de0374a990ccab76363f9cfa3db057cc5b443353ad7600c81f512df49b467aab0a86dea13b5089faeace2e377c49ce3fccc7
-  data.tar.gz: a655dc6192f6a78fe8a97b683eb2a2c116c7d523a8ea5565ea976975aa0aa9a1e67391e301c8f88049f58b5f4ecd73d21014e6ffdfbba5962b1861518c0e65b8
+  metadata.gz: 7b8181f222736a8e25b2e01b4624fd0fb356e54176676db25f8a66cf64c6036227b06487ef780955374d4b136430ede318a2b96ab73d4a3ef58684a80a429f48
+  data.tar.gz: ea5da7a5280f5d1a47ce8f2b91b28b9280739ca9777a053a3edd28f99da9d14ba6a1e4175e52fc256adc1a64b5d59d7ccba6106e546466476805f236587e8ec2

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Kevin McConnell
+Copyright (c) 37signals, LLC
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -2,24 +2,42 @@
 
 Thruster is an HTTP/2 proxy for simple production-ready deployments of Rails
 applications. It runs alongside the Puma webserver to provide a few additional
-features to help your app run efficiently and safely on the open Internet:
+features that help your app run efficiently and safely on the open Internet:
 
-- Automatic SSL certificate management with Let's Encrypt
 - HTTP/2 support
-- Basic HTTP caching
-- X-Sendfile support for efficient file serving
-- Automatic GZIP compression
+- Automatic SSL certificate management with Let's Encrypt
+- Basic HTTP caching of public assets
+- X-Sendfile support and compression, to efficiently serve static files
+
+Thruster aims to be as zero-config as possible. It has no configuration file,
+and most features are automatically enabled with sensible defaults. The goal is
+that simply running your Puma server with Thruster should be enough to get a
+production-ready setup.
 
-Thruster tries to be as zero-config as possible, so most features are
-automatically enabled with sensible defaults.
+The only exception to this is SSL provisioning: in order for Thruster to
+provision SSL certificates, it needs to know which domain those certificates
+should be for. So to use SSL, you need to set the `SSL_DOMAIN` environment
+variable. If you don't set this variable, Thruster will run in HTTP-only mode.
+
+Thruster also wraps the Puma process so that you can use it without managing
+multiple processes yourself. This is particularly useful when running in a
+containerized environment, where you typically won't have a process manager
+available to coordinate the processes. Instead you can use Thruster as your
+`CMD`, and it will manage Puma for you.
+
+Thruster was originally created for the [ONCE](https://once.com) project, where
+we wanted a no-fuss way to serve a Rails application from a single container,
+directly on the open Internet. We've since found it useful for simple
+deployments of other Rails applications.
 
-One exception to that is the `SSL_DOMAIN` environment variable, which is
-required to enable SSL provisioning. If `SSL_DOMAIN` is not set, Thruster will
-operate in HTTP-only mode.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Thruster is distributed as a Ruby gem. Because Thruster is written in Go, we
+provide several pre-built platform-specific binaries. Installing the gem will
+automatically fetch the appropriate binary for your platform.
+
+To install it, add it to your application's Gemfile:
 
 ```ruby
 gem 'thruster'
@@ -31,6 +49,7 @@ Or install it globally:
 $ gem install thruster
 ```
 
+
 ## Usage
 
 To run your Puma application inside Thruster, prefix your usual command string
@@ -46,46 +65,34 @@ Or with automatic SSL:
 $ SSL_DOMAIN=myapp.example.com thrust bin/rails server
 ```
 
-## Custom configuration
-
-Thruster provides a number of environment variables that can be used to
-customize its behavior:
-
-- `SSL_DOMAIN` - The domain name to use for SSL provisioning. If not set, SSL
-  will be disabled.
-
-- `TARGET_PORT` - The port that your Puma server should run on. Defaults to
-  3000. Thruster will set `PORT` to this when starting your server.
 
-- `CACHE_SIZE` - The size of the HTTP cache in bytes. Defaults to 64MB.
-
-- `MAX_CACHE_ITEM_SIZE` - The maximum size of a single item in the HTTP cache
-  in bytes. Defaults to 1MB.
-
-- `X_SENDFILE_ENABLED` - Whether to enable X-Sendfile support. Defaults to
-  enabled; set to `0` or `false` to disable.
-
-- `MAX_REQUEST_BODY` - The maximum size of a request body in bytes. Requests
-  larger than this size will be refused; `0` means no maximum size. Defaults to
-  `0`.
-
-- `STORAGE_PATH` - The path to store Thruster's internal state. Defaults to
-  `./storage/thruster`.
-
-- `BAD_GATEWAY_PAGE` - Path to an HTML file to serve when the backend server
-  returns a 502 Bad Gateway error. Defaults to `./public/502.html`. If there is
-  no file at the specific path, Thruster will serve an empty 502 response
-  instead.
-
-- `HTTP_PORT` - The port to listen on for HTTP traffic. Defaults to 80.
-
-- `HTTPS_PORT` - The port to listen on for HTTPS traffic. Defaults to 443.
-
-- `HTTP_IDLE_TIMEOUT` - The maximum time in seconds that a client can be idle
-  before the connection is closed. Defaults to 60.
-
-- `HTTP_READ_TIMEOUT` - The maximum time in seconds that a client can take to
-  send the request headers. Defaults to 30.
+## Custom configuration
 
-- `HTTP_WRITE_TIMEOUT` - The maximum time in seconds during which the client
-must read the response. Defaults to 30.
+In most cases, Thruster should work out of the box with no additional
+configuration. But if you need to customize its behavior, there are a few
+environment variables that you can set.
+
+| Variable Name         | Description                                                                     | Default Value |
+|-----------------------|---------------------------------------------------------------------------------|---------------|
+| `SSL_DOMAIN`          | The domain name to use for SSL provisioning. If not set, SSL will be disabled.  | None |
+| `TARGET_PORT`         | The port that your Puma server should run on. Thruster will set `PORT` to this value when starting your server. | 3000 |
+| `CACHE_SIZE`          | The size of the HTTP cache in bytes.                                            | 64MB |
+| `MAX_CACHE_ITEM_SIZE` | The maximum size of a single item in the HTTP cache in bytes.                   | 1MB |
+| `X_SENDFILE_ENABLED`  | Whether to enable X-Sendfile support. Set to `0` or `false` to disable.         | Enabled |
+| `MAX_REQUEST_BODY`    | The maximum size of a request body in bytes. Requests larger than this size will be refused; `0` means no maximum size is enforced. | `0` |
+| `STORAGE_PATH`        | The path to store Thruster's internal state. Provisioned SSL certificates will be stored here, so that they will not need to be requested every time your application is started. | `./storage/thruster` |
+| `BAD_GATEWAY_PAGE`    | Path to an HTML file to serve when the backend server returns a 502 Bad Gateway error. If there is no file at the specific path, Thruster will serve an empty 502 response instead. Because Thruster boots very quickly, a custom page can be a useful way to show that your application is starting up. | `./public/502.html` |
+| `HTTP_PORT`           | The port to listen on for HTTP traffic.                                         | 80 |
+| `HTTPS_PORT`          | The port to listen on for HTTPS traffic.                                        | 443 |
+| `HTTP_IDLE_TIMEOUT`   | The maximum time in seconds that a client can be idle before the connection is closed. | 60 |
+| `HTTP_READ_TIMEOUT`   | The maximum time in seconds that a client can take to send the request headers. | 30 |
+| `HTTP_WRITE_TIMEOUT`  | The maximum time in seconds during which the client must read the response.     | 30 |
+| `ACME_DIRECTORY`      | The URL of the ACME directory to use for SSL certificate provisioning.          | `https://acme-v02.api.letsencrypt.org/directory` (Let's Encrypt production) |
+| `EAB_KID`             | The EAB key identifier to use when provisioning SSL certificates, if required.  | None |
+| `EAB_HMAC_KEY`        | The Base64-encoded EAB HMAC key to use when provisioning SSL certificates, if required. | None |
+| `DEBUG`               | Set to `1` or `true` to enable debug logging.                                   | Disabled |
+
+To prevent naming clashes with your application's own environment variables,
+Thruster's environment variables can optionally be prefixed with `THRUSTER_`.
+For example, `SSL_DOMAIN` can also be written as `THRUSTER_SSL_DOMAIN`. Whenever
+a prefixed variable is set, it will take precedence over the unprefixed version.

data/lib/thruster/version.rb

@@ -1,3 +1,3 @@
 module Thruster
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: thruster
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: x86_64-darwin
 authors:
 - Kevin McConnell
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-28 00:00:00.000000000 Z
+date: 2024-03-06 00:00:00.000000000 Z
 dependencies: []
 description: A zero-config HTTP/2 proxy for lightweight production deployments
 email: kevin@37signals.com