GithubHelp home page GithubHelp logo

gwthompson / rubix Goto Github PK

View Code? Open in Web Editor NEW

This project forked from nurtch/rubix

0.0 1.0 0.0 27 KB

Python package to enable DevOps tasks in Jupyter Notebooks

Home Page: http://docs.nurtch.com/en/latest/rubix-library/index.html

License: GNU Lesser General Public License v3.0

Python 97.10% CSS 2.90%

rubix's Introduction

PyPI version Build Status

Rubix

What is Rubix?

Python library that makes it easy to perform common DevOps tasks inside Jupyter Notebooks. E.g. plot Cloudwatch metrics, rollback your ECS/kubernetes app etc.

When to use it?

While Rubix can be used in many contexts, it's most useful for writing incident runbooks/playbooks. On-call can read instructions & execute steps right from the Jupyter Notebook. I wrote more about the use case here.

Why Jupyter Notebook?

  • Ideal for quick incident response. Jupyter allows interleaving instructions and executable code.
  • Rich HTML output makes it easy to plot graphs, show deployment status etc.
  • Low friction way to edit/view/execute notebooks in a browser.

Live In Action

Checkout this 1-minute debugging session to see how Rubix helped root cause API latency issue.

Demo Video

Documentation

Currently following integrations are supported in Rubix, would love to add more. Note that Jupyter Notebook supports executing shell commands & SQL queries out of the box.

Installation

Rubix exclusively works with Jupyter notebooks. You can install Jupyter locally or use JupyterHub multi user setup. I also built nurtch (commercial) for easy multi user Jupyter setup.

  • For your Jupyter/JupyterHub setup, just execute the following at the top of any notebook. Bang operator tells Jupyter to execute this as a terminal command.
!pip install rubix
  • Rubix is pre-installed with nurtch multi-user Jupyter setup.
  • Rubix is pre-installed with GitLab 11.4 onwards. See this video for instructions.

Usage

Complete documentation is linked above. Here are some usage examples.

Plot Cloudwatch Metrics

Cloudwatch Metrics Example

Rollback Service in ECS

ECS Rollback Example

Contribute

If you see any problem, open an issue or send a pull request. For additional integrations open an issue with Feature Request tag & clearly describe the operations you want to perform. You can write to us at [email protected] or DM us on twitter.

rubix's People

Contributors

amit1rrr avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.