AWS-Codebuild-Status

Small rust terminal application that lists all AWS-Codebuild projects and their current status.

Preparation

• Create a new IAM User
• The following permissions are needed:
  • Replace REGION and ACCOUNT

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "codebuild:BatchGetProjects",
                "codebuild:BatchGetBuilds"
            ],
            "Resource": "arn:aws:codebuild:REGION:ACCOUNT:project/*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "codebuild:ListBuilds",
                "codebuild:ListProjects"
            ],
            "Resource": "*"
        }
    ]
}

Usage

Cli

• Download the binary from the release page, you can choose between a statically and dynamically compiled version
• Start it with ./aws-codebuild-status

Or

Install it with cargo install aws-codebuild-status

Provide AWS credentials

The recommended way is to use the aws-cli.

• Run aws configure
• Set the AWS Access Key ID and Aws Secret Access Key
• The region should set to the region where all projects are located
  • if not, the default region from aws will be used
• The output format needs to be json

As an alternative, the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY can be set.

The usage of instance profiles is also supported.

Server

• Download the latest release from the release page, you can choose between a statically and dynamically compiled version
• Start the server with ./aws-codebuild-status_server
• Open a browser and navigate to localhost:8081, it will return a static webpage

Screenshots

Terminal

Webpage