Compare commits
3 Commits
Author | SHA1 | Date | |
---|---|---|---|
669f269dd3 | |||
c15e9feb66 | |||
ae7f311c8e |
22
README.md
22
README.md
@ -9,6 +9,7 @@
|
|||||||
func main() {
|
func main() {
|
||||||
appName := "coolapp"
|
appName := "coolapp"
|
||||||
if deploy {
|
if deploy {
|
||||||
|
// error checking ignored for this example
|
||||||
unit, _ := unitard.NewUnit(appName)
|
unit, _ := unitard.NewUnit(appName)
|
||||||
unit.Deploy()
|
unit.Deploy()
|
||||||
os.Exit(0)
|
os.Exit(0)
|
||||||
@ -18,16 +19,23 @@
|
|||||||
|
|
||||||
## What it does
|
## What it does
|
||||||
|
|
||||||
`Deploy()` automatically creates a systemd unit file, reloads the systemd daemon
|
This package provides a simple interface to automatically creating and enabling a
|
||||||
so it can use it, enables the unit (so it starts on boot) and starts the service
|
systemd "user unit" service, as part of your single-binary deployment.
|
||||||
|
|
||||||
|
The `Deploy()` function creates the systemd unit file, reloads the systemd daemon
|
||||||
|
so it reads it, enables the unit (to start on boot) and starts the service
|
||||||
running.
|
running.
|
||||||
|
|
||||||
This means you can have a single binary deployment. Copy your executable to "somewhere"
|
Copy your executable to "somewhere" on your target system, run it with `-deploy`
|
||||||
on your target system, run it with `-deploy` (or however you have enabled the call to `Deploy()`)
|
(or however you have enabled the call to `Deploy()`) and your application starts
|
||||||
and your application starts running in the background, and will restart on boot.
|
running in the background and will restart on boot.
|
||||||
|
|
||||||
There is also an `Undeploy()` func, which you should of course
|
There is also an `Undeploy()` func, which you should of course provide as an option
|
||||||
provide as an option to your users. It stops the running service, removes the unit file and restarts systemd.
|
to your users. It stops the running service, removes the unit file and reloads the
|
||||||
|
systemd daemon.
|
||||||
|
|
||||||
|
While it does shell out to call the `systemctl` tool, this does mean this package
|
||||||
|
adds no new non-core dependencies to your project.
|
||||||
|
|
||||||
## What's with the name?
|
## What's with the name?
|
||||||
|
|
||||||
|
@ -5,7 +5,7 @@ Description={{ .description }}
|
|||||||
|
|
||||||
[Service]
|
[Service]
|
||||||
WorkingDirectory={{ .workingDirectory }}
|
WorkingDirectory={{ .workingDirectory }}
|
||||||
ExecStart={{ .execStart }}
|
ExecStart={{ .execStart }} {{ .execStartArgs }}
|
||||||
|
|
||||||
[Install]
|
[Install]
|
||||||
WantedBy=default.target
|
WantedBy=default.target
|
32
unitard.go
32
unitard.go
@ -4,6 +4,7 @@ package unitard
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"embed"
|
"embed"
|
||||||
|
"errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
"os"
|
"os"
|
||||||
@ -21,12 +22,31 @@ type Unit struct {
|
|||||||
name string
|
name string
|
||||||
binary string
|
binary string
|
||||||
binaryPath string
|
binaryPath string
|
||||||
|
binaryArgs string
|
||||||
|
|
||||||
systemCtlPath string // path to systemctl command
|
systemCtlPath string // path to systemctl command
|
||||||
unitFilePath string
|
unitFilePath string
|
||||||
}
|
}
|
||||||
|
|
||||||
type UnitOpts interface{}
|
type UnitOpts interface {
|
||||||
|
Apply(u *Unit) error
|
||||||
|
}
|
||||||
|
|
||||||
|
// OptProgramArgs allows you to add an arguments to the invocation of the program
|
||||||
|
type OptProgramArgs struct {
|
||||||
|
Args string // Program args
|
||||||
|
}
|
||||||
|
|
||||||
|
func (o OptProgramArgs) Apply(u *Unit) error {
|
||||||
|
if o.Args == "" {
|
||||||
|
return errors.New("can't set an empty args option")
|
||||||
|
}
|
||||||
|
if u.binaryArgs != "" {
|
||||||
|
return errors.New("args were already set - use OptProgramArgs only once")
|
||||||
|
}
|
||||||
|
u.binaryArgs = o.Args
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
// NewUnit creates a new systemd unit representation, with a particular name.
|
// NewUnit creates a new systemd unit representation, with a particular name.
|
||||||
// No changes will be made to the system configuration until Deploy or Undeploy
|
// No changes will be made to the system configuration until Deploy or Undeploy
|
||||||
@ -46,8 +66,11 @@ func NewUnit(unitName string, unitOpts ...UnitOpts) (Unit, error) {
|
|||||||
binaryPath: path,
|
binaryPath: path,
|
||||||
}
|
}
|
||||||
|
|
||||||
if len(unitOpts) > 0 {
|
for _, opt := range unitOpts {
|
||||||
return Unit{}, fmt.Errorf("sorry, UnitOpts are not yet supported")
|
err := opt.Apply(&u)
|
||||||
|
if err != nil {
|
||||||
|
return Unit{}, fmt.Errorf("bad option: %s", err)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
err := u.setupEnvironment()
|
err := u.setupEnvironment()
|
||||||
@ -97,6 +120,7 @@ func (u Unit) writeTemplate(f io.Writer) error {
|
|||||||
data := map[string]string{
|
data := map[string]string{
|
||||||
"description": u.name,
|
"description": u.name,
|
||||||
"execStart": u.binary,
|
"execStart": u.binary,
|
||||||
|
"execStartArgs": u.binaryArgs,
|
||||||
"workingDirectory": u.binaryPath,
|
"workingDirectory": u.binaryPath,
|
||||||
}
|
}
|
||||||
err = t.ExecuteTemplate(f, "basic.service", data)
|
err = t.ExecuteTemplate(f, "basic.service", data)
|
||||||
@ -213,7 +237,7 @@ func (u *Unit) setupEnvironment() error {
|
|||||||
"user",
|
"user",
|
||||||
)
|
)
|
||||||
|
|
||||||
err = os.MkdirAll(unitFileDirectory, 0777)
|
err = os.MkdirAll(unitFileDirectory, 0700)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return fmt.Errorf("cannot create the user systemd path '%s': %s", unitFileDirectory, err)
|
return fmt.Errorf("cannot create the user systemd path '%s': %s", unitFileDirectory, err)
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user