1- # go-aws-news
1+ # go-aws-news <!-- omit in toc -->
22
33Fetch what's new from AWS and send out notifications on social sites.
44
@@ -11,28 +11,28 @@ Fetch what's new from AWS and send out notifications on social sites.
1111![ sourcegraph] ( https://sourcegraph.com/github.com/circa10a/go-aws-news/-/badge.svg )
1212[ ![ codecov] ( https://codecov.io/gh/circa10a/go-aws-news/branch/master/graph/badge.svg?token=1OLAEVOAIO )] ( https://codecov.io/gh/circa10a/go-aws-news )
1313
14- [ go-aws-news ] ( #go-aws-news )
15- * [ App Install ] ( #app-install )
16- - [ Notification Providers ] ( #notification-providers )
17- - [ Install Options ] ( #install-options )
18- * [ Install With Crontab ] ( #install-with-crontab )
19- * [ Install As Kubernetes CronJob ] ( #install-as-kubernetes-cronjob )
20- * [ Module Install] ( #module-install )
21- * [ Module Usage] ( #module-usage )
22- - [ Get Today's news] ( #get-todays-news )
23- - [ Get Yesterday's news] ( #get-yesterdays-news )
24- - [ Get all news for the month] ( #get-all-news-for-the-month )
25- - [ Get from a previous month] ( #get-from-a-previous-month )
26- - [ Get from a previous year] ( #get-from-a-previous-year )
27- - [ Print out announcements] ( #print-out-announcements )
28- - [ Loop over news data] ( #loop-over-news-data )
29- - [ Limit news results count] ( #limit-news-results-count )
30- - [ Get news as JSON] ( #get-news-as-json )
31- - [ Get news as HTML] ( #get-news-as-html )
32- - [ Get news about a specific product] ( #get-news-about-a-specific-product )
33- * [ Google Assistant Integration ] ( #google-assistant )
34- * [ Development] ( #development )
35- + [ Test] ( #test )
14+ - [ App Install ] ( #app-install )
15+ - [ Notification Providers ] ( #notification-providers )
16+ - [ Install Options ] ( #install-options )
17+ - [ Install With Crontab ] ( #install-with-crontab )
18+ - [ Install As Kubernetes CronJob ] ( #install-as-kubernetes-cronjob )
19+ - [ Install As AWS Lambda ] ( #install-as-aws-lambda )
20+ - [ Module Install] ( #module-install )
21+ - [ Module Usage] ( #module-usage )
22+ - [ Get Today's news] ( #get-todays-news )
23+ - [ Get Yesterday's news] ( #get-yesterdays-news )
24+ - [ Get all news for the month] ( #get-all-news-for-the-month )
25+ - [ Get from a previous month] ( #get-from-a-previous-month )
26+ - [ Get from a previous year] ( #get-from-a-previous-year )
27+ - [ Print out announcements] ( #print-out-announcements )
28+ - [ Loop over news data] ( #loop-over-news-data )
29+ - [ Limit news results count] ( #limit-news-results-count )
30+ - [ Get news as JSON] ( #get-news-as-json )
31+ - [ Get news as HTML] ( #get-news-as-html )
32+ - [ Get news about a specific product] ( #get-news-about-a-specific-product )
33+ - [ Google Assistant] ( #google-assistant )
34+ - [ Development] ( #development )
35+ - [ Test] ( #test )
3636
3737## App Install
3838
@@ -115,6 +115,52 @@ To apply the `cronjob.yaml` example above:
115115kubectl apply -f cronjob.yaml
116116```
117117
118+ #### Install As AWS Lambda
119+
120+ 1 . Setup provider config in AWS SSM Parameter Store:
121+
122+ ``` shell
123+ aws ssm put-parameter --type SecureString --name go-aws-news-config --value " $( cat config.yaml) "
124+ ```
125+
126+ > ** Note:** Overriding the name ` go-aws-news-config`
127+ the lambda function: ` GO_AWS_NEWS_CONFIG_NAME`
128+
129+ 1. Create the Lambda execution role and add permissions:
130+
131+ ` ` ` shell
132+ 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"}]}'
133+
134+ aws iam attach-role-policy --role-name go-aws-news-lambda-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
135+ aws iam attach-role-policy --role-name go-aws-news-lambda-ex --policy-arn arn:aws:iam::aws:policy/AmazonSSMReadOnlyAccess
136+ ` ` `
137+
138+ 1. Create the lambda function:
139+
140+ ` ` ` shell
141+ make lambda-package
142+ aws lambda create-function --function-name go-aws-news --zip-file fileb://bin/lambda.zip --runtime go1.x --handler awsnews \
143+ --role $( aws iam get-role --role-name go-aws-news-lambda-ex --query Role.Arn --output text)
144+ ` ` `
145+
146+ 1. Create a schedule for the lambda:
147+
148+ ` ` ` shell
149+ aws events put-rule --schedule-expression " cron(0 14 * * ? *)"
150+
151+ LAMBDA_ARN=$( aws lambda get-function --function-name go-aws-news --query Configuration.FunctionArn)
152+ aws events put-targets --rule go-aws-news-cron --targets " Id" " 1" " Arn" $LAMBDA_ARN
153+ ` ` `
154+
155+ 1. Allow the lambda function to be invoked by the schedule rule:
156+
157+ ` ` ` shell
158+ EVENT_ARN=$( aws events describe-rule --name go-aws-news-cron --query Arn --output text)
159+
160+ aws lambda add-permission --function-name go-aws-news --statement-id eventbridge-cron \
161+ --action ' lambda:InvokeFunction' $EVENT_ARN
162+ ` ` `
163+
118164# # Module Install
119165
120166` go-aws-news` for use in other Go applications:
@@ -127,7 +173,7 @@ go get -u "github.com/circa10a/go-aws-news/news"
127173
128174Methods return a slice of structs which include the announcement title, a link, and the date it was posted as well an error. This allows you to manipulate the data in whichever way you please, or simply use `Print ()` to print a nice ASCII table to the console.
129175
130- #### Get Today's news
176+ # ## Get Today's news
131177
132178` ` `
133179package main
@@ -145,33 +191,33 @@ func main() {
145191}
146192` ` `
147193
148- #### Get Yesterday's news
194+ # ## Get Yesterday's news
149195
150196` ` `
151197news, _ := awsnews.Yesterday ()
152198` ` `
153199
154- #### Get all news for the month
200+ # ## Get all news for the month
155201
156202` ` `
157203news, _ := awsnews.ThisMonth ()
158204` ` `
159205
160- #### Get from a previous month
206+ # ## Get from a previous month
161207
162208` ` `
163209// Custom timeframe(June 2019)
164210news, err := awsnews.Fetch(2019, 06)
165211` ` `
166212
167- #### Get from a previous year
213+ # ## Get from a previous year
168214
169215` ` `
170216// Custom timeframe(2017)
171217news, err := awsnews.FetchYear(2017)
172218` ` `
173219
174- #### Print out announcements
220+ # ## Print out announcements
175221
176222` ` `
177223news, _ := awsnews.ThisMonth ()
@@ -189,7 +235,7 @@ news.Print()
189235//
190236` ` `
191237
192- #### Loop over news data
238+ # ## Loop over news data
193239
194240` ` `
195241// Loop slice of stucts of announcements
@@ -202,15 +248,15 @@ for _, v := range news {
202248}
203249` ` `
204250
205- #### Limit news results count
251+ # ## Limit news results count
206252
207253` ` `
208254news, _ := awsnews.ThisMonth ()
209255// Last 10 news items of the month
210256news.Last(10).Print ()
211257` ` `
212258
213- #### Get news as JSON
259+ # ## Get news as JSON
214260
215261` ` `
216262news, _ := awsnews.ThisMonth ()
@@ -221,15 +267,15 @@ if jsonErr != nil {
221267fmt.Println(string(json))
222268` ` `
223269
224- #### Get news as HTML
270+ # ## Get news as HTML
225271
226272` ` `
227273news, _ := awsnews.ThisMonth ()
228274html := news.HTML ()
229275fmt.Println(html)
230276` ` `
231277
232- #### Get news about a specific product
278+ # ## Get news about a specific product
233279
234280` ` `
235281news, err := awsnews.Fetch(2019, 12)
0 commit comments