Goss

Use this skill when the user wants to validate server configuration, Docker containers, or infrastructure state with fast YAML-based tests — health checks, package presence, port listening, file contents, and HTTP endpoints.

javimosch d5793c6 1.3 KB Updated

File contents

goss Plugin

Quick and Easy server testing. Define infrastructure expectations as YAML and run them in milliseconds — ideal for CI, Docker image validation, and post-deploy smoke tests.

Installation

curl -fsSL https://goss.rocks/install | sh
# or
brew install goss

Basic Usage

# Auto-generate tests from current system state
goss add package nginx
goss add port 80
goss add file /etc/nginx/nginx.conf

# Run validation
goss validate

# Validate a Docker image
dgoss run myimage:latest /goss/goss validate

Common Patterns

# Write tests to goss.yaml
goss add service ssh --port 22

# Validate with formatted output
goss validate --format documentation

# Validate against a remote host
goss validate --endpoint tcp://myserver:22

Usage Examples

  • "Check that nginx is installed and port 80 is listening"
  • "Validate this Docker image has the right packages"
  • "Generate goss tests from the current server state"

SuperCLI

sc goss _ _ validate
sc goss _ _ add port 8080
sc plugins learn goss

javimosch/supercli/tree/main/plugins/goss/skills/quickstart commit d5793c6aef

Frequently asked questions

npx skillmds@latest add javimosch/goss