lestrrat-go/server-starter lestrrat-go/server-starter

  • Stars
    star
    215
  • Rank 183,925 (Top 4 %)
  • Language
    Go
  • License
    MIT License
  • Created almost 10 years ago
  • Updated over 2 years ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
lestrrat-go/server-starter
github

lestrrat-go

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Go port of start_server utility (Server::Starter)

server-starter

Go port of start_server utility (a.k.a. Server::Starter).

Build Status

GoDoc

DESCRIPTION

note: this description is almost entirely taken from the original Server::Starter module

The start_server utility is a superdaemon for hot-deploying server programs.

It is often a pain to write a server program that supports graceful restarts, with no resource leaks. Server::Starter solves the problem by splitting the task into two: start_server works as a superdaemon that binds to zero or more TCP ports or unix sockets, and repeatedly spawns the server program that actually handles the necessary tasks (for example, responding to incoming connections). The spawned server programs under start_server call accept(2) and handle the requests.

To gracefully restart the server program, send SIGHUP to the superdaemon. The superdaemon spawns a new server program, and if (and only if) it starts up successfully, sends SIGTERM to the old server program.

By using start_server it is much easier to write a hot-deployable server. Following are the only requirements a server program to be run under start_server should conform to:

  • receive file descriptors to listen to through an environment variable - perform a graceful shutdown when receiving SIGTERM

Many PSGI servers support this. If you want your Go program to support it, you can look under the listener directory for an implementation that also fills the net.Listener interface.

INSTALLATION

go get github.com/lestrrat-go/server-starter/cmd/start_server

More Repositories

1

jwx

Implementation of various JWx (Javascript Object Signing and Encryption/JOSE) technologies
Go
1,908
star
2

file-rotatelogs

[ARCHIVED] Port of perl5 File::RotateLogs to Go
Go
964
star
3

libxml2

Interface to libxml2, with DOM interface
Go
230
star
4

backoff

Backoff mechanics for Go
Go
187
star
5

strftime

Fast strftime for Go
Go
110
star
6

test-mysqld

Create real MySQL server instance for testing
Go
88
star
7

slack

Slack client for go
Go
85
star
8

jsschema

JSON Schema for Go
Go
66
star
9

xslate

Powerful Template Engine for Go (port Perl5's Text::Xslate)
Go
65
star
10

jsval

Validator toolset, aimed to be used with JSON Schema
Go
54
star
11

apache-logformat

Port of Perl5's Apache::LogFormat::Compiler to golang
Go
48
star
12

sharaq

Image Transformer
Go
35
star
13

fluent-client

A fluentd client
Go
34
star
14

xmlsec

xmlsec1 binding for golang
Go
29
star
15

openapi

[WIP] OpenAPI for Go
Go
24
star
16

xstrings

Unicode-aware string utilities for Go
Go
22
star
17

jsref

JSON Reference Implementation for Go
Go
20
star
18

ngram

Ngram for golang
Go
19
star
19

cron

Dispatch jobs cron-style
Go
19
star
20

pdebug

Utilities for my print debugging fun. YMMV
Go
17
star
21

scripting

Handy toolset when using Go as a shell script replacement
Go
17
star
22

httprc

Quasi Up-to-date HTTP In-memory Cache
Go
16
star
23

msgpack

A `msgpack` serializer and deserializer
Go
16
star
24

tcputil

Some Utilities To Help Your TCP-Related testing
Go
16
star
25

hsup

Generate scaffold web app from JSON Hyper Schema files
Go
15
star
26

multifs

Create an fs.FS instance that "mounts" other fs.FS
Go
15
star
27

ical

Work with ical formatted data
Go
12
star
28

gcp-auto-lb-clean

Delete Dangling GCP Load Balancers Created By GKE
Go
12
star
29

channels

Channel patterns
Go
11
star
30

urlenc

Marshal/Unmarshal interface for structs that can encode/decode themselves to URL query strings
Go
11
star
31

tcptest

Start A Network Server On Random Local Port (Port of Perl5's TCP::Test)
Go
11
star
32

helium

(Work In Progress) An exercise rewriting libxml2 in Go
Go
10
star
33

naivebayes

Yet Another Naive-Bayesian filter algorithm
Go
9
star
34

echo-middleware-jwx

Echo (labstack/echo) middleware for using github.com/lestrrat-go/jwx
Go
9
star
35

option

Base option type
Go
9
star
36

gettext

Go
8
star
37

config

Libraries to aid configuration for golang applications
8
star
38

iter

Iterator tools
Go
8
star
39

jshschema

JSON Hyper Schema for Go
Go
8
star
40

lex

Simple lexer for Go
Go
8
star
41

jspointer

JSON pointer for Go
Go
8
star
42

fsnotify

fsnotify for Go
Go
7
star
43

sqllib

Maintain a library of prepared SQL statements (*sql.Stmt)
Go
6
star
44

structinfo

Tools to inspect Go structs
Go
6
star
45

rotating

A representation of a file that knows how to rotate itself based on size/interval
Go
6
star
46

blackmagic

Reflect-based black magic
Go
5
star
47

mux

A minimalistic HTTP Router for Go
Go
5
star
48

bufferpool

Very simple bytes.Buffer pool using sync.Pool
Go
5
star
49

pubsub

Simple broadcast pattern
Go
5
star
50

fear-of-go

4
star
51

sandbox

My tests, benchmarks
Go
4
star
52

tmplbox

Yet Another (text|html)/template wrapper
Go
4
star
53

packasset

Lightweight resource embedding utility for Go
Go
4
star
54

runcmd

Wrapper for "os/exec".Command
Go
4
star
55

sketch

Generate JSON (De)serializable Object From Go Schema
Go
4
star
56

merror

Error representing multiple errors
Go
4
star
57

envload

Restore and load environment variables
Go
3
star
58

lmdb

[WIP] Go Binding to LMDB
Go
3
star
59

strcursor

Tools for when you need to perform character-wise parsing
Go
3
star
60

httpcc

HTTP/1.1 Cache-Control Header Parser
Go
3
star
61

astv

An Alternate Go AST Visitor
Go
2
star
62

openscad

OpenSCAD Code Generator and Linter written in Go
Go
2
star
63

byteslice

Easy to handle `[]byte` type in your Go JSON structs
Go
2
star
64

codegen

Utilities for generating Go code
Go
2
star
65

dataurl

Parse/Encode RFC2397 "data" URL scheme
Go
2
star
66

contributions

2
star
67

rungroup

Control execution of multiple goroutines
Go
2
star
68

openscad-mcad

Port of openscad/mcad to github.com/lestrrat-go/openscad
Go
1
star
69

spanner-model

Go
1
star
70

rescue

Go
1
star
71

jsonptr

[WIP] RFC6901
Go
1
star
72

spanner-emulator-driver

Start/Stop Spanner Emulator from Go code
Go
1
star
73

gnap

Move along, there's nothing to see here yet
Go
1
star
74

jwx-aws-kms

Use KMS services as signer/verifier for github.com/lestrrat-go/jwx
Go
1
star
75

epd

[WIP] Port of ePaper HAT binding
Go
1
star
76

accesslog

HTTP middleware to log access logs based on `log/slog` for Go
Go
1
star
77

scriptor

Framework to construct a scripted sequence of actions, such as for testing
Go
1
star