aelsabbahy/goss
Goss
Goss is an infrastructure validation tool and testing framework used to verify that a server's current state matches a desired configuration. It compares live system output against YAML or JSON specifications to validate components such as packages, services, users, and network ports.
The tool enables the automated generation of test specifications by capturing the existing state of a system. It supports diverse deployment environments through the use of dynamic templates and variable files.
Beyond point-in-time validation, the framework can execute retrying tests that poll for state convergence until a timeout is reached. It provides observability by exposing validation results via HTTP health endpoints and exporting outcomes in standard formats for integration with external monitoring tools.
Features
- State Validators - Compares live system output against YAML or JSON definitions to verify that server configurations match a desired state.
- Declarative Infrastructure Test Suites - Implements a framework for defining and executing declarative infrastructure validation rules using YAML specifications.
- YAML - Utilizes a declarative YAML-based specification to query and validate the state of server packages, services, and ports.
- Infrastructure Test Generators - Generate test specifications automatically based on the current system state to simplify the setup of validation suites.
- System State Discovery Tools - Provides the ability to automatically generate test specifications by capturing the existing state of a system.
- System State Synchronization - Checks if the current system state matches a desired declarative configuration and reports discrepancies.
- Declarative Server Configuration Validators - Compares the current state of a system against a specification file to verify the server is configured correctly.
- Declarative Server Validators - Runs a series of system checks and waits for specific states to be reached before reporting results.
- Infrastructure Test Generators - Creates initial test suites by deriving the current system state through automated discovery commands.
- Infrastructure State Validators - Compares the current state of a server against a specification file to verify packages, services, users, and network ports.
- Server State Validators - Compares the current state of a system against a specification file to verify the server is configured correctly.
- Dynamic Templates - Renders test specifications using templates and variable files to support multiple different deployment environments.
- State Polling - Repeatedly executes validation checks until the system reaches the desired configuration or a timeout is hit.
- Health Monitoring Endpoints - Exposes the results of the latest validation suite as a web endpoint for real-time system health monitoring.
- Real-Time Monitoring Dashboards - Exposes system validation results as health check endpoints to provide a real-time status of the operational environment.
- System Specification Auditing - Generates test specifications from the current system state to document and validate the existing server configuration.
- Deployment Verifications - Runs validation suites and retries failed tests until a system reaches a stable and correct state after updates.
- Retry Until Success - Executes a test suite repeatedly until the system reaches a valid state or a specified timeout expires.
- Dynamic Specification Templates - Supports diverse deployment environments through the use of dynamic templates and variable files for test specifications.
- Automated State Discovery - Enables the automated generation of test specifications by capturing the existing state of a system.
- Environment-Specific Test Suites - Processes variable files through templates to create environment-specific test suites for diverse deployment targets.
- Container Security Tools - Enables quick server testing and validation of container configurations.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
