Skip to content

Commit

Permalink
Merge branch 'owls-120737-doc' into 'main'
Browse files Browse the repository at this point in the history 
Documentation to clarify dedicated mode

See merge request weblogic-cloud/weblogic-kubernetes-operator!4896

(cherry picked from commit b4be284)

01920541 Documentation to clarify dedicated mode
f08db12f Correct for clarity
  • Loading branch information
@rjeberhard
rjeberhard committed Dec 20, 2024
1 parent 2036acd commit b235451
Show file tree
Hide file tree
Showing 2 changed files with 84 additions and 52 deletions.
12 changes: 6 additions & 6 deletions documentation/site/content/managing-operators/namespace-management.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -47,12 +47,12 @@ The operator installation Helm chart
[domainNamespaceSelectionStrategy]({{<relref "/managing-operators/using-helm#domainnamespaceselectionstrategy">}})
configuration setting controls which namespaces an operator manages.

|Strategy|Description|Example|
|-|-|-|
|`LabelSelector`|This is the default. The operator will manage namespaces with Kubernetes labels that match the label selector defined by your Helm chart configuration `domainNamespaceLabelSelector` attribute, which defaults to `weblogic-operator=enabled`.|With the Helm chart defaults, the operator will manage namespaces that have a label named `weblogic-operator` when this label has the value `enabled`. You can label the namespace `sample-domain1-ns` using the command `kubectl label namespace sample-domain1-ns weblogic-operator=enabled`. You can define a different label selector for your operator installation using the `domainNamespaceLabelSelector`, such as `--set "domainNamespaceLabelSelector=environment\=prod"`. For detailed syntax requirements, see [domainNamespaceLabelSelector]({{<relref "/managing-operators/using-helm#domainnamespacelabelselector">}}) in the Configuration Reference. |
|`RegExp`|The operator will manage namespaces that match the regular expression set by your `domainNamespaceRegExp` Helm chart configuration attribute.|If you want an operator to manage namespaces that start with the string `prod`, then use `--set "domainNamespaceSelectionStrategy=RegExp"` for your operator Helm configuration setting, and set the `domainNamespaceRegExp` Helm chart configuration attribute using `--set "domainNamespaceRegExp=^prod"`.|
|`Dedicated`|The operator will manage only domains that are in the same namespace as the operator.|If the operator is deployed to namespace `my-operator-ns` and was installed using `--set "domainNamespaceSelectionStrategy=Dedicated"` in its Helm chart configuration, then the operator will manage only domains in the `my-operator-ns` namespace.|
|`List`|The operator will manage the namespaces included in the `domainNamespaces` operator installation Helm chart configuration value, which is a list that defaults to `{default}`.|If you want to manage namespaces `default` and `ns1`, then in your operator installation Helm chart configuration, use `--set "domainNamespaceSelectionStrategy=List"` and `--set "domainNamespaces={default,ns1}"`.|
| Strategy | Description | Example |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `LabelSelector` | This is the default. The operator will manage namespaces with Kubernetes labels that match the label selector defined by your Helm chart configuration `domainNamespaceLabelSelector` attribute, which defaults to `weblogic-operator=enabled`. | With the Helm chart defaults, the operator will manage namespaces that have a label named `weblogic-operator` when this label has the value `enabled`. You can label the namespace `sample-domain1-ns` using the command `kubectl label namespace sample-domain1-ns weblogic-operator=enabled`. You can define a different label selector for your operator installation using the `domainNamespaceLabelSelector`, such as `--set "domainNamespaceLabelSelector=environment\=prod"`. For detailed syntax requirements, see [domainNamespaceLabelSelector]({{<relref "/managing-operators/using-helm#domainnamespacelabelselector">}}) in the Configuration Reference. |
| `RegExp` | The operator will manage namespaces that match the regular expression set by your `domainNamespaceRegExp` Helm chart configuration attribute. | If you want an operator to manage namespaces that start with the string `prod`, then use `--set "domainNamespaceSelectionStrategy=RegExp"` for your operator Helm configuration setting, and set the `domainNamespaceRegExp` Helm chart configuration attribute using `--set "domainNamespaceRegExp=^prod"`. |
| `Dedicated` | The operator will manage only domains that are in the same namespace as the operator. | If the operator is deployed to namespace `my-operator-ns` and was installed using `--set "domainNamespaceSelectionStrategy=Dedicated"` in its Helm chart configuration, then the operator will manage only domains in the `my-operator-ns` namespace. Customers often choose this strategy if a third-party or infrastructure team manages the Kubernetes cluster and the team installing the operator, such as an applications team, will have privilege only within one namespace. For more details on this use case, see [Local namespace only with cluster role binding disabled]({{<relref "/managing-operators/preparation#any-namespace-with-cluster-role-binding-disabled">}}). |
| `List` | The operator will manage the namespaces included in the `domainNamespaces` operator installation Helm chart configuration value, which is a list that defaults to `{default}`. | If you want to manage namespaces `default` and `ns1`, then in your operator installation Helm chart configuration, use `--set "domainNamespaceSelectionStrategy=List"` and `--set "domainNamespaces={default,ns1}"`. |

For detailed reference information about each setting,
see [WebLogic domain management]({{<relref "/managing-operators/using-helm#weblogic-domain-management">}}).
Expand Down
Loading

0 comments on commit b235451

Please # to comment.