Bit3

Bit3 is a simple tool to download a BitBucket repository and upload to an AWS S3 bucket.

The main purpose of this tool is to work around a missing feature and allow BitBucket to be used as a source with AWS CodePipeline. Currently BitBucket cannot be used as a CodePipeline source, so alternatively, we can use S3 instead, and push a repository contents to S3 which can trigger the pipeline.

Installation

# Install the cli tool
$ npm install -g bit3

Usage

# Deploy the default application (see configuration below)
$ bit3 default

Configuration

The configuration file is located at ~/.config/bit3.json and consists of the following options.

{
        "default": {
                "repositoryAccount": "<user or team>",
                "repositoryName": "<repository name>",
                "repositoryBranch": "<repository branch>",
                "appUsername": "<login username>",
                "appPassword": "<app password>",
                "awsProfile": "<aws credentials file profile>",
                "s3Bucket": "<bucket>",
                "s3Key": "<bucket key>"
        }
}

Options

Option	Description
repositoryAccount	The BitBucket username or team that the repository resides under.
repositoryName	The BitBucket repository name.
repositoryBranch	The BitBucket repository branch. Defaults to master.
appUsername	The username of the BitBucket account, (not the Atlassian login email). This can be found within BitBucket profile settings.
appPassword	An App password. Created within the BitBucket profile settings.
awsProfile	The profile to use within the aws credtials file, ~/.aws/credentials. Defaults to bit3.
s3Bucket	The S3 bucket to upload to.
s3Key	The key of the S3 bucket for the uploaded zip file.

License: MIT

Author: Ash Brown