How azure/azure-cli works
Azure CLI is a command-line client for managing Azure resources. The main user workflow is to invoke az with a command and arguments, parse and dispatch the request to a command module, make Azure API calls, and present a result. The core also provides authentication, cloud-aware SDK clients, output and help support, extensions, and telemetry. The README documents capabilities such as completion, query expressions, output formats, and REST commands; their detailed runtime wiring is not fully shown in the sampled source, so some relationships remain unverified.
Main entry points: command_modules Command modules · client_factory.py SDK client factory · parser.py Argument parser · _client.py AAZ HTTP client
Components 23
CLI interaction
- CLI entry
src/azure-cli/azure/cli/__main__.py - Argument parser
src/azure-cli-core/azure/cli/core/parser.py
CLI core
- Atomic commands
src/azure-cli-core/azure/cli/core/aaz/_base.py - AAZ HTTP client
src/azure-cli-core/azure/cli/core/aaz/_client.py - SDK client factory
src/azure-cli-core/azure/cli/core/commands/client_factory.py - Subscription profile
src/azure-cli-core/azure/cli/core/_profile.py - HTTP session
src/azure-cli-core/azure/cli/core/_session.py - Cloud endpoints
src/azure-cli-core/azure/cli/core/cloud.py - SDK policies
src/azure-cli-core/azure/cli/core/sdk/policies.py - Output and query
src/azure-cli-core/azure/cli/core/_output.py - Help and completion
src/azure-cli-core/azure/cli/core/_help.py - Extensions
src/azure-cli-core/azure/cli/core/extension/__init__.py
Azure commands
- Command modules
src/azure-cli/azure/cli/command_modules - Resource commands
src/azure-cli/azure/cli/command_modules/resource/custom.py - Template packing
src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py - Storage operations
src/azure-cli/azure/cli/command_modules/storage/operations/logging.py - App deployment
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py - Container Apps
src/azure-cli/azure/cli/command_modules/containerapp/_clients.py
Shared services
- Telemetry
src/azure-cli-core/azure/cli/core/telemetry.py - Telemetry client
src/azure-cli-telemetry/azure/cli/telemetry/__init__.py - CLI errors
src/azure-cli-core/azure/cli/core/azclierror.py
Other components
- CLI user
- Azure services
Connections 28
- CLI user → CLI entry: runs commands
- CLI entry → Argument parser: parses input
- Argument parser → Command modules: dispatches commands
- Argument parser → Extensions: loads extensions
src/azure-cli-core/azure/cli/core/parser.py - Argument parser → Telemetry: reports errors
src/azure-cli-core/azure/cli/core/parser.py - Command modules → Resource commands: includes
src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py - Resource commands → Template packing: packages templates
src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py - Command modules → Storage operations: includes
- Command modules → App deployment: includes
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py - Command modules → Container Apps: includes
src/azure-cli/azure/cli/command_modules/containerapp/_clients.py - Command modules → Atomic commands: uses command layer
- Atomic commands → AAZ HTTP client: issues operations
- SDK client factory → Subscription profile: gets subscription
src/azure-cli-core/azure/cli/core/commands/client_factory.py - SDK client factory → SDK policies: configures policies
src/azure-cli-core/azure/cli/core/commands/client_factory.py - SDK client factory → Extensions: resolves extensions
src/azure-cli-core/azure/cli/core/commands/client_factory.py - SDK client factory → Azure services: creates service clients
- AAZ HTTP client → Cloud endpoints: reads endpoints
src/azure-cli-core/azure/cli/core/aaz/_client.py - AAZ HTTP client → SDK policies: configures policies
src/azure-cli-core/azure/cli/core/aaz/_client.py - AAZ HTTP client → Azure services: sends API requests
- HTTP session → Azure services: sends HTTP requests
- Output and query → CLI user: formats results
- Help and completion → CLI user: supports help
- Telemetry → Telemetry client: uses telemetry package
src/azure-cli-core/azure/cli/core/util.py - CLI errors → Telemetry: records failures
src/azure-cli-core/azure/cli/core/azclierror.py - Resource commands → Azure services: manages resources
- Storage operations → Azure services: manages storage
- App deployment → Azure services: deploys apps
- Container Apps → Azure services: manages containers