https://github.com/tibcosoftware/mashling-recipes
Recipes for Project Mashling
https://github.com/tibcosoftware/mashling-recipes
Last synced: 7 months ago
JSON representation
Recipes for Project Mashling
- Host: GitHub
- URL: https://github.com/tibcosoftware/mashling-recipes
- Owner: TIBCOSoftware
- Archived: true
- Created: 2017-09-07T20:31:59.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-06-18T23:01:42.000Z (about 7 years ago)
- Last Synced: 2024-06-21T11:19:35.331Z (about 2 years ago)
- Language: Go
- Homepage:
- Size: 16.2 MB
- Stars: 14
- Watchers: 20
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## This project has moved. Find more details at https://github.com/project-flogo/microgateway.
# Recipes for Project MashlingTM
[](https://travis-ci.org/TIBCOSoftware/mashling-recipes)
A recipe is a pre-configured Mashling json file which can be customized or used as is for a specific gateway use case. The recipes and the gateway binaries to run them are available in [mashling.io](https://www.mashling.io) website.
## How to contribute a recipe
### Creating a recipe
A recipe can be created by customizing an existing recipe in [mashling.io](https://www.mashling.io) or by using an editor such as [VS Code](https://code.visualstudio.com/) enabled with [mashling extension](https://github.com/TIBCOSoftware/vscode-extension-mashling).
### Adding a recipe
A recipe should be contained in its own folder under 'recipes' folder. The recipe folder is composed of a gateway json file, README.md and optional icon image file. In the absence of the icon image file, the default Mashling icon image is used by mashling.io for the recipe. When the icon image file is present, the Mashling json file should have an icon image file field as follows:
```json
{
"mashling_schema": "0.2",
"gateway": {
"name": "allRecipe",
"version": "1.0.0",
"display_name":"KafkaTrigger to KafkaPublisher",
"display_image":"displayImage.svg",
"..."
}
}
```
If "display_name" field is present in the json, its value is used as the recipe name in mashling.io. Otherwise, the value of "name" field is used.
### Publishing a recipe
[recipe_registry.json](https://github.com/TIBCOSoftware/mashling-recipes/blob/master/recipe_registry.json) contains the list of recipe providers and the recipes to publish. The recipe folder name should be added to the "publish" field for the recipe to be made available in mashling.io. For example, "event-dispatcher-router-mashling" and "rest-conditional-gateway" recipes binaries are built and made downloadable from mashling.io given the following recipe_registry.json. Setting "featured" to "true" adds the recipe to the featured recipe list in [mashling.io](https://www.mashling.io).
```json
{
"recipe_repos":[
{
"provider":"TIBCOSoftware Engineering",
"description":"Mashling gateway recipes from TIBCOSoftware Engineering",
"publish":[
{
"recipe":"event-dispatcher-router-mashling",
"featured":true
},
{
"recipe":"rest-conditional-gateway",
"featured":false
}
]
},
{
"provider":"TIBCOSoftware Services",
"description":"Mashling gateway recipes from TIBCO Services",
"publish":[]
}
]
}
```
### Submitting a new/updated recipe
[Create a pull request](https://help.github.com/articles/creating-a-pull-request/) for the recipe to be reviewed and merged into this repository. To publish/unpublish a recipe on [mashling.io](https://www.mashling.io), create a pull request for the updated [recipe_registry.json](https://github.com/TIBCOSoftware/mashling-recipes/blob/master/recipe_registry.json).
## License
mashling-recipes is licensed under a BSD-type license. See license text [here](https://github.com/TIBCOSoftware/mashling-recipes/blob/master/TIBCO%20LICENSE.txt).
## Support
You can post your questions via [GitHub issues](https://github.com/TIBCOSoftware/mashling-recipes/issues).