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