circa10a/go-aws-news Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

go-aws-news

从AWS获取最新动态并发送到社交媒体平台的工具。

!Build Status  ![codecov]([***]

概述

go-aws-news 是一个从AWS获取最新动态并发送到***、Slack等社交媒体平台的工具。设计用于定时运行（如每日一次），以跟踪前一天的AWS新闻。支持作为独立应用执行或作为Go模块集成到其他Go应用中。

核心功能和特性

• 多通知提供商：支持***、Rocket.Chat、Slack、SMTP（邮件）、Yammer等平台
• 灵活部署：可通过Crontab、Kubernetes CronJob或AWS Lambda定时运行
• 多样化数据获取：支持获取今日、昨日、当月、历史月份/年份的AWS新闻
• 数据格式化：支持JSON、HTML格式输出及特定产品筛选
• 可扩展性：可作为Go模块集成到其他Go应用中

使用场景和适用范围

• 团队实时跟踪AWS服务更新和公告
• 自动化AWS新闻通知到企业沟通平台（如Slack频道）
• 集成到CI/CD流程或监控系统中，同步AWS最新动态
• 作为Go库在自定义应用中获取和处理AWS新闻数据

详细使用方法和配置说明

应用安装

go-aws-news可作为独立应用执行，向社交媒体平台发送通知。需通过config.yaml配置文件启用通知提供商。

通知提供商

当前支持的通知提供商：

• ---

• Rocket.Chat
• Slack
• SMTP（邮件）
• Yammer

安装选项

通过Crontab安装

最简单的运行方式是通过Crontab定时执行：

shell
# 二进制方式
0 2 * * * /path/to/go-aws-news-binary

# Docker方式
0 14 * * * docker run -d --rm --name aws-news \
  -v your_config.yaml:/config.yaml \
  circa10a/go-aws-news

上述示例将在每天UTC时间14:00（CST时间8:00）执行go-aws-news。

作为Kubernetes CronJob安装

可在Kubernetes集群中作为CronJob运行：

示例cronjob.yaml：

yaml
apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: go-aws-news
spec:
  schedule: "0 14 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: go-aws-news
            image: circa10a/go-aws-news
            volumeMounts:
            - name: config
              mountPath: /config.yaml
              subPath: config.yaml
          volumes:
          - name: config
            configMap:
              name: awsnews-config
          restartPolicy: OnFailure

通过以下命令创建ConfigMap：

shell
kubectl create configmap awsnews-config --from-file=config.yaml

应用CronJob配置：

shell
kubectl apply -f cronjob.yaml

作为AWS Lambda安装

1. 在AWS SSM Parameter Store中设置配置：

   shell
   aws ssm put-parameter --type SecureString --name go-aws-news-config --value "$(cat config.yaml)"
   

   注意：如需自定义参数名称，需设置Lambda环境变量GO_AWS_NEWS_CONFIG_NAME。

2. 创建Lambda执行角色并附加权限：

   shell
   aws iam create-role --role-name go-aws-news-lambda-ex --assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
   
   aws iam attach-role-policy --role-name go-aws-news-lambda-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
   aws iam attach-role-policy --role-name go-aws-news-lambda-ex --policy-arn arn:aws:iam::aws:policy/AmazonSSMReadOnlyAccess
   

3. 创建Lambda函数：

   shell
   make lambda-package
   aws lambda create-function --function-name go-aws-news --zip-file fileb://bin/lambda.zip --runtime go1.x --handler awsnews \
     --role $(aws iam get-role --role-name go-aws-news-lambda-ex --query Role.Arn --output text)
   

4. 创建Lambda调度规则：

   shell
   aws events put-rule --schedule-expression "cron(0 14 * * ? *)" --name go-aws-news-cron
   
   LAMBDA_ARN=$(aws lambda get-function --function-name go-aws-news --query Configuration.FunctionArn)
   aws events put-targets --rule go-aws-news-cron --targets "Id"="1","Arn"=$LAMBDA_ARN
   

5. 允许事件规则触发Lambda：

   shell
   EVENT_ARN=$(aws events describe-rule --name go-aws-news-cron --query Arn --output text)
   
   aws lambda add-permission --function-name go-aws-news --statement-id eventbridge-cron \
     --action 'lambda:InvokeFunction' --principal events.amazonaws.com --source-arn $EVENT_ARN
   

模块安装

go-aws-news可作为Go模块集成到其他Go应用中：

shell
go get -u "github.com/circa10a/go-aws-news/news"

模块使用

模块方法返回包含公告标题、链接、发布日期的结构体切片及错误信息，支持自定义数据处理或使用Print()方法输出ASCII表格。

获取今日新闻

go
package main

import (
  awsnews "github.com/circa10a/go-aws-news/news"
)

func main() {
    news, err := awsnews.Today()
    if err != nil {
      // 错误处理
    }
    news.Print()
}

获取昨日新闻

go
news, _ := awsnews.Yesterday()

获取当月所有新闻

go
news, _ := awsnews.ThisMonth()

获取历史月份新闻

go
// 自定义时间范围（2019年6月）
news, err := awsnews.Fetch(2019, 06)

获取历史年份新闻

go
// 自定义时间范围（2017年）
news, err := awsnews.FetchYear(2017)

打印公告

go
news, _ := awsnews.ThisMonth()
news.Print()
// 控制台输出示例：
// +--------------------------------+--------------+
// |          ANNOUNCEMENT          |     DATE     |
// +--------------------------------+--------------+
// | Amazon Cognito now supports    | Jan 10, 2020 |
// | CloudWatch Usage Metrics       |              |
// +--------------------------------+--------------+

遍历新闻数据

go
// 遍历公告结构体切片
// 用于自定义数据处理
news, _ := awsnews.Fetch(time.Now().Year(), int(time.Now().Month()))
for _, v := range news {
    fmt.Printf("标题: %v\n", v.Title)
    fmt.Printf("链接: %v\n", v.Link)
    fmt.Printf("日期: %v\n", v.PostDate)
}

限制新闻结果数量

go
news, _ := awsnews.ThisMonth()
// 获取当月最后10条新闻
news.Last(10).Print()

获取JSON格式新闻

go
news, _ := awsnews.ThisMonth()
json, jsonErr := news.JSON()
if jsonErr != nil {
    log.Fatal(err)
}
fmt.Println(string(json))

获取HTML格式新闻

go
news, _ := awsnews.ThisMonth()
html := news.HTML()
fmt.Println(html)

获取特定产品新闻

go
news, err := awsnews.Fetch(2019, 12)
if err != nil {
    fmt.Println(err)
} else {
    // 筛选包含"EKS"或"ECS"的新闻
    news.Filter([]string{"EKS", "ECS"}).Print()
}

开发

测试

shell
# 单元/集成测试
make
# 获取代码覆盖率
make coverage