Awesome CloudOps Automation

CloudOps automation made simpler!
Explore the docs »

Visit our blog · Report Bug · Request Feature

About the project

Mission

To make CloudOps automation simpler for developers and DevOps engineers.

Vision

A single repository to satisfy all your day-to-day CloudOps automation needs. Are you looking for a script to automate your Kubernetes management? Or do you need a script to restart the pod that is OOMkilled? We will cover that for you.

Runbooks

Category	Directory	Runbooks
MongoDB	/mongo	MongoDB Server Connectivity Runbook
K8S		Pod Stuck in ImagePullBackOff State
		Pod Stuck in Terminating State
		Pod Stuck in CrashLoopback State
		Get Kube System Config Map
		Get K8S Candidate Nodes For a given config
AWS	/aws	Configure Url Endpoint on Cloudwatch Alarm
		Delete Unattached EBS Volumes
		Detect ECS Failed Deployment
		EC2 Disk Cleanup
		Get AWS ELB Unhealthy Instances
		Resize EBS Volume
		Resize List of PVCs
		Resize EKS PVC
		Restart AWS EC2 Instance
		Restart AWS EC2 Instance by Tag
		Restart UnHealthy Services Target Group
		Stop Untagged EC2 Instances
Jenkins	/jenkins	Fetch Jenkins Build Logs
Postgresql	/postgresql	Display Long running Queries

Quick start

Get started with docker

Linux/Mac/Windows (x86-64/arm64)

docker run -it -p 8888:8888 \
 -v $HOME/.unskript:/data \
 -e NB_USER=jovyan \
 -e CHOWN_HOME=yes \
 -e CHOWN_EXTRA_OPTS='-R' \
 --user root \
 -w /home/jovyan \
 public.ecr.aws/unskript/awesome-runbooks:latest

Inside the docker there is /data folder that is where we store the credentials and runbooks. So if you would like to retain the connectors and runbooks you can use the docker's -v option to retain the changes done on the docker.

Note: New files are created inside the docker and will persist unless --rm option is used.

Open the Runbook

Once you run the above command, here's the table which will help you find the URL for runbook of your choice.

Category	Runbooks	URL
MongoDB	MongoDB Server Connectivity Runbook	Open in browser
K8S	Pod Stuck in ImagePullBackOff State	Open in browser
	Pod Stuck in Terminating State	Open in browser
	Pod Stuck in CrashLoopback State	Open in browser
	Get Kube System Config Map	Open in browser
	Get K8S Candidate Nodes For a given config	Open in browser
AWS	Configure Url Endpoint on Cloudwatch Alarm	Open in browser
	Delete Unattached EBS Volumes	Open in browser
	Detect ECS Failed Deployment	Open in browser
	EC2 Disk Cleanup	Open in browser
	Get AWS ELB Unhealthy Instances	Open in browser
	Resize EBS Volume	Open in browser
	Resize List of PVCs	Open in browser
	Resize EKS PVC	Open in browser
	Restart AWS EC2 Instance	Open in browser
	Restart AWS EC2 Instance by Tag	Open in browser
	Restart UnHealthy Services Target Group	Open in browser
	Stop Untagged EC2 Instances	Open in browser
Jenkins	Fetch Jenkins Build Logs	Open in browser
Postgresql	Display Long-running Queries	Open in browser

Community

Join the CloudOps Community Workspace on Slack to connect with other users, contributors and awesome people behind awesome CloudOps automation project.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. Check out our Contribution Guidelines for more details.

Here is the Link for the Developer Guide

License

Except as otherwise noted this project is licensed under the Apache License, Version 2.0 .

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 .

Unless required by applicable law or agreed to in writing, project distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.