How microsoft/powerplatform-build-tools works
Main Components
a. Core Components:
• Power Platform CLI Integration Layer
• Task Execution Engine
• Authentication Handler
• Build Tools Host
• Pipeline Variables Manager
b. Task Categories:
• Solution Management Tasks
• Environment Management Tasks
• Data Operations Tasks
• Security & Governance Tasks
• Portal Management Tasks
Component Relationships
Layer 1 - Client Interface:
• Azure DevOps Pipeline Integration
• Azure Pipeline Variables
• Service Connections
Layer 2 - Build Tools Core:
• Task Parser
• Build Tools Host
• Authentication Manager
• CLI Locator
Layer 3 - Task Implementation:
• Tasks by category (Solution, Environment, Data, etc.)
• Common shared components between tasks
Layer 3 - External Integration:
• Power Platform CLI
• Power Platform Environments
• Source Control Systems
Specific Implementation Details
• Blue rectangles: Core components
• Green rectangles: Task implementations
• Yellow diamonds: External services
• Purple rectangles: Authentication components
• Gray rectangles: Supporting utilities
Connection Types
• Double lines: Two-way communication
Key Elements to Highlight
a. Authentication Flow:
• How credentials are handled
• Demonstrate service connection usage
• Environment URL resolution
b. Task Execution Flow:
• Pipeline variable processing
• CLI command generation
• Task execution and monitoring
c. External Integration Points:
• Power Platform CLI interaction
• Environment management
• Source control integration
Implementation Notes
• src/host for core hosting functionality
• src/params for parameter handling
• src/tasks for individual task implementations
• src/parser for pipeline definition parsing
Technical Details
• TypeScript/Node.js runtime environment
• Azure DevOps extension packaging
• CLI tool dependencies
• Cross-platform support indicators
• Layered architecture representation
• Export to common formats
• Version control friendly format