https://github.com/mattn/goreman

foreman clone written in go language
https://github.com/mattn/goreman

devops foreman go golang

Last synced: 21 days ago
JSON representation

foreman clone written in go language

• Host: GitHub
• URL: https://github.com/mattn/goreman
• Owner: mattn
• License: mit
• Created: 2012-09-13T06:22:59.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-11-26T11:01:36.000Z (6 months ago)
• Last Synced: 2025-04-10T23:56:14.471Z (about 1 month ago)
• Topics: devops, foreman, go, golang
• Language: Go
• Size: 821 KB
• Stars: 2,540
• Watchers: 47
• Forks: 201
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• stars - mattn/goreman
• awesome-golang-repositories - goreman
• awesome-starred - mattn/goreman - foreman clone written in go language (golang)

README

        
# Goreman

Clone of foreman written in golang.

https://github.com/ddollar/foreman

## Getting Started

    go install github.com/mattn/goreman@latest

## Usage

    goreman start

Will start all commands defined in the `Procfile` and display their outputs.

Any signals are forwarded to each process.

## Example

See [`_example`](_example/) directory

## License

MIT

## Design

The main goroutine loads `Procfile` and starts each command in the file. Afterwards, it is driven by the following two kinds of events, and then take proper action against the managed processes.

1. It receives a signal, which could be one of `SIGINT`, `SIGTERM`, and `SIGHUP`;

2. It receives an RPC call, which is triggered by the command `goreman run COMMAND [PROCESS...]`.

![design](images/design.png)

## Authors

Yasuhiro Matsumoto (a.k.a mattn)