falcon 0.52.2 → 0.52.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0967ef764ac13d234647007c5e209941c431a6f39818a8814936cb6cc0187b26'
-  data.tar.gz: efa9ede4c4d5f47db5e226df606d65d94d13b2499f12fa206684f902eb35eb6a
+  metadata.gz: 0d52ed7de8cbcdb1a7d2841131cd02f0b89165776384ee1637693c774e724ebd
+  data.tar.gz: 4cf37f13cce0acbbbba818584e8dc6fe7ef3eb031896eab9105a1cacf9fe6421
 SHA512:
-  metadata.gz: 281ea0eb27895d276dcc85b5ace7465de4022047efd86132bd6ec0670be96cc16879a256bdbbd00765f0f45c658b9240dbf4974acce8e3219522eb77e8b4ad6e
-  data.tar.gz: 636d1d97dfe9313081a922f6fef956a6a9fe7335b8cd203ca6038765c84fe5616fc4e27d7651006bd633fb73c06e98af1c94a558bf290f9ca74ec30e9dc6bbf4
+  metadata.gz: 512323cbc344f48366fb68f15b3dfa04d175519ed2e4f45f936ce937469de0ec669d5e59076a7567f688ecc8a8c6b4ab83ea62c21bee1c6842ab0070e2c72740
+  data.tar.gz: 2e2291890e67f9ba1ea9c197a44d363c89b48bd0d053a27259cf4b57a27fcfbbde0ce845cdde3ad4c0beb0054bb32d6588eeb15e53867864b6dc3922cb2088b7

data/context/deployment.md

@@ -1,6 +1,6 @@
 # Deployment
 
-This guide explains how to use Falcon in production environments.
+This guide explains how to deploy applications using the Falcon web server. It covers the recommended deployment methods, configuration options, and examples for different environments, including systemd and kubernetes.
 
 Falcon can be deployed into production either as a standalone application server, or as a virtual host routing to multiple applications. Both configurations can run behind a load balancer, but `falcon virtual` is designed to be zero-configuration deployment option.
 
@@ -145,6 +145,50 @@ service hostname do
 require_relative "config/environment"
 ~~~
 
+### Kubernetes Integration
+
+Falcon can be deployed in a Kubernetes cluster using the `falcon host` command. You can use the following example to create a Kubernetes deployment for Falcon:
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: falcon
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: falcon
+  template:
+    metadata:
+      labels:
+        app: falcon
+    spec:
+      containers:
+        - name: my-app
+          image: my-app-image:latest
+          env:
+            - name: NOTIFY_LOG
+              value: "/tmp/notify.log"
+          ports:
+            - containerPort: 9292
+          readinessProbe:
+            exec:
+              command: ["bundle", "exec", "bake", "async:container:notify:log:ready?"]
+            initialDelaySeconds: 5
+            periodSeconds: 5
+            failureThreshold: 12
+
+          # Assuming you are running Rails and have bound to port 3000:
+          livenessProbe:
+            httpGet:
+              path: /up
+              port: 3000
+            initialDelaySeconds: 10
+            periodSeconds: 10
+            failureThreshold: 3
+```
+
 ## Falcon Virtual
 
 Falcon virtual provides a virtual host proxy and HTTP-to-HTTPS redirection for multiple applications. It is designed to be a zero-configuration deployment option, allowing you to run multiple applications on the same server.
@@ -164,3 +208,23 @@ falcon virtual /srv/http/*/falcon.rb
 By default, it binds to both HTTP and HTTPS ports, and automatically redirects HTTP requests to HTTPS. It also supports TLS SNI for resolving the certificates.
 
 See the [docker example](https://github.com/socketry/falcon-virtual-docker-example) for a complete working example.
+
+### systemd Service File
+
+You can create a systemd service file to manage the Falcon virtual service. Here is an example of a systemd service file for Falcon:
+
+```ini
+[Unit]
+Description=Falcon Virtual Service
+After=network.target
+
+[Service]
+Type=notify
+User=http
+WorkingDirectory=/srv/http
+ExecStart=/usr/local/bin/falcon virtual /srv/http/*/falcon.rb
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+```

data/context/index.yaml

@@ -15,7 +15,9 @@ files:
   description: This guide explains how to host Rails applications with Falcon.
 - path: deployment.md
   title: Deployment
-  description: This guide explains how to use Falcon in production environments.
+  description: This guide explains how to deploy applications using the Falcon web
+    server. It covers the recommended deployment methods, configuration options, and
+    examples for different environments, including systemd and kubernetes.
 - path: performance-tuning.md
   title: Performance Tuning
   description: This guide explains the performance characteristics of Falcon.

data/context/websockets.md

@@ -9,7 +9,7 @@ Falcon supports WebSockets using the [async-websocket gem](https://github.com/so
 ~~~ruby
 # config.ru
 
-require "async/websocket/adapter/rack"
+require "async/websocket/adapters/rack"
 
 run do |env|
 	Async::WebSocket::Adapters::Rack.open(env, protocols: ['ws']) do |connection|

data/lib/falcon/command/serve.rb

@@ -64,7 +64,6 @@ module Falcon
 			def environment
 				Async::Service::Environment.new(Falcon::Environment::Server).with(
 					Falcon::Environment::Rackup,
-					
 					root: Dir.pwd,
 					
 					verbose: self.parent&.verbose?,

data/lib/falcon/configuration.rb

@@ -73,7 +73,7 @@ module Falcon
 					merge(:supervisor, name: name, root: @root, &block)
 				)
 			end
-				
+			
 			private
 			
 			# Build a new environment with the specified name and the given parents.

data/lib/falcon/environment/virtual.rb

@@ -56,10 +56,10 @@ module Falcon
 			# # An endpoint suitable for connecting to the specified hostname.
 			# def host_endpoint(hostname, **options)
 			# 	endpoint = secure_endpoint(**options)
-				
+			# 	
 			# 	url = URI.parse(bind_secure)
 			# 	url.hostname = hostname
-				
+			# 	
 			# 	return Async::HTTP::Endpoint.new(url, hostname: endpoint.hostname)
 			# end
 		end

data/lib/falcon/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2017-2025, by Samuel Williams.
 
 module Falcon
-	VERSION = "0.52.2"
+	VERSION = "0.52.4"
 end

data/license.md

@@ -27,6 +27,7 @@ Copyright, 2024, by Stefan Buhrmester.
 Copyright, 2024, by Ismael Celis.  
 Copyright, 2025, by Pierre Montelle.  
 Copyright, 2025, by Jared Smith.  
+Copyright, 2025, by Yoji Shidara.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -33,7 +33,7 @@ Please see the [project documentation](https://socketry.github.io/falcon/) for m
 
   - [Rails Integration](https://socketry.github.io/falcon/guides/rails-integration/index) - This guide explains how to host Rails applications with Falcon.
 
-  - [Deployment](https://socketry.github.io/falcon/guides/deployment/index) - This guide explains how to use Falcon in production environments.
+  - [Deployment](https://socketry.github.io/falcon/guides/deployment/index) - This guide explains how to deploy applications using the Falcon web server. It covers the recommended deployment methods, configuration options, and examples for different environments, including systemd and kubernetes.
 
   - [Performance Tuning](https://socketry.github.io/falcon/guides/performance-tuning/index) - This guide explains the performance characteristics of Falcon.
 
@@ -47,6 +47,10 @@ Please see the [project documentation](https://socketry.github.io/falcon/) for m
 
 Please see the [project releases](https://socketry.github.io/falcon/releases/index) for all releases.
 
+### v0.52.4
+
+  - Relax dependency on `async-container-supervisor` to allow `~> 0.6`.
+
 ### v0.52.0
 
   - Modernized codebase and dropped support for Ruby v3.1.
@@ -98,13 +102,13 @@ In addition, `falcon serve` provides two new options:
 The current configuration format uses definitions like this:
 
 ``` ruby
-rack 'hello.localhost', :self_signed_tls
+rack "hello.localhost", :self_signed_tls
 ```
 
 This changes to:
 
 ``` ruby
-service 'hello.localhost' do
+service "hello.localhost" do
 	include Falcon::Environment::Rack
 	include Falcon::Environment::SelfSignedTLS
 end

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.52.4
+
+  - Relax dependency on `async-container-supervisor` to allow `~> 0.6`.
+
 ## v0.52.0
 
   - Modernized codebase and dropped support for Ruby v3.1.
@@ -106,13 +110,13 @@ In addition, `falcon serve` provides two new options:
 The current configuration format uses definitions like this:
 
 ``` ruby
-rack 'hello.localhost', :self_signed_tls
+rack "hello.localhost", :self_signed_tls
 ```
 
 This changes to:
 
 ``` ruby
-service 'hello.localhost' do
+service "hello.localhost" do
 	include Falcon::Environment::Rack
 	include Falcon::Environment::SelfSignedTLS
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: falcon
 version: !ruby/object:Gem::Version
-  version: 0.52.2
+  version: 0.52.4
 platform: ruby
 authors:
 - Samuel Williams
@@ -31,6 +31,7 @@ authors:
 - Stefan Buhrmester
 - Tad Thorley
 - Tasos Latsas
+- Yoji Shidara
 bindir: bin
 cert_chain:
 - |
@@ -98,14 +99,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
@@ -311,7 +312,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.2
 specification_version: 4
 summary: A fast, asynchronous, rack-compatible web server.
 test_files: []