Az-TUI

Az-TUI is a terminal user interface (TUI) designed for managing Azure Container Apps, providing a robust alternative to traditional graphical interfaces. It enables users to efficiently browse Container Apps, inspect application details, monitor revisions, and access logs or shell sessions directly within a terminal. This utility is inspired by popular tools like K9s and brings several key functionalities to enhance productivity in managing Azure resources.

Key Features

• Explore Azure Container Apps across subscriptions and filter by resource groups using the ACA_RG environment variable.
• Detailed Application Information: View comprehensive app data in JSON format, including name, resource group, location, ingress FQDN, and the latest revision.
• Revision Insights: Inspect revisions with active indicators and traffic distributions.
• Log Monitoring: Tail logs for applications, specific revisions, or individual containers.
• Container Debugging: Exec into running containers for in-depth debugging efforts.
• User-Friendly Navigation: Navigate with ease through the terminal using keyboard shortcuts and a familiar interface.
• Mock Data Functionality: A mock mode is available for development and testing purposes, negating the need for an Azure CLI connection.

Navigation and Key Bindings

Az-TUI features keyboard-driven navigation that supports VIM/k9s-like context switching:

• Press : to access the context menu and switch views efficiently.
• Navigate through options using arrow keys or the ↑/↓ keys and confirm selections with Enter.
• Contexts automatically preserve the user's selection state, ensuring a seamless navigation experience.

Global Shortcuts

• q / Ctrl+C: Exit
• /: Filter list
• Esc: Return to previous view
• ?: Show help

Through modes for resource groups, apps, revisions, containers, and environment variables, users can manage their Azure Container Apps intuitively:

Applications Mode Shortcuts

• r: Refresh application list
• R: Restart application revision
• l: Fetch logs for the application
• s: Exec into the application
• v: View environment variables

Revisions and Containers

• Easily refresh, restart, and access logs for both revisions and containers.
• Explore the environment variables associated with either revisions or containers effortlessly.

Mock Data Mode

For testing and demonstration, Az-TUI can function using mock data that mimics real-world scenarios:

./az-tui --mock

This mode includes a variety of resource groups, container apps, and configurations that allow comprehensive testing of the TUI without the need for a live Azure environment.

Architectural Overview

Built on the Bubble Tea framework, Az-TUI emphasizes modularity and efficient data presentation with features including:

• Asynchronous data updates and management through a message-based model.
• A comprehensive help system accessible within the application.
• Persistent state across context switches for a fluid user experience.

Future Enhancements

Plans for future development include additional features such as subscription switching, health monitoring for container replicas, and enhanced integration of Azure metrics.

With Az-TUI, managing Azure Container Apps becomes significantly more accessible, allowing developers and system admins to interact with their applications in a streamlined and efficient manner.