Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lohanbodevan/light-switch
Toggle your EC2 instance to start or stop without have to configure and mantain cron jobs
https://github.com/lohanbodevan/light-switch
Last synced: 12 days ago
JSON representation
Toggle your EC2 instance to start or stop without have to configure and mantain cron jobs
- Host: GitHub
- URL: https://github.com/lohanbodevan/light-switch
- Owner: lohanbodevan
- Created: 2017-10-05T02:26:41.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-02-21T19:50:58.000Z (over 2 years ago)
- Last Synced: 2024-08-01T19:52:59.353Z (3 months ago)
- Language: Python
- Size: 14.6 KB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Light Switch 
[](https://coveralls.io/github/lohanbodevan/light-switch)
Toggle your [EC2](https://aws.amazon.com/ec2/) and [RDS](https://aws.amazon.com/rds/) instances to start or stop without having to configure and mantain cron jobs.
The goal of this project is to provide some automation for instances that have to be turned on and off regularly (eg. development or staging envinronments).
This project is a simple [serverless](https://en.wikipedia.org/wiki/Serverless_computing) application prepread to run with [AWS Lambda](https://aws.amazon.com//lambda)
## How it Works
This application will look for EC2 instances ids in `instances.json` and RDS instaces ids in `rds_instances.json` file. With these ids, the application will
get each instance state and change to the oposite.
For example, if the instance state is `running` the application will change to `stopped` based on a schedule previously configured.
## Cloud Services Available
* AWS
## Requirements
* Python 3.6
* [Serverless](https://serverless.com/)
## Configurations
### Env vars
Configure your env vars in `serverless.yml` file in `custom` section.
The schedule configuration is also in `serverless.yml` file.
### EC2 Instances file
Configure your EC2 instances ids in `instances.json`. See example in `instances.json.default`
### RDS Instances file
Configure your RDS instances ids in `rds_instances.json`. See example in `rds_instances.json.default`
## Using Serverless
### Install
```
npm install -g serverless
```
### Deploy to Cloud
```
sls deploy
```
Obs.: You must configure your [credentials](http://docs.aws.amazon.com/cli/latest/topic/config-vars.html) to work with `serverless`.
## Run tests
```
make tests
```
## TODO
* Prepare for others cloud services