Skip to main content

A CLI that makes it easier to debug issues with batch compute enviornments in AWS, future plans to support GCP, Azure and kubernetes

Project description

Batch Debugging CLI

The Batch Debugging CLI is designed to streamline the debugging process for AWS Batch, GCP, Azure, and Kubernetes compute environments. Leveraging the capabilities of [batch-debugging](https://github.com/Shahbaz-mahmood123/batch-debugging).
Explore the documentation »

Table of Contents
  1. About The Project
  2. Installation
  3. Contact

About The Project

The Batch Debugging CLI is a command-line tool designed to assist in debugging batch compute environments across AWS, GCP, Azure, and Kubernetes. It currently relies on batch-debugging for its underlying logic, so refer to its documentation for detailed information on the debugging process.

Please note that the CLI assumes AWS Batch compute environments were built using the Seqera platform. However, a more generic debugging tool will be implemented in the future.

Installation

To use this library, just install the package via pip.

pip install batch-debugging-cli

Getting Started

Before using the CLI, ensure you have an account in your compute provider, a valid compute enviornment and credentials to access the account(AWS, GCP, Azure)

Currently, the CLI supports a few commands, and it expects the environment name to match the corresponding AWS environment. When supplying a compute environment ID, provide the full name of the environment (e.g., TowerForge-1rVcJ5K5wnvky3zohO4EaN-head).

AWS

For AWS please declare the region where your batch enviornmets are located. For example:

export AWS_REGION=us-east-1

Additionally the below IAM permissions are required.

GCP

To use the GCP commands please use the set the below enviornment variables:

export GCP_PROJECT_ID=test-environment
export GCP_REGION=us-central1

For Seqera platform, please declare the below two enviornment variables prior to attempting to run any of the seqera cli commands:

export PLATFORM_TOKEN=
export PLATFORM_URL=

Contact

Shahbaz Mahmood - shahbazmahmooood@gmail.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

batch_debugging_cli-0.0.9.tar.gz (5.6 kB view hashes)

Uploaded Source

Built Distribution

batch_debugging_cli-0.0.9-py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page