How to distribute recipes¶
With Sensei you can store your recipes in numerous places and configure Sensei to load these. Configuring Sensei can also be done in two different ways.
It is important to know that there are two ways to configure which cookbooks should be loaded. This can be configured locally and inside our platform. The first option will mostly be used by users that write their own recipes. And the second option will likely be used if to distribute your recipes to all your colleagues.
Sensei will automatically fetch the local and remote configuration and combine these, because you can override certain settings that where configured remotely.
Open your IDE
Open the Cookbook Manager tool window by clicking Tools | Sensei | Cookbook Manager
Here you will see all the configured cookbooks, you can edit / add new ones using this UI.
Where to store the recipes¶
Recipes can be stored at different places, which makes it very easy to distribute these the way you like. The only important thing to keep in mind is that not all these places are writable. Only storing recipes locally (on a absolute path) or inside the project (using the project-url) allows editing.
Choose any path you like on the system to store the recipes. This has to point to a folder where Sensei has the permission to create the cookbook metadata file (
cookbook.yaml). Also inside this directory, subfolders
can be created to group recipes or to create a place for html description files.
Recipes can also be stored at a http(s) server. The location should point to a ZIP file that has the same structure as described in the Local section
Note that when you choose to upload your recipes ZIP file to our platform, an HTTPS link will be created behind the scenes.
This behaves the same as the Local option. The only difference is that you don't need to specify the absolute path to the location, but rather the relative path starting from the project's root directory.
Lastly you can also specify a git repository to load the recipes from. It is important to note that if you choose to use a private git repository, then the clients are forced to use ssh-authentication when loading recipes from that location. Currently this is the only supported authentication mechanism in Sensei.
With this configuration you can also choose which branch you'd like to use and where the recipes are stored at this repository.