Configuration Inheritance
SOOS supports a multi-level configuration inheritance system, where default configurations can be set, optionally locked, and overridden as needed.
Organization level configurations, allow clients to set default configurations that will flow down to all sub-org and project configurations within those sub-orgs as defaults. If the configurations are locked then the value will not be able to be overridden by the sub-orgs or project configurations. If the configuration is not locked, then the sub-orgs or project configurations will be able to specify overrides for these values.
Only applicable for customers who have purchased the Organization Management add-on.
In the example below, the Organizational level configuration has set a default set for the Use Lock File, Scan Full Dependency Tree, and Include Dev/Test Dependencies configurations. The Scan Full Dependency Tree configuration has also been locked, ensuring that no sub-organizations can change the Scan Full Dependency Tree configuration.
Configuration locks and overrides typically apply to specific configuration values or in some cases, groups of related configurations.
Sub-org level configurations, allow clients to set default configurations that will flow to all projects as defaults. Sub-org level configurations cannot be locked.
For customers without the Organization Management add-on, Sub-Org configurations will be the global level of configurations, which are then overridable by Project configurations.
Building on the example above, the Use Lock File configuration has been overridden and turned off for this Sub-Organization. This will apply by default to all projects in this sub-organization, unless they have a project level override (see below). The Scan Full Dependency Tree and Include Dev/Test Dependencies are being inherited. Note, that the Scan Full Dependency Tree cannot be overridden.
Any configuration which is not explicitly overridden at the sub-organization level (using the override toggle), will use the global organization level configuration value.
Project level configurations are the most granular level of configuration available and are related to a specific project.
In this final example, we have selected the my-app project, and have turned Use Lock File back on, as well as turning on Include Dev/Test Dependencies. These configurations will only apply to the my-app project. Note, that the Scan Full Dependency Tree still cannot be overridden.
Any configuration which is not explicitly overridden at the project level, will use either the sub-organization level configuration (if an override exists), or the organization level configuration.
