如何在Jenkins中使用Groovy向AWS SNS主题发布消息

当然可以！在Jenkins任务里用Groovy向AWS SNS发送消息完全可行，而且有两种主流方案可以选——一种是直接借助Groovy对Java的兼容性调用AWS SDK，另一种是用Jenkins官方的AWS插件简化操作，我给你详细拆解下：

因为Groovy是基于JVM的语言，完全兼容Java的API，所以你可以直接用AWS的Java SDK来实现SNS消息发布，不需要额外的转换。

步骤说明： #

1. 确保权限配置：如果Jenkins部署在AWS EC2上，最好给EC2实例绑定具备sns:Publish权限的IAM角色；如果是自建服务器，可以在Jenkins里配置AWS Access Key/Secret Key（不建议硬编码，推荐用Jenkins凭证管理）。
2. 引入AWS SDK依赖：确保Jenkins的运行环境里有AWS SDK v2的相关jar包（如果是Pipeline脚本，也可以用@Grab注解动态拉取，但需要开启Jenkins的脚本审批）。

代码示例： #

import software.amazon.awssdk.regions.Region
import software.amazon.awssdk.services.sns.SnsClient
import software.amazon.awssdk.services.sns.model.PublishRequest

// 配置基础参数
def awsRegion = Region.US_EAST_1
def snsTopicArn = "arn:aws:sns:us-east-1:123456789012:your-target-topic"
def notificationMessage = "Jenkins任务 ${env.JOB_NAME} 构建完成，状态：${env.BUILD_STATUS}"

// 创建SNS客户端
SnsClient snsClient = SnsClient.builder()
    .region(awsRegion)
    // 如果不用IAM角色，这里可以指定凭证（推荐用Jenkins凭证管理获取，不要硬编码）
    // .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secretKey)))
    .build()

// 构造发布请求
PublishRequest publishReq = PublishRequest.builder()
    .topicArn(snsTopicArn)
    .message(notificationMessage)
    .subject("Jenkins构建通知") // 邮件订阅会显示这个主题，可选
    .build()

// 发送消息并处理结果
try {
    def response = snsClient.publish(publishReq)
    echo "SNS消息发送成功，消息ID：${response.messageId()}"
} catch (Exception e) {
    echo "发送SNS消息失败：${e.getMessage()}"
    throw e // 可选，是否让构建标记为失败
} finally {
    if (snsClient != null) {
        snsClient.close()
    }
}

Jenkins官方提供了AWS相关插件，其中包含了SNS发布的封装功能，不需要自己管理客户端和依赖，用起来更简洁。

步骤说明： #

1. 安装必备插件：在Jenkins插件市场搜索并安装AWS Credentials和AWS SDK插件（或直接安装集成了SNS功能的AWS插件包）。
2. 配置全局凭证：在Jenkins全局配置里添加AWS凭证（选择Access Key/Secret Key或IAM角色），并记录凭证ID。
3. 在Pipeline中调用插件方法：

代码示例（声明式Pipeline）： #

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                // 这里放你的构建逻辑，比如编译、测试等
                echo "执行构建步骤..."
            }
        }
    }
    post {
        // 构建成功时发送通知
        success {
            awsSnsPublish(
                topicArn: "arn:aws:sns:us-east-1:123456789012:your-target-topic",
                message: "✅ Jenkins任务 ${env.JOB_NAME} 构建成功！编号：${env.BUILD_NUMBER}",
                subject: "Jenkins构建成功通知",
                awsCredentials: "your-aws-credential-id", // 对应全局配置的凭证ID
                region: "us-east-1"
            )
        }
        // 构建失败时发送通知
        failure {
            awsSnsPublish(
                topicArn: "arn:aws:sns:us-east-1:123456789012:your-target-topic",
                message: "❌ Jenkins任务 ${env.JOB_NAME} 构建失败！编号：${env.BUILD_NUMBER}",
                subject: "Jenkins构建失败通知",
                awsCredentials: "your-aws-credential-id",
                region: "us-east-1"
            )
        }
    }
}

一些小贴士： #

• 权限验证：不管用哪种方案，都要确保执行Jenkins任务的身份（实例角色或凭证）拥有目标SNS主题的sns:Publish权限，建议通过IAM策略精确控制。
• 脚本审批：如果在Pipeline里用@Grab或者自定义Groovy脚本，可能需要在Jenkins的“脚本安全”里审批相关代码，避免执行被拦截。
• 异常处理：生产环境中建议添加异常捕获逻辑，避免因SNS发送失败导致整个构建流程中断（除非你希望这样）。

内容的提问来源于stack exchange，提问作者Monish Das