beady-eye

Beady Eye

Behaviour Driven Infrastructure is the technique of describing the expected behaviour of infrastructure components to support the specification and test driven development of Infrastructure as Code.

Beady Eye is a testing framework to support Behaviour Driven Infrastructure on AWS components, to keep an eye on your infrastructure compliance!

Getting Started

Create your compliance test my-compliance-test.js: NOTE: compliance tests need to be .js

module.exports.suite = (params) => {
    describe("My Redshift Cluster", () => {
        let redshiftClusterName = 'my-redshift-cluster'

        beforeAll((done)=> {
        
            const bdi = require('beady-eye')
            const RedshiftCluster = bdi.RedshiftCluster
            
            this.redshift = new RedshiftCluster(redshiftClusterName, region)
            done()
        })

        it("should exist", async (done) => {
            expect(this.redshift).toBeDefined()
            expect(await this.redshift.shouldExist()).toEqual(true)
            done()
        })
    })
}

Configure your src/complianceTestLambda.ts:

export const runCompliance: Handler = (event: APIGatewayEvent, context: Context, cb: Callback) => {

  let complianceRunner = new JasmineComplianceRunner(cb)  

  require('./my-compliance-test.js').suite(redshiftParams)

  complianceRunner.execute()
}

Configure serverless.yaml:

functions:
  compliance:
    handler: src/complianceTests.runCompliance
    package:
      include:
        - src/*.js
        - node_modules/beady-eye/**

Development

git clone https://github.com/MechanicalRock/beady-eye
cd beedy-eye
npm install
npm link
cd /path/to/my/project
npm link beady-eye

Continuous Build

In order to build changes continuously, when working with linked projects, create a separate terminal and run:

npm run build:watch

This will automatically re-build upon changes to your beady-eye source, so it is available in your linked project.

Generating test data

Set the details of the account you wish to switch to for test data generation

export AWS_PROFILE='my_profile'
export AWS_ACCOUNT_ID='123456

npm run test:approval

Releasing

npm run release
git push
git push --tags