#status #aws #terminal #aws-codebuild #aws-codebuild-status

aws-codebuild-status_aws

AWS-Codebuild status in the terminal

1 unstable release

0.6.0 Jun 13, 2019

#2 in #aws-codebuild


Used in 2 crates

MIT license

10KB
244 lines

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

screenshot

Webpage

screenshot

Dependencies

~20MB
~357K SLoC