yamlizr 4.2.3

CasCap.DevOpsYamlizrCli

The yamlizr .NET global tool and container image. Converts Azure DevOps Classic Designer Build and Release Definitions, and any Task Groups they reference, into Azure Pipelines YAML or GitHub Actions workflows.

For installation and usage see the repository README.

Purpose

This project owns the command surface, console presentation and orchestration only. Everything that understands Azure DevOps or YAML lives in CasCap.Api.AzureDevOps.

Commands

CommandBase holds the shared Azure DevOps connection, the typed clients and the progress bar options. It reports authentication and project lookup failures through ILogger<T> and an actionable console message rather than swallowing them.

Configuration

Configuration is layered, with a command line option always winning over a configured value:

1. appsettings.json next to the tool
2. appsettings.json in the current working directory
3. .NET User Secrets
4. environment variables

The bindable shape is CasCap:AzureDevOpsOptions, see AzureDevOpsOptions.

Service Architecture

flowchart TD
    CLI([yamlizr generate]) --> Host[Generic Host]
    Host --> Config[appsettings, user secrets, environment]
    Host --> Cmd[GenerateCommand]
    Cmd --> Conn[VssConnection]
    Conn --> AzDO[(Azure DevOps)]
    Cmd --> Gen[YamlPipelineGenerator]
    Gen --> Yaml[(YAML files on disk)]
    Gen --> Warn[Run summary of unconverted constructs]

Dependencies