hibernate 0.1.4 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb37df3a1d0e0b64ae191626bfe015bca529ff81582816dea8a9198acc388f0b
-  data.tar.gz: 60eb78bd95762490b910a6dc949c666126c4e72fbd0822c5103b197642de8fbb
+  metadata.gz: 2bb58dd4aa7579fbedf120fb3e84975ec3cb721363abc73be70f2c5baea3242a
+  data.tar.gz: e551822ad245329bfaea6acdde6146dd038272637a60e51020016c2a62c4c31a
 SHA512:
-  metadata.gz: 3111686232c5dc02bb56a7c9f3b59ed0d9fc90a3ac1f986b32038cbbc41abeb62840228712e10ada6d7920082f1201aaa52b8cc88fbb4a33f53ec6ee843ed42a
-  data.tar.gz: 7d0389381b47eaa7be1d3938219c770b10ed5cca756cb861f4aceca5567e5abb4c460cbc56d9cddab42d548dfb768976573301b359083d045c38c453831aca72
+  metadata.gz: a6eb42d7aaea0b1d3b5e4e1ba8a65d22e5967c1b7b48b2895e49eb702a43a404f393237d737af928b2efb092c64893f0f617998eb0d572f50d41706dd0874d9f
+  data.tar.gz: 49b90600784c6ccd06b53dd9d60e0611671ede1ab0818ffdc0fd580b7555231eeb61df14daa4c7406745999eabc1dfb03fb08cbdd18005770c8bfe0f12709795

data/.gitignore

@@ -0,0 +1,6 @@
+.env
+*.zip
+*.gem
+config.yaml
+pkg
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gemspec
+
+group :development do
+  gem 'pry'
+end

data/Gemfile.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: .
+  specs:
+    hibernate (0.1.7)
+      aws-sdk-cloudwatch (~> 1.103)
+      aws-sdk-cloudwatchevents (~> 1.83)
+      aws-sdk-ec2 (~> 1.478)
+      aws-sdk-iam (~> 1.111)
+      aws-sdk-lambda (~> 1.136)
+      dotenv (~> 3.1)
+      json (~> 2.7)
+      optimist (~> 3.1)
+      rubyzip (~> 2.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    aws-eventstream (1.3.0)
+    aws-partitions (1.981.0)
+    aws-sdk-cloudwatch (1.103.0)
+      aws-sdk-core (~> 3, >= 3.207.0)
+      aws-sigv4 (~> 1.5)
+    aws-sdk-cloudwatchevents (1.83.0)
+      aws-sdk-core (~> 3, >= 3.207.0)
+      aws-sigv4 (~> 1.5)
+    aws-sdk-core (3.209.1)
+      aws-eventstream (~> 1, >= 1.3.0)
+      aws-partitions (~> 1, >= 1.651.0)
+      aws-sigv4 (~> 1.9)
+      jmespath (~> 1, >= 1.6.1)
+    aws-sdk-ec2 (1.478.0)
+      aws-sdk-core (~> 3, >= 3.207.0)
+      aws-sigv4 (~> 1.5)
+    aws-sdk-iam (1.111.0)
+      aws-sdk-core (~> 3, >= 3.207.0)
+      aws-sigv4 (~> 1.5)
+    aws-sdk-lambda (1.136.0)
+      aws-sdk-core (~> 3, >= 3.207.0)
+      aws-sigv4 (~> 1.5)
+    aws-sigv4 (1.10.0)
+      aws-eventstream (~> 1, >= 1.0.2)
+    coderay (1.1.3)
+    diff-lcs (1.5.1)
+    dotenv (3.1.4)
+    jmespath (1.6.2)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    method_source (1.1.0)
+    optimist (3.1.0)
+    parallel (1.26.3)
+    parser (3.3.5.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.1)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.66.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.4, < 3.0)
+      rubocop-ast (>= 1.32.2, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.32.3)
+      parser (>= 3.3.1.0)
+    ruby-progressbar (1.13.0)
+    rubyzip (2.3.2)
+    unicode-display_width (2.6.0)
+
+PLATFORMS
+  arm64-darwin-22
+
+DEPENDENCIES
+  hibernate!
+  pry
+  rake
+  rspec (~> 3.13)
+  rubocop (~> 1.66)
+
+BUNDLED WITH
+   2.5.4

data/Rakefile

@@ -0,0 +1,3 @@
+#!/usr/bin/env rake
+
+require 'bundler/gem_tasks'

data/Readme.md

@@ -0,0 +1,346 @@
+# EC2 Auto Shutdown and Start
+
+As a software engineering team, we are working with Amazon EC2 instances on a daily basis While EC2 instances are great for running applications and services but its important to properly manage our instances to avoid unnecessary costs and resource consumption. One way to do this is by automating the shutdown and start of your EC2 instances
+
+This project automates the start and stop of AWS EC2 instances based on scheduled CloudWatch Events using an AWS Lambda function. It leverages Ruby AWS SDK for creating the Lambda function, CloudWatch Events, and EC2 instance management. You can configure the instance and schedule using the CLI.
+
+## Project Overview
+
+The project allows you to:
+- Create a Lambda function that automatically starts or stops EC2 instances based on their current state (i.e., running or stopped).
+- Schedule EC2 instance start/stop operations using CloudWatch Events.
+- Manage the schedule and EC2 instance operations through a Ruby-based CLI.
+
+```mermaid
+flowchart TB
+    A[User - Command Line Interface]
+    B[CloudWatch Events]
+    C[Lambda Function]
+    D{Start or Stop EC2 Instance?}
+    E[Start EC2 Instance]
+    F[Stop EC2 Instance]
+    G[CloudWatch Logs]
+
+    subgraph AWS Cloud
+        B
+        C
+        D
+        E
+        F
+        G
+    end
+
+    A -->|Configure CloudWatch Events| B
+    B -->|Trigger Event| C
+    C -->|Execute Script| D
+    D -->|Start| E
+    D -->|Stop| F
+    C -->|Log Execution| G
+    A -.->|Monitor Logs| G
+
+    classDef default fill:#f7f7f7,stroke:#2c3e50,stroke-width:2px;
+    classDef input fill:#3498db,stroke:#2c3e50,stroke-width:2px,color:#fff;
+    classDef process fill:#1abc9c,stroke:#2c3e50,stroke-width:2px,color:#fff;
+    classDef decision fill:#f39c12,stroke:#2c3e50,stroke-width:2px;
+    classDef output fill:#2ecc71,stroke:#2c3e50,stroke-width:2px,color:#fff;
+    classDef storage fill:#e74c3c,stroke:#2c3e50,stroke-width:2px,color:#fff;
+
+    class A input;
+    class B,C process;
+    class D decision;
+    class E,F output;
+    class G storage;
+```
+
+## Features
+
+- **Lambda function**: Automatically manages the start and stop of EC2 instances.
+- **CloudWatch Events**: Schedules based on cron expressions to run the Lambda function at specific times.
+- **CLI Interface**: Easy-to-use interface for setting up the Lambda function and managing EC2 instance operations.
+
+---
+
+## Prerequisites
+
+- **AWS CLI**: Ensure that the AWS CLI is installed and configured with access to your AWS account.
+- **Ruby 3.x**: The project requires Ruby version 3.x. Install Ruby using a version manager like RVM or rbenv.
+- **AWS SDK for Ruby**: The project uses `aws-sdk-ec2` and `aws-sdk-cloudwatchevents` gems.
+- **IAM Permissions**: Ensure the AWS user you are using has permissions to:
+
+Required IAM Permissions
+
+
+1. CloudWatch Events Permissions
+
+	- events:PutRule: Create or update CloudWatch event rules.
+	- events:ListRules: List existing event rules.
+	- events:DescribeRule: Retrieve details about a specific event rule.
+	- events:PutTargets: Associate targets with CloudWatch event rules.
+	- events:RemoveTargets: Remove targets from CloudWatch event rules.
+	- events:DeleteRule: Delete an event rule.
+	- events:ListTargetsByRule: List targets associated with a specific rule.
+
+2. EC2 Permissions
+
+	- ec2:DescribeInstances: Retrieve information about EC2 instances.
+	- ec2:StartInstances: Start EC2 instances (if applicable).
+	- ec2:StopInstances: Stop EC2 instances (if applicable).
+
+3. Lambda Permissions
+
+	- lambda:AddPermission: Allow CloudWatch Events to invoke the Lambda function.
+	- lambda:RemovePermission: Remove permissions that allow invocation of the Lambda function.
+	- lambda:InvokeFunction: Allow invocation of the specified Lambda function (if needed directly).
+	- lambda:CreateFunction: Create a new Lambda function.
+	- lambda:GetFunction: Retrieve details about a specific Lambda function.
+
+4. IAM Permissions
+
+	- iam:GetRole: Retrieve details about a specific IAM role.
+	- iam:PassRole: Allow passing a role to the Lambda service, if required.
+
+```json
+{
+	"Version": "2012-10-17",
+	"Statement": [
+		{
+			"Effect": "Allow",
+			"Action": [
+				"events:PutRule",
+				"events:ListRules",
+				"events:DescribeRule",
+				"events:PutTargets",
+				"events:RemoveTargets",
+				"events:DeleteRule",
+				"events:ListTargetsByRule"
+			],
+			"Resource": "*"
+		},
+		{
+			"Effect": "Allow",
+			"Action": [
+				"ec2:DescribeInstances",
+				"ec2:StartInstances",
+				"ec2:StopInstances"
+			],
+			"Resource": "*"
+		},
+		{
+			"Effect": "Allow",
+			"Action": [
+				"lambda:AddPermission",
+				"lambda:RemovePermission",
+				"lambda:InvokeFunction",
+				"lambda:CreateFunction",
+				"lambda:GetFunction"
+			],
+			"Resource": "arn:aws:lambda:<region>:<account-id>:function:*"
+		},
+		{
+			"Effect": "Allow",
+			"Action": [
+				"iam:GetRole",
+				"iam:PassRole",
+				"lambda:GetFunction"
+			],
+			"Resource": [
+				"arn:aws:iam::<account-id>:role/<role-name>",
+				"arn:aws:iam::<account-id>:role/*",
+				"arn:aws:lambda:<region>:<account-id>:function:<function-name>"
+			]
+		}
+	]
+}
+```
+
+---
+
+## Setup Instructions
+
+### 1. Clone the Repository
+
+```bash
+git clone [https://github.com/maniSHarma7575/hibernate.git](https://github.com/maniSHarma7575/hibernate.git)
+cd hibernate
+```
+
+### 2. Environment Configuration
+
+Create a `config.yaml` file at the root of your project and configure your AWS account details as follows:
+
+```yaml
+aws_accounts:
+  profile_name:
+    account_id: "<account_id_1>"
+    region: us-east-1
+    credentials:
+      access_key_id: ACCESS_KEY_1
+      secret_access_key: SECRET_KEY_1
+  profile_other:
+    account_id:<account_id_2>
+    region: us-west-2
+    credentials:
+      access_key_id: ACCESS_KEY_2
+      secret_access_key: SECRET_KEY_2
+```
+
+### 3. Install Dependencies
+
+Make sure you have the required gems and build the gem by running:
+
+```bash
+rake install
+```
+
+Here’s how the Usage section for the Readme.md can be structured based on your script:
+
+## Usage
+
+Automate the shutdown and start of EC2 instances using scheduled rules.
+
+### Available Commands
+
+- **setup**: Set up the AWS IAM role and Lambda function for managing EC2 instance schedules.
+- **rule**: Manage schedules for EC2 instance start/stop actions.
+  - **create**: Create a new start/stop schedule.
+  - **list**: List existing schedules.
+  - **update**: Update an existing schedule.
+  - **remove**: Remove an existing schedule.
+
+```bash
+hibernate --help
+```
+
+### Command Usage
+
+#### Setup Command
+
+```bash
+hibernate setup --profile <PROFILE_NAME>
+```
+
+Options:
+
+-	-p, --profile: Specify the AWS profile name (required).
+
+#### Rule Command
+
+**Create a Schedule**
+
+```bash
+hibernate rule create --profile <PROFILE_NAME> --instance-name <INSTANCE_NAME> --start <CRON_START> --stop <CRON_STOP>
+```
+
+Options:
+
+-	-p, --profile: Specify the AWS profile name (required).
+-	-i, --instance-name: Specify the EC2 instance name (required).
+-	-s, --start: Specify the cron expression for starting the instance (optional).
+-	-e, --stop: Specify the cron expression for stopping the instance (optional).
+
+**List Schedules**
+
+```bash
+hibernate rule list --profile <PROFILE_NAME> --instance-name <INSTANCE_NAME> [--start] [--stop]
+```
+Options:
+
+-	-p, --profile: Specify the AWS profile name (required).
+-	-i, --instance-name: Specify the EC2 instance name (required).
+-	-s, --start: List only the start action rules (optional).
+-	-e, --stop: List only the stop action rules (optional).
+
+**Update a Schedule**
+
+```bash
+hibernate rule update --profile <PROFILE_NAME> --rule <RULE_NAME> --start <NEW_CRON_START> --stop <NEW_CRON_STOP> [--state <enable|disable>]
+```
+
+Options:
+
+-	-p, --profile: Specify the AWS profile name (required).
+-	-r, --rule: Specify the rule name to update (required).
+-	-s, --start: Specify the new cron expression for starting the instance (optional).
+-	-e, --stop: Specify the new cron expression for stopping the instance (optional).
+-	-a, --state: Set the rule state to either enable or disable (optional).
+
+**Remove a Schedule**
+
+```bash
+hibernate rule remove --profile <PROFILE_NAME> --instance-name <INSTANCE_NAME> --rule <RULE_NAME>
+```
+
+Options:
+
+-	-p, --profile: Specify the AWS profile name (required).
+-	-i, --instance-name: Specify the EC2 instance name (required).
+-	-r, --rule: Specify the rule name to remove (required).
+
+Examples
+
+1. Setting up the environment:
+
+```bash
+hibernate setup --profile production
+```
+
+2. Creating a start/stop schedule for an EC2 instance:
+
+```bash
+hibernate rule create --profile production --instance-name my-ec2-instance --start "cron(0 8 * * ? *)" --stop "cron(0 18 * * ? *)"
+```
+
+
+3. Listing all schedules for an EC2 instance:
+
+```bash
+hibernate rule list --profile production --instance-name my-ec2-instance
+```
+
+4. Updating an existing rule:
+
+```bash
+hibernate rule update --profile production --rule my-rule --start "cron(0 7 * * ? *)" --state enable
+```
+
+5. Removing a schedule:
+
+```bash
+hibernate rule remove --profile production --instance-name my-ec2-instance --rule my-rule
+```
+
+#### Shortcut Options
+
+You can use these shortcut flags for commonly used options:
+
+-	-p for --profile
+-	-i for --instance-name
+-	-s for --start
+-	-e for --stop
+-	-r for --rule
+-	-a for --state
+
+```bash
+hibernate rule create -p production -i my-ec2-instance -s "cron(0 8 * * ? *)" -e "cron(0 18 * * ? *)
+```
+---
+
+### Resources:
+- [AWS Cron Expressions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html)
+
+## Contributing
+
+Feel free to submit pull requests or report issues. We welcome contributions to enhance the functionality of the project.
+
+---
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.
+
+---
+
+### Final Notes
+
+- Ensure your AWS credentials are properly configured in the `.env` file.
+- Test the Lambda function thoroughly before deploying it to production environments.