{"id":21578099,"url":"https://github.com/maasglobal/ecs-event-notifications","last_synced_at":"2025-04-10T17:29:48.883Z","repository":{"id":84295230,"uuid":"131755069","full_name":"maasglobal/ecs-event-notifications","owner":"maasglobal","description":null,"archived":false,"fork":false,"pushed_at":"2020-07-02T15:10:13.000Z","size":88,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-07-14T16:58:28.409Z","etag":null,"topics":["aws","ecs-service","fargate","serverless"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maasglobal.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-05-01T19:37:07.000Z","updated_at":"2022-02-17T15:43:56.000Z","dependencies_parsed_at":"2023-09-23T10:44:08.558Z","dependency_job_id":null,"html_url":"https://github.com/maasglobal/ecs-event-notifications","commit_stats":{"total_commits":16,"total_committers":2,"mean_commits":8.0,"dds":0.375,"last_synced_commit":"e6c087059a3051e7d930c3a5861d854248386215"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maasglobal%2Fecs-event-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maasglobal%2Fecs-event-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maasglobal%2Fecs-event-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maasglobal%2Fecs-event-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maasglobal","download_url":"https://codeload.github.com/maasglobal/ecs-event-notifications/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226165745,"owners_count":17583856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","ecs-service","fargate","serverless"],"created_at":"2024-11-24T13:09:37.136Z","updated_at":"2024-11-24T13:09:37.776Z","avatar_url":"https://github.com/maasglobal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ECS State Change Notifications\n\n[![serverless](http://public.serverless.com/badges/v3.svg)](http://www.serverless.com)\n[![Build Status](https://travis-ci.org/maasglobal/ecs-event-notifications.svg?branch=master)](https://travis-ci.org/maasglobal/ecs-event-notifications)\n\nThis service is an example implementation how to use AWS CloudWatch events to monitor ECS container states. AWS CloudWatch event triggers a Lambda function that published a message to an SNS topic, which can be subscribed to send, e.g. message to an email address, SMS message, or notification to Slack channel.\n\n[Subscribe to AWS ECS Event Stream Using Serverless Framework @ Medium](https://medium.com/@laardee/subscribe-to-aws-ecs-event-stream-using-serverless-framework-74de3db66ddb)\n\n## Installation\n\nThis service uses [Serverless Framework](https://github.com/serverless/serverless/) to deploy components to AWS.\n\nTo install service use `sls install -u https://github.com/maasglobal/ecs-event-notifications -n my-ecs-events`, where `my-ecs-events` is the name of the service you prefer to use.\n\nAfter installation, change directory to `my-ecs-events` and install dependencies with `npm install`.\n\n## Deployment\n\nWhen you are ready, you can deploy the service with `sls deploy`.\n\n## Subscribe to SNS topic\n\nBy default, this service will not create a subscription to SNS topic, but you can add the subscription, by using CloudFormation, AWS CLI or web console.\n\nTo use CloudFormation to subscribe notifications to your email, add following snippet to resources block of the serverless.yml.\n\n```yaml\nECSStateChangeSubscription:\n  Type: AWS::SNS::Subscription\n  Properties:\n    Endpoint: my.email@example.com\n    Protocol: email\n    TopicArn:\n      Ref: ECSStateChangeTopic\n```\n\nAfter deployment, you should have subscription confirmation email titled \"AWS Notification - Subscription Confirmation\" in your inbox, then follow the instructions on email.\n\n## AWS CloudWatch Event Rules\n\nMore info about how to configure the CloudWatch event trigger for ECS [Serverless Docs](https://serverless.com/framework/docs/providers/aws/events/cloudwatch-event/) and [AWS docs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_cwe_events.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaasglobal%2Fecs-event-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaasglobal%2Fecs-event-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaasglobal%2Fecs-event-notifications/lists"}