32 lines
1.0 KiB
Go
32 lines
1.0 KiB
Go
package server
|
|
|
|
import (
|
|
"os"
|
|
)
|
|
|
|
// Defines the basic interface that all environments need to implement so that
|
|
// a server can be properly controlled.
|
|
type Environment interface {
|
|
// Starts a server instance. If the server instance is not in a state where it
|
|
// can be started an error should be returned.
|
|
Start() error
|
|
|
|
// Stops a server instance. If the server is already stopped an error should
|
|
// not be returned.
|
|
Stop() error
|
|
|
|
// Determines if the server instance exists. For example, in a docker environment
|
|
// this should confirm that the container is created and in a bootable state. In
|
|
// a basic CLI environment this can probably just return true right away.
|
|
Exists() bool
|
|
|
|
// Terminates a running server instance using the provided signal. If the server
|
|
// is not running no error should be returned.
|
|
Terminate(signal os.Signal) error
|
|
|
|
// Creates the necessary environment for running the server process. For example,
|
|
// in the Docker environment create will create a new container instance for the
|
|
// server.
|
|
Create() error
|
|
}
|