deploy

Documentation

Index

• func BuildAndPushImage(dir, name string, reg RegistryConfig) (string, error)
• func GenerateCompose(imageRef, serviceName string, port int, hasDB bool) []byte
• func HealthCheck(client *goss.Client, name string, timeout int) error
• func ListServices(client *goss.Client) ([]string, error)
• func ListVersions(client *goss.Client, serviceName string) ([]string, error)
• func Rollback(client *goss.Client, serviceName string) error
• func RunService(client *goss.Client, cfg ServiceConfig) error
• func ServiceLogs(client *goss.Client, name string, tail int, follow bool) error
• func ServiceStatus(client *goss.Client, name string) (string, error)
• func UploadImage(client *goss.Client, serviceName, version string, imageTar []byte) (string, error)
• type DeployResult
  • func UploadAndDeploy(client *goss.Client, cfg UploadConfig) (*DeployResult, error)
• type RegistryConfig
  • func DefaultRegistry() RegistryConfig
• type ServiceConfig
• type UploadConfig

Functions

func BuildAndPushImage

func BuildAndPushImage(dir, name string, reg RegistryConfig) (string, error)

BuildAndPushImage builds a Go binary locally, wraps in minimal Docker image, pushes to registry

func GenerateCompose

func GenerateCompose(imageRef, serviceName string, port int, hasDB bool) []byte

GenerateCompose generates a docker-compose.yml with optional postgres sidecar

func HealthCheck

func HealthCheck(client *goss.Client, name string, timeout int) error

func ListServices

func ListServices(client *goss.Client) ([]string, error)

func ListVersions

func ListVersions(client *goss.Client, serviceName string) ([]string, error)

func Rollback

func Rollback(client *goss.Client, serviceName string) error

func RunService

func RunService(client *goss.Client, cfg ServiceConfig) error

func ServiceLogs

func ServiceLogs(client *goss.Client, name string, tail int, follow bool) error

func ServiceStatus

func ServiceStatus(client *goss.Client, name string) (string, error)

func UploadImage

func UploadImage(client *goss.Client, serviceName, version string, imageTar []byte) (string, error)

UploadImage uploads a Docker image tar.gz to the VPS and loads it

Types

type DeployResult

type DeployResult struct {
	Version     string
	ServicePath string
}

func UploadAndDeploy

func UploadAndDeploy(client *goss.Client, cfg UploadConfig) (*DeployResult, error)

type RegistryConfig

type RegistryConfig struct {
	Server   string
	Username string
	Password string
}

func DefaultRegistry

func DefaultRegistry() RegistryConfig

type ServiceConfig

type ServiceConfig struct {
	Name      string
	Type      string // docker, k3s, systemd
	Image     string // Docker image (for docker type)
	Port      int
	Replicas  int
	EnvFile   string
	HealthURL string
}

type UploadConfig

type UploadConfig struct {
	ServiceName string
	SourceDir   string   // Local directory to upload
	Files       []string // Specific files to include (empty = all)
	Exclude     []string // Patterns to exclude
}