https://github.com/nautobot/nautobot-app-circuit-maintenance

Circuit Maintenance App for Nautobot
https://github.com/nautobot/nautobot-app-circuit-maintenance

hacktoberfest nautobot nautobot-plugin

Last synced: 5 days ago
JSON representation

Circuit Maintenance App for Nautobot

• Host: GitHub
• URL: https://github.com/nautobot/nautobot-app-circuit-maintenance
• Owner: nautobot
• License: apache-2.0
• Created: 2021-04-27T13:14:34.000Z (over 3 years ago)
• Default Branch: develop
• Last Pushed: 2024-10-23T03:18:31.000Z (2 months ago)
• Last Synced: 2024-12-12T21:06:38.201Z (10 days ago)
• Topics: hacktoberfest, nautobot, nautobot-plugin
• Language: Python
• Homepage: https://docs.nautobot.com/projects/circuit-maintenance/en/latest/
• Size: 3.13 MB
• Stars: 32
• Watchers: 11
• Forks: 8
• Open Issues: 36
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Circuit Maintenance



  

  


  

  

  

  

  


  An App for Nautobot.



## Overview

A app for [Nautobot](https://github.com/nautobot/nautobot) to easily handle Circuit Maintenances related to Nautobot Circuits.

`nautobot-circuit-maintenance` lets you handle maintenances for your Circuits based on notifications received via email by leveraging [circuit-maintenance-parser](https://github.com/networktocode/circuit-maintenance-parser), a notifications parser library for multiple network service providers that exposes structured data following a recommendation defined in this [draft NANOG BCOP](https://github.com/jda/maintnote-std/blob/master/standard.md).

### Screenshots

More screenshots can be found in the [Using the App](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/user/app_use_cases/) page in the documentation. Here's a quick overview of some of the app's added functionality:

![Circuit Maintenance Dashboard](https://raw.githubusercontent.com/nautobot/nautobot-app-circuit-maintenance/develop/docs/images/dashboard.png)

![Example Circuit Maintenance View](https://raw.githubusercontent.com/nautobot/nautobot-app-circuit-maintenance/develop/docs/images/circuit_maintenance.png)

![Example Raw Notifications View](https://raw.githubusercontent.com/nautobot/nautobot-app-circuit-maintenance/develop/docs/images/circuit_notifications.png)

## Try it out!

This App is installed in the Nautobot Community Sandbox found over at [demo.nautobot.com](https://demo.nautobot.com/)!

> For a full list of all the available always-on sandbox environments, head over to the main page on [networktocode.com](https://www.networktocode.com/nautobot/sandbox-environments/).

## Documentation

Full documentation for this App can be found over on the [Nautobot Docs](https://docs.nautobot.com) website:

- [User Guide](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.

- [Administrator Guide](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.

- [Developer Guide](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.

- [Release Notes / Changelog](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/admin/release_notes/).

- [Frequently Asked Questions](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/user/faq/).

### Contributing to the Documentation

You can find all the Markdown source for the App documentation under the [`docs`](https://github.com/nautobot/nautobot-app-circuit-maintenance/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.

If you need to view the fully-generated documentation site, you can build it with [MkDocs](https://www.mkdocs.org/). A container hosting the documentation can be started using the `invoke` commands (details in the [Development Environment Guide](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). Using this container, as your changes to the documentation are saved, they will be automatically rebuilt and any pages currently being viewed will be reloaded in your browser.

Any PRs with fixes or improvements are very welcome!

## Questions

For any questions or comments, please check the [FAQ](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.