理解Azure Pipeline的日志渲染机制
在本地开发环境中，如intellij idea的控制台，logback可以通过patternlayoutencoder中定义的颜色模式（例如%blue、%highlight）来生成ansi转义序列，从而在支持ansi的终端中显示彩色日志。然而，azure pipeline的构建日志控制台并非一个标准的ansi终端模拟器。它有自己一套特殊的机制来处理日志输出，以提供结构化和高亮显示。azure pipeline通过识别日志消息中的特定前缀来应用颜色、分组或创建可折叠的区域。这意味着传统的logback颜色模式在azure pipeline中将无法生效，只会将颜色编码字符作为普通文本输出。
Azure Pipeline的特殊日志命令
为了在Azure Pipeline中实现类似颜色高亮的效果，需要使用微软提供的预定义日志命令前缀。这些前缀会被Azure Pipeline解析，并相应地渲染日志：
- ##[error]: 将后续文本显示为红色错误信息。
- ##[warning]: 将后续文本显示为黄色警告信息。
- ##[debug]: 将后续文本显示为调试信息。
- ##[command]: 标识一个正在执行的命令。
- ##[group]: 标记一个可折叠的日志组的开始。
- ##[endgroup]: 标记一个日志组的结束。
- ##[section]: 标记一个日志部分的开始。
例如，如果你想输出一个警告信息，你需要让Logback输出的字符串以##[warning]开头，而不是依赖Logback自身的颜色编码。
Logback的条件配置：适配多环境日志输出
为了同时满足本地开发环境的彩色日志需求和Azure Pipeline的特殊日志渲染要求，我们可以利用Logback的条件配置功能。通过在logback.xml配置文件中使用
以下是一个示例配置，它通过检查名为LOG_ENV的环境变量来决定使用哪种日志模式：
logback.xml 示例配置
INFO ACCEPT DENY %blue([%d{ISO8601, Europe/Paris}]) [%t] %blue([%logger{100}]:) %green(%msg%n%throwable) [INFO][%d{ISO8601, Europe/Paris}] [%t] [%logger{100}]: %msg%n%throwable WARN ACCEPT DENY %blue([%d{ISO8601, Europe/Paris}]) [%t] %blue([%logger{100}]:) %yellow(%msg%n%throwable) ##[WARNING][%d{ISO8601, Europe/Paris}] [%t] [%logger{100}]: %msg%n%throwable
关键点解析：
-
LOG_ENV 环境变量：在本地开发时，设置 LOG_ENV=LOCAL。在Azure Pipeline中运行时，不设置或设置为其他值，Logback将执行
分支。 - property("LOG_ENV").equals("LOCAL")：这是Logback条件判断的语法，用于读取名为LOG_ENV的系统属性或环境变量。
-
和 ：分支 - 在
分支中，配置PatternLayoutEncoder使用Logback的内置颜色模式（如%blue、%green、%yellow）。 - 在
分支中，配置PatternLayoutEncoder直接在日志消息前添加Azure Pipeline的特殊前缀（如##[WARNING]）。请注意，对于INFO级别，Azure Pipeline没有默认的颜色前缀，因此可以直接输出不带特殊前缀的日志，或者根据需要使用##[debug]等。
- 在
依赖配置
为了使Logback正常工作，需要在项目的pom.xml（Maven项目）或build.gradle（Gradle项目）中添加相应的依赖：
ch.qos.logback logback-classic 1.4.4 org.slf4j slf4j-api 2.0.3 ch.qos.logback logback-core 1.4.4
在Azure Pipeline中设置环境变量
要在Azure Pipeline中启用上述配置，你需要在你的azure-pipelines.yml文件中确保LOG_ENV环境变量未被设置为LOCAL，或者干脆不设置它，以便Logback执行
例如，在你的YAML文件中：
variables:
# 在Azure Pipeline中，不设置LOG_ENV为LOCAL，或设置为其他值
# LOG_ENV: 'AZURE' # 也可以显式设置为非LOCAL的值
steps:
- task: Maven@3
inputs:
mavenPomFile: 'pom.xml'
goals: 'clean install'
publishJUnitResults: true
testResultsFiles: '**/surefire-reports/TEST-*.xml'
javaHomeOption: 'JDKVersion'
jdkVersionOption: '1.11'
mavenVersionOption: 'Default'
mavenAuthenticateFeed: false
effectivePomSkip: false
sonarQubeRunAnalysis: false总结与注意事项
通过Logback的条件配置，可以优雅地解决在不同环境中日志颜色显示不一致的问题。这种方法不仅保证了本地开发时的可读性，也确保了在Azure Pipeline中能够利用其原生的日志渲染能力，从而提升CI/CD流程中日志分析的效率。
注意事项：
- Logback版本兼容性：确保使用的Logback版本支持条件配置（通常较新版本都支持）。
- 环境变量管理：在不同的部署环境中，正确设置或不设置LOG_ENV环境变量至关重要。
- 日志级别：为不同日志级别（INFO, WARN, ERROR, DEBUG）分别配置appender和其内部的条件模式，可以实现更精细的控制。对于ERROR级别，应使用##[error]前缀；对于DEBUG级别，可以使用##[debug]前缀。
- 自定义前缀：除了微软提供的标准前缀，避免在Azure Pipeline日志中创建自己的颜色或格式化逻辑，因为它们可能不会被正确解析。
-
调试：如果在Azure Pipeline中日志颜色仍不生效，请检查：
- logback.xml文件是否被正确加载。
- LOG_ENV环境变量在Azure Pipeline中是否被意外设置为LOCAL。
- Logback的内部状态日志（通过移除NopStatusListener）可能会提供有用的线索。
