Application recipes

The ProductsApplication recipes section links a tariff plan to a specific application deployment scenario on the server: the application source, processing module, installation script, operating system, and minimum resources. The provider uses recipes to offer clients ready-made installation scenarios — for example, LAMP, LEMP, or Zabbix — as part of a tariff plan, without manual server configuration after the order.

This article describes how to create an application recipe, configure its parameters, and manage the recipe lifecycle in the system.

Creating an application recipe

To create a recipe, in the left menu go to ProductsApplication recipesAdd:

  1. Fill in the fields:
    • Name — enter the recipe name. If multiple localizations are enabled in the system, fill in the field for each language;
    • Application source — select the module from which the recipe gets scripts. For example, VMmanager 6;
    • Processing module — select the infrastructure handler on whose servers the application is deployed. Only enabled handlers that match the selected source are available in the list;
    • Recipe — select the installation script. Only enabled recipes connected to the selected processing module are available in the list;
    • Icon — upload an image that is displayed in the application card when ordering;
    • Operating system — select an OS template. The list shows OS templates connected to the selected processing module and matching the tags of the selected recipe.
      If the OS list is empty after you select a processing module and recipe, check the settings: the OS must be enabled for the processing module (section ProductsParametersOperating systems) and have tags that match the recipe tags.
  2. Enter the amount of resources available for ordering:
    • Processor (pcs) — specify the minimum number of processors. The value can be changed up or down;
    • RAM (MiB) — specify the minimum amount of RAM in mebibytes. The value can only be increased;
    • Disk (GiB) — specify the minimum disk size in gibibytes. The value can only be increased;
  3. Click Ok to save the changes.

Recipe parameters

Recipe parameters are data that the client enters when ordering the application and that are passed to the installation script. For example, for Zabbix these are the server version and IP address, and for WordPress these are the interface language and installation type. If no parameters are created, deployment is performed fully automatically.

To edit recipe parameters, in the left menu go to ProductsApplication recipes → select a recipe → Parameters. You can perform the following actions with parameters:

  • Add;
  • Edit;
  • Delete;
  • Synchronize with the processing module.

Creating a parameter

To create a parameter, in the left menu go to ProductsApplication recipes → select a recipe → ParametersAdd:

  1. Fill in the fields:
    • Name — specify the parameter name that the client sees when ordering. If multiple localizations are enabled, fill in the field for each language;
    • Internal name — specify the technical name of the parameter. The value must be unique and match the variable name in the installation script;
    • Input field type — specify the type of element used to enter the value. Available values:
      • string field;
      • checkbox,
      • text field;
      • list;
      • multiple-choice list;
    • Multiple values — enable the option if you need to enter multiple values separated by spaces;
    • Number of input strings — specify the input field height in lines. Available for String field and Text field types;
    • Required parameter — enable the option if you need to prevent an empty value for the parameter;
    • Validation function — specify the validation rule for the entered value. For example, IP address or email;
    • Hint — specify the hint text for the input field. Fill it in for each locale;
    • Encrypt — specify whether the parameter value must be stored in encrypted form;
    • Default value — specify the default parameter value.
  2. Click Ok to save the changes.

Editing a recipe

To edit recipe parameters, in the left menu go to ProductsApplication recipes → select a recipe → Edit.

When you change the processing module or recipe, the list of available OS templates is updated. If the new OS does not match the recipe tags, saving is not possible — check the settings in ProductsApplication recipes → select a recipe → Parameters.

Deleting a recipe

If a recipe is linked to a tariff, disable the recipe from the tariff or delete the tariff before deleting it.

To delete a recipe, in the left menu go to ProductsApplication recipes → select a recipe → Delete → click Ok.