BlueCat Gateway™ is a Python-based web utility that leverages the BlueCat Address Manager™ (BAM) API to allow you to create custom workflows for common tasks in order to maximize efficiency of enterprise DNS operations.
BlueCat Gateway consists of a set of Python classes forming an API to Address Manager and BlueCat DNS/DHCP Server (BDDS) along with a customized Python Flask web framework for building custom user interfaces and REST endpoints. It can run on most Linux variants with the correct packages installed.
The workflows are ready to use; they just need to be placed into the <bluecat_gateway>/workflows folder. The same can be done with the community examples.
This will copy over all of the Example workflows:
cp -r <gateway-example-repo>/Examples/* <bluecat_gateway>/workflows/Examples/.
If only a specific set of workflows is required they can be copied into the workflows folder individually. However, ensure that there are __init__.py files present in your workflows folder structure leading up to the workflow itself. This is required by BlueCat Gateway in order to discover the workflow.
Once the workflows have been copied over, just start the BlueCat Gateway container. In order to use the added workflows the permissions have to be adjusted through the administrative permissions workflow. The workflows contained in the Examples folder are always up-to-date with the latest BlueCat Gateway version. This is not the case for the Community workflows. The contributing authors are required to specify the version of BlueCat Gateway for which the workflow was created or updated. While all community workflows will be reviewed, they are delivered "as is".
Contributing follows a review process: before a workflow is accepted it will be reviewed and then merged into the master branch. It will be the responsibility of the contributor to ensure that their workflow is supported for future releases of BlueCat Gateway.
Please review the Terms and Conditions.
When contributing to the Community examples please ensure that the code is of good quality
- BlueCat Gateway is written with the PEP8 standard in mind
- Ensure that each function contains a docstring explaining the purpose of the function, the input variables and, the return type
- Use plenty of comments to describe what the function is doing
- Use meaningful variable and function names
- Contributions should not directly access the BAM database
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Move your workflow into
Community/<your-workflow> - Create
<your-workflow>/README.mdexplaining what the workflow does. Use the Template below. - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request
When contributing a workflow ensure that it contains a README.md and that each file has the following notice header:
Copyright YYYY BlueCat Networks (USA) Inc. and its affiliates
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, software
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.
By: Your Name (youremail@domain.com)
Date: DD-MM-YYYY
Gateway Version: X.X.X
Description: Brief description of what the workflow does and the expected behaviour
BlueCat Gateway would be so much less without the following people. Thank you for contributing your time to making this project a success.
- Anita Cheng
- Martin Minkov
- Brian Shorland
- Edwin Christie
- Mike Leaver
- Nishant Malhotra
- Nathan Wickham
- Ajay Basnet
- Andreas Avramidis
- Roy Fisher
- Chris Collins
- Bill Morton
- Chris Meyer
- Jubin George
- Glenn McAllister
- Robert Barnhardt™
- Roy Reshef
- Vadim Farafontov
- Victor Fradkin
- Xiao Dong
- Nikhil Jangi
- Anshul Sharma
- Ekim Maurer
- Lana Litvak
- Raymond Leong
- Rohina Dhunjeebhoy
- Shanice Cohen
- Chris Catral
- Steven Diao
- Murtaza Haider
- Hongbo Wang
- Maziar Esfandiarpoor
- Chris Storz
- Delme Herbert
- David Cohen
- Prerana Pradhan
- Lucas Tran
- Chester Wu
- Aman Tawakley
Copyright 2017-2022 BlueCat Networks (USA) Inc. and its affiliates
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, software 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.