A new section in a StyleBook called “target-roles” is introduced, where all the roles supported by the StyleBook are declared.

This section is typically placed after the “import-StyleBooks” section of a StyleBook, and before the parameters section.

In the following StyleBook example, two roles are defined in within the “target-roles” section - A and B.

You can see that role B also defines two optional sub-properties, min-targets and max-targets.

Though these two sub-properties are optional, min-targets specify the minimum mandatory number of NetScaler instances that should be assigned this role when creating a config pack from this StyleBook, and max-targets specify the maximum number of NetScaler instances that can be assigned this role when creating a config pack from this StyleBook.

If these sub-properties are not specified, then there is no limit on the number of NetScaler instances that can be configured for that role. If min-targets = 0, the configuration associated with that role is optional and if min-targets = 1, then that configuration is mandatory and at least one NetScaler instance needs to be configured for that role.

In addition to explicitly defined roles, there is an implicit role that all StyleBooks have, and that role is called as a default role. This role can be used like any other role in a StyleBook. When creating a config pack, if a NetScaler instance is not assigned with a specific role, the instance gets implicitly assigned to the “default” role. The instance will now receive any configuration objects generated by components that have the “default” role.

After the roles that a StyleBook can support (including the role “default”) are defined, the roles can be used in the components section of a StyleBook. If you want a component to be deployed only on NetScaler instances that play a certain role, then you can specify the roles attribute as part of the component, as illustrated in the following example of a component:

In the above example, the component generates an “lbvserver” that will be deployed on instances playing the role A. Note that the roles attribute of a component is a list, and a component can be assigned multiple roles. These roles would have been declared in the “target-roles” section of the StyleBook.

Note: If a component in a StyleBook doesn’t specify a role attribute, then configuration objects generated by the component are created on all NetScaler instances regardless of their role. You can use this feature effectively to create configuration objects that can be applied to all instances of a config pack.

Let’s assume that there is a StyleBook with two roles defined - A and B, and which contains four components.

The components section of this StyleBook is reproduced below:

Note that the component C3 doesn’t have a role defined, which means the component is deployed on all instances regardless of their role. On the other hand, component C4 has the role “default”, which means it is applied to any instance that doesn’t have an explicit role assigned to it.

Now, consider that you want to create a config pack using this StyleBook, and deploy it on five NetScaler instances. At this stage, you can assign the roles to the instances in the following manner:

The following image summarizes the role assignments, and shows the resulting configuration that each NetScaler instance will receive:

Note that component C3 is deployed on all instances regardless of role, since this component had no roles attribute.

You can also use the “Dry Run” feature when creating a config pack to view and verify the correct assignment of roles and the configuration objects that will be created on each NetScaler instance.

The full content of the StyleBook "demo-target-roles" is provided below:

The following image shows the objects created for a sample config pack:

When using the REST API, you can specify roles for each NetScaler instance when creating or updating the config pack as follows. In the “targets” block, specify the UUID of the specific NetScaler instance on which you want to deploy the individual components.

A complete sample REST API is provided for your reference.

POST /<Console-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/1.2/demo-target-roles/configpacks