Skip to content

coffeegist/bob-the-builder

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
bob
 
 
 
 
 
 

Bob the Builder

Can we build it? Yes we can! Bob is a framework for automating builds for payloads in a "scriptably" configurable way. Read more at https://coffeegist.com/security/automation-through-azure-with-bob/.

Dependencies

To ensure use of python virtual environments on Ubuntu, run the following command to install the necessary packages.

sudo apt-get install python3-venv

Installation

git clone git@github.com:coffeegist/bob-the-builder.git
cd bob-the-builder
python3 -m venv venv
. ./venv/bin/activate
pip install -r requirements.txt

Setup

Copy and edit the bob-config.json file to include a personal access token and organization url to the Azure DevOps account of your choosing.

cd bob
cp bob-config.json.sample bob-config.json

Running

For this project to function, you need to have access to an Azure DevOps account that has pre-existing pipelines configured to build payloads.

Creating a token

Login to https://dev.azure.com/YOUR_USERNAME/_usersSettings/tokens

  • Click + New Token
    • Name: “Bob”
    • Organization: "<YOUR_ORG_HERE>"
    • Scope: Full Access
    • Click Create

Configuring a blueprint

Once you have access, run the following command to configure a blueprint:

python bob.py configure -f my-blueprint.json

Queueing a blueprint

Feel free to modify your blueprint manually, especially if you are building a pipeline that has queue-time variables. Then, using your newly configured blueprint, my-blueprint.json:

python bob.py run -f my-blueprint.json -o ./build-artifacts

When you're finished...

This project obviously uses virtual environments (venv). When you're done with Bob, just deactivate your virtual environment by issuing the following command:

deactivate

That's it!!

Please post any issues you come across!

About

An azure devops tool for moar automation :D

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages