Skip to content

Latest commit

 

History

History
73 lines (54 loc) · 2.67 KB

README.md

File metadata and controls

73 lines (54 loc) · 2.67 KB

Write infrastructure tests in plain English, without writing a single line of code.

InfraSpec

Write infrastructure tests in plain English using Gherkin syntax, without writing code. InfraSpec translates your natural language specifications into executable infrastructure tests.

Feature: S3 Bucket Creation
  As a DevOps Engineer
  I want to create an S3 bucket with guardrails
  So that I can store my data securely

  Scenario: Create an S3 bucket with a name
    Given I have a Terraform configuration in "./s3-bucket"
    And I set variable "bucket_name" to "my-bucket"
    When I run Terraform apply
    Then the S3 bucket "my-bucket" should exist
    And the S3 bucket "my-bucket" should have a versioning configuration
    And the S3 bucket "my-bucket" should have a public access block
    And the S3 bucket "my-bucket" should have a server access logging configuration
    And the S3 bucket "my-bucket" should have a encryption configuration

⚠️ This project is still under heavy development!

Under the hood, InfraSpec executes scenarios using GoDog and leverages testing modules from Terratest.

Features

  • Write tests in plain English using Gherkin syntax
  • Supports AWS infrastructure testing
  • Integrates with Terraform configurations
  • Zero code required for writing tests

Status

At the moment, only a subset of AWS infrastructure is supported, but over time we hope to support other clouds and tooling.

Product Description Status
S3 Not Implemented
DynamoDB Partially Supported

Why InfraSpec?

  • Natural Language Testing. Write tests in plain English that both technical and non-technical team members can understand.
  • LLM Integration. Leverage AI to generate test scenarios.
  • Supply Chain Security. Ensure your infrastructure meets security and compliance requirements.
  • No Code Required: Focus on what to test rather than how to test.

Installation

go install github.com/robmorgan/infraspec@latest

Getting Started

If your using VS Code, we recommend installing the Cucumber (Gherkin) Full Support extension for syntax highlighting.

Contributions

Contributions are welcome! Please open an issue or submit a pull request. Please note, that this project is still in it's infancy and many internal APIs are likely to change.