Skip to content

screwdriver-cd/build-bookend

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Build Bookend

Version Downloads Build Status Open Issues License

creates setup and teardown steps for builds

Usage

npm install screwdriver-build-bookend

Using the bookend interface

Extend the bookend interface in this module. You will need to define getSetupCommand and getTeardownCommand to return the commands needed to execute and return these in a promise.

const { BookendInterface } = require('screwdriver-build-bookend');

class MyBookend extends BookendInterface {
    getSetupCommand() {
        return Promise.resolve('echo "hello world"');
    }
    getTeardownCommand() {
        return Promise.resolve('echo "goodbye world"');
    }
}

module.exports = MyBookend;

Getting final bookend commands

Use the Bookend module to combine a set of BookendInterface based modules into single set of setup and teardown commands. See more examples in the tests.

const SampleBookend = require('sd-sample-bookend');
const { Bookend } = require('screwdriver-build-bookend');
const b = new Bookend(
    // Provide a set of default instantiated plugins
    { 'sample': new SampleBookend() },
    /*
        Provide a list of plugins to use for setup and teardown, by name or with a config object
        You can also choose to include your own modules with a config, these will be initialized for you with the given config.
        The following config will use the default sample plugin, then the users my-bookend plugin
     */
    {
        default: {
            setup: [ 'sample', { name: 'my-bookend', config: { foo: 'bar' } }],
            teardown: [ 'sample', { name: 'my-bookend', config: { foo: 'bar' } }]
        },
        // You can switch bookends for each build cluster when multi build cluster is enabled
        clusterName: {
            // You can specify an alias for bookends
            setup: [ 'sample', { name: 'my-bookend-module-with-long-name', alias: 'my-bookend', config: { foo: 'bar' } }],
            teardown: [ 'sample', { name: 'my-bookend', config: { foo: 'bar' } }]
        }
    }
);

// Get the setup commands [ { name: 'setup-sample', command: '...' }, { name: 'setup-my-bookend', command: '...' } ] given the models and configuration for the pipeline, job, and build
b.getSetupCommands({ pipeline, job, build }).then((commands) => { ... });

// Get the teardown command [ { name: 'teardown-sample', command: '...' }, { name: 'teardown-my-bookend', command: '...' } ] given the models and configuration for the pipeline, job, and build
b.getTeardownCommands({ pipeline, job, build }).then((commands) => { ... });

Testing

npm test

License

Code licensed under the BSD 3-Clause license. See LICENSE file for terms.