Toolbox CLI

The primary function is to help manage and connect to PostHog toolbox pods in a Kubernetes environment.

Installation

1. Ensure you have Python 3.x installed on your system

2. Clone this repository or download toolbox.py

3. Make the script executable (Unix-based systems):

   bashCopy

   chmod +x toolbox.py
   

Requirements

• Python 3.x
• kubectl installed and configured
• your current settings and k8s context let you access the cluster that you want your toolbox to be claimed in

Usage

Run the script using Python:

python toolbox.py [flags]

Or directly (Unix-based systems):

./toolbox.py [flags]

What it Does

The toolbox CLI:

1. Authenticates your AWS identity
2. Finds an available PostHog toolbox pod or connects to one you've already claimed
3. Claims the pod for a specified duration (default 12 hours)
4. Provides an interactive shell session to the pod
5. Offers to delete the pod when you exit the shell

Available Flags

Examples

1. Connect to a pod with default 12-hour claim:

python toolbox.py

2. Connect to a pod with a custom claim duration:

python toolbox.py --claim-duration 4

3. Extend the duration of your existing pod:

python toolbox.py --update-claim --claim-duration 24

Notes

• If no pods are available, the script will wait up to 5 minutes for a pod to become available
• When you exit the pod shell, you'll be prompted whether to delete the pod
• If something doesn't work as expected, reach out to #team-infrastructure for assistance