Run CLI

Run CLI is an interactive CLI to manage your Google Cloud Run resources with panache!

✨ Features

• Interactive TUI: A user-friendly terminal interface to manage your Cloud Run resources.
• Service Management: View, search, and manage your Cloud Run services.
• Service Dashboard: Navigate to a dedicated dashboard for each service with multiple views.
• Networking View: Monitor ingress settings, endpoints status (URI, IAP), and VPC Access configurations.
• Security View: Check authentication requirements, service identity, encryption keys, and binary authorization policies.
• Revision Management: Detailed list of revisions with traffic allocation, tags, and deployment history.
• Deep Insights: Explore revision details including billing mode, startup CPU boost, concurrency, and request timeouts.
• Resource Monitoring: View container configurations, images, ports, and resource limits (Memory, CPU, and GPU/Accelerators).
• Job Management: Monitor and manage your Cloud Run jobs.
• Log Viewer: Stream logs from your services directly in the terminal.
• Project & Region Selection: Easily switch between your Google Cloud projects and regions.

🚀 Installation

Run CLI is available on Linux, OSX and Windows platforms.

• Binaries for Mac OS, Linux and Windows are available as tarballs in the release page.

• Via Homebrew (Mac OS) or LinuxBrew (Linux)

  brew tap julienbreux/run
  brew install --cask julienbreux/run/run

• Via go get

  You can install Run CLI using go install:

  go install github.com/JulienBreux/run-cli/cmd/run@latest

• Via CURL

  You can install Run CLI using CURL and the shell script:

  curl -sL https://JulienBreux.github.io/run-cli/get | sh

▶️ Usage

Simply run the command:

gcloud auth application-default login # Currently mandatory :/
run

This will start the interactive TUI, allowing you to manage your Google Cloud Run resources.

🛠️ Development

This project uses a Makefile to streamline development.

Prerequisites

• Go
• Docker (for building the Docker image)

Build from source

To build the binary from source, run:

make build

This will create the run executable in the ./bin directory.

Running tests

To run the unit tests:

make test

Linting

To lint the codebase:

make lint

💪 Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue.

📄 License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.