thruster 0.0.1-arm64-darwin → 0.0.2-arm64-darwin
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +89 -0
- data/exe/arm64-darwin/thrust +0 -0
- data/lib/thruster/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: f3180d215b65200fedb5c07d01129e79105a12eb8fba221fc4ab14bc87d7fabb
|
|
4
|
+
data.tar.gz: 77baf56a927a090581318ef7ffbe59031a3026823121930a3f1f3df942549603
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: b053ec9b18d1275244f5ca8e9db1c8cfe7a9699c96fed8bf327da1e4f220822457b6bb2c3ef5a574aa231b660aef32bd69423b3891eee148fe8dc09aa7deee72
|
|
7
|
+
data.tar.gz: 448c8e42b226e18b4a7ae56600c3f19e2fb484b4e2d00966ff3d38739ed1f9bd9bab7534168f626a3ea043b3f992b7d6e5124a1d973ad6b314b5869fc41aab20
|
data/README.md
CHANGED
|
@@ -1,2 +1,91 @@
|
|
|
1
1
|
# Thruster
|
|
2
2
|
|
|
3
|
+
Thruster is an HTTP/2 proxy for simple production-ready deployments of Rails
|
|
4
|
+
applications. It runs alongside the Puma webserver to provide a few additional
|
|
5
|
+
features to help your app run efficiently and safely on the open Internet:
|
|
6
|
+
|
|
7
|
+
- Automatic SSL certificate management with Let's Encrypt
|
|
8
|
+
- HTTP/2 support
|
|
9
|
+
- Basic HTTP caching
|
|
10
|
+
- X-Sendfile support for efficient file serving
|
|
11
|
+
- Automatic GZIP compression
|
|
12
|
+
|
|
13
|
+
Thruster tries to be as zero-config as possible, so most features are
|
|
14
|
+
automatically enabled with sensible defaults.
|
|
15
|
+
|
|
16
|
+
One exception to that is the `SSL_DOMAIN` environment variable, which is
|
|
17
|
+
required to enable SSL provisioning. If `SSL_DOMAIN` is not set, Thruster will
|
|
18
|
+
operate in HTTP-only mode.
|
|
19
|
+
|
|
20
|
+
## Installation
|
|
21
|
+
|
|
22
|
+
Add this line to your application's Gemfile:
|
|
23
|
+
|
|
24
|
+
```ruby
|
|
25
|
+
gem 'thruster'
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Or install it globally:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
$ gem install thruster
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Usage
|
|
35
|
+
|
|
36
|
+
To run your Puma application inside Thruster, prefix your usual command string
|
|
37
|
+
with `thrust`. For example:
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
$ thrust bin/rails server
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Or with automatic SSL:
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
$ SSL_DOMAIN=myapp.example.com thrust bin/rails server
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Custom configuration
|
|
50
|
+
|
|
51
|
+
Thruster provides a number of environment variables that can be used to
|
|
52
|
+
customize its behavior:
|
|
53
|
+
|
|
54
|
+
- `SSL_DOMAIN` - The domain name to use for SSL provisioning. If not set, SSL
|
|
55
|
+
will be disabled.
|
|
56
|
+
|
|
57
|
+
- `TARGET_PORT` - The port that your Puma server should run on. Defaults to
|
|
58
|
+
3000. Thruster will set `PORT` to this when starting your server.
|
|
59
|
+
|
|
60
|
+
- `CACHE_SIZE` - The size of the HTTP cache in bytes. Defaults to 64MB.
|
|
61
|
+
|
|
62
|
+
- `MAX_CACHE_ITEM_SIZE` - The maximum size of a single item in the HTTP cache
|
|
63
|
+
in bytes. Defaults to 1MB.
|
|
64
|
+
|
|
65
|
+
- `X_SENDFILE_ENABLED` - Whether to enable X-Sendfile support. Defaults to
|
|
66
|
+
enabled; set to `0` or `false` to disable.
|
|
67
|
+
|
|
68
|
+
- `MAX_REQUEST_BODY` - The maximum size of a request body in bytes. Requests
|
|
69
|
+
larger than this size will be refused; `0` means no maximum size. Defaults to
|
|
70
|
+
`0`.
|
|
71
|
+
|
|
72
|
+
- `STORAGE_PATH` - The path to store Thruster's internal state. Defaults to
|
|
73
|
+
`./storage/thruster`.
|
|
74
|
+
|
|
75
|
+
- `BAD_GATEWAY_PAGE` - Path to an HTML file to serve when the backend server
|
|
76
|
+
returns a 502 Bad Gateway error. Defaults to `./public/502.html`. If there is
|
|
77
|
+
no file at the specific path, Thruster will serve an empty 502 response
|
|
78
|
+
instead.
|
|
79
|
+
|
|
80
|
+
- `HTTP_PORT` - The port to listen on for HTTP traffic. Defaults to 80.
|
|
81
|
+
|
|
82
|
+
- `HTTPS_PORT` - The port to listen on for HTTPS traffic. Defaults to 443.
|
|
83
|
+
|
|
84
|
+
- `HTTP_IDLE_TIMEOUT` - The maximum time in seconds that a client can be idle
|
|
85
|
+
before the connection is closed. Defaults to 60.
|
|
86
|
+
|
|
87
|
+
- `HTTP_READ_TIMEOUT` - The maximum time in seconds that a client can take to
|
|
88
|
+
send the request headers. Defaults to 30.
|
|
89
|
+
|
|
90
|
+
- `HTTP_WRITE_TIMEOUT` - The maximum time in seconds during which the client
|
|
91
|
+
must read the response. Defaults to 30.
|
data/exe/arm64-darwin/thrust
CHANGED
|
Binary file
|
data/lib/thruster/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: thruster
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.0.
|
|
4
|
+
version: 0.0.2
|
|
5
5
|
platform: arm64-darwin
|
|
6
6
|
authors:
|
|
7
7
|
- Kevin McConnell
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2024-02-
|
|
11
|
+
date: 2024-02-28 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
13
|
description: A zero-config HTTP/2 proxy for lightweight production deployments
|
|
14
14
|
email: kevin@37signals.com
|