How to use Goss for Docker container testing?

Goss provides dgoss, a wrapper script for Docker testing. You can run it to validate container configurations, and the README includes examples for health checks and container ordering in Kubernetes environments.

Goss vs Serverspec: which is better for infrastructure testing?

Goss is faster and lighter, ideal for quick validations and health endpoints, while Serverspec, being Ruby-based, offers more extensive library support and might suit teams already invested in Ruby ecosystems.

Can Goss test HTTP endpoints and services?

Yes, Goss includes an HTTP resource type to validate network URLs with proxy support. You can define tests for endpoints to check availability, status codes, and responses directly in the YAML file.

How do I automatically generate tests with Goss?

Use the `goss autoadd` command followed by a resource name like sshd to create a YAML test file based on the current system state, as demonstrated in the quick start section with detailed output.

What are the limitations of Goss on non-Linux systems?

Goss has alpha-level support on Windows and macOS, meaning not all resource types or features are fully implemented. The README notes this in the Limitations section and links to platform-feature-parity details.

How to serve Goss tests as a health endpoint for monitoring?

Run `goss serve` to start an HTTP server that exposes test results on /healthz. You can customize the output format (e.g., JSON or Prometheus) for integration with monitoring tools like Nagios or Kubernetes.

Open-Awesome

goss

Apache-2.0Gov0.4.9

A YAML-based serverspec alternative for quick and easy server configuration validation and testing.

Visit Website GitHub

5.9k stars492 forks0 contributors

What is goss?

Goss is a lightweight, YAML-based server validation tool designed to test and verify system configurations quickly and efficiently. It allows users to generate tests from the current state of a server and execute them as a suite, serve them as health endpoints, or run them with retry logic. It solves the problem of ensuring server configuration correctness in DevOps and infrastructure management workflows.

Target Audience

System administrators, DevOps engineers, and SREs who need to validate server configurations, perform health checks, and ensure infrastructure consistency in both traditional and containerized environments.

Value Proposition

Developers choose Goss for its simplicity, speed, and small footprint—it's a single binary under 10MB that eliminates complex dependencies. Its ability to auto-generate tests and serve as a health endpoint makes it uniquely practical for continuous validation and monitoring.

Overview

Quick and Easy server testing/validation

Use Cases

Best For

Validating server configurations after deployment or changes
Creating health check endpoints for containers and services
Testing infrastructure as code (IaC) changes in CI/CD pipelines
Ensuring compliance of system packages, services, and network settings
Quickly writing and running ad-hoc server validation tests
Monitoring and validating Docker and Kubernetes container states

Not Ideal For

Teams primarily managing Windows or macOS servers, as Goss has alpha-level support for these platforms.
Projects requiring complex application-level or business logic testing beyond system resources like packages or services.
Environments needing built-in integration with specific enterprise monitoring systems not covered by the output formats (e.g., custom dashboards).
Use cases where test suites must be written in programming languages for advanced control and debugging.

Pros & Cons

Pros

Fast Execution

Goss runs test suites near-instantaneously for small to medium sizes, as demonstrated in the benchmarks referenced in the README, making it ideal for quick validations.

Minimal Footprint

It is a single self-contained binary under 10MB, reducing deployment complexity and resource usage, which is highlighted in the 'Why use Goss?' section.

Easy Test Generation

Commands like `autoadd` automatically derive tests from the current system state, speeding up initial test creation, as shown in the quick start with sshd.

Versatile Output Formats

It supports multiple formats including JSON, JUnit, and Prometheus, enabling seamless integration with CI/CD pipelines and monitoring tools, as listed in the output formats section.

Cons

Limited Platform Support

The README explicitly states that support for Windows and macOS is alpha, with feature parity limitations, making it unreliable for cross-platform infrastructure.

YAML-Centric Configuration

While YAML is simple, it can be restrictive for dynamic test logic; advanced features require templates and variables, adding complexity without full JSON schema validation in all cases.

Ecosystem Dependency

Integration with tools like Kubernetes relies on community-contributed wrapper scripts (e.g., kgoss), which may lack official support and stability compared to built-in features.

Open Source Alternative To

goss is an open-source alternative to the following products:

serverspec

serverspec is a testing framework for RSpec that verifies servers are configured correctly by executing commands locally or over SSH.

Frequently Asked Questions

Related Projects

gvisor

Application Kernel for Containers

Stars18,148

Forks1,578

Last commit1 day ago

Docker bench security

The Docker Bench for Security is a script that checks for dozens of common best-practices around deploying Docker containers in production.

Stars9,622

Forks1,039

Last commit1 year ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub