diff --git a/content/master/managed-resources/managed-resources.md b/content/master/managed-resources/managed-resources.md index 279b160f9..2f6f4fb92 100644 --- a/content/master/managed-resources/managed-resources.md +++ b/content/master/managed-resources/managed-resources.md @@ -337,22 +337,26 @@ Crossplane supports the following policies: | `LateInitialize` | Crossplane initializes some external resource settings not defined in the `spec.forProvider` of the managed resource. See [the late initialization]({{}}) section for more details. | | `Observe` | Crossplane only observes the resource and doesn't make any changes. Used for observe only resources. | | `Update` | Crossplane changes the external resource when changing the managed resource. | +|`Orphan` | Shorthand for the combination `Observe`, `Create`, `Update`, `LateInitialize`. Supports migration from the deprecated `deletionPolicy` attribute. | +|`MustCreate` | A stricter version of `Create` that requires the desired resource to _not_ already exist. | {{}} The following is a list of common policy combinations: {{}} -| Create | Delete | LateInitialize | Observe | Update | Description | -| :---: | :---: | :---: | :---: | :---: | --- | -| {{}} | {{}} | {{}} | {{}} | {{}} | _Default policy_. Crossplane has full control over the resource. | -| {{}} | {{}} | {{}} | {{}} | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | -| {{}} | {{}} | | {{}} | {{}} | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | -| {{}} | {{}} | | {{}} | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | -| {{}} | | {{}} | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. | -| {{}} | | {{}} | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | -| {{}} | | | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | -| {{}} | | | {{}} | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | -| | | | {{}} | | Crossplane only observes a resource. | -| | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| Create | Delete | LateInitialize | Observe | Update | Orphan | MustCreate | Description | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: |--- | +| {{}} | {{}} | {{}} | {{}} | {{}} | | | _Default policy_. Crossplane has full control over the resource. | +| {{}} | {{}} | {{}} | {{}} | | | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | +| {{}} | {{}} | | {{}} | {{}} | | | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | +| {{}} | {{}} | | {{}} | | | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | +| {{}} | | {{}} | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. | +| {{}} | | {{}} | {{}} | | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | +| {{}} | | | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | +| {{}} | | | {{}} | | | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | +| | | | {{}} | | | | Crossplane only observes a resource. | +| | | | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| | | | | | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Equivalent to Observe, Create, Update, LateInitialize. | +| | {{}} | {{}} | {{}} | {{}} | | {{}} | Crossplane has full control over the resource. The resource must not already exist when the Managed Resource is created. | {{< /table >}} diff --git a/content/v1.20/concepts/managed-resources.md b/content/v1.20/concepts/managed-resources.md index 1c163ea71..685a1e353 100644 --- a/content/v1.20/concepts/managed-resources.md +++ b/content/v1.20/concepts/managed-resources.md @@ -447,22 +447,26 @@ Crossplane supports the following policies: | `LateInitialize` | Crossplane initializes some external resource settings not defined in the `spec.forProvider` of the managed resource. See [the late initialization]({{}}) section for more details. | | `Observe` | Crossplane only observes the resource and doesn't make any changes. Used for [observe only resources]({{}}). | | `Update` | Crossplane changes the external resource when changing the managed resource. | +|`Orphan` | Shorthand for the combination `Observe`, `Create`, `Update`, `LateInitialize`. Supports migration from the deprecated `deletionPolicy` attribute. | +|`MustCreate` | A stricter version of `Create` that requires the desired resource to _not_ already exist. | {{
}} The following is a list of common policy combinations: {{}} -| Create | Delete | LateInitialize | Observe | Update | Description | -| :---: | :---: | :---: | :---: | :---: | --- | -| {{}} | {{}} | {{}} | {{}} | {{}} | _Default policy_. Crossplane has full control over the resource. | -| {{}} | {{}} | {{}} | {{}} | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | -| {{}} | {{}} | | {{}} | {{}} | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | -| {{}} | {{}} | | {{}} | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | -| {{}} | | {{}} | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. | -| {{}} | | {{}} | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | -| {{}} | | | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | -| {{}} | | | {{}} | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | -| | | | {{}} | | Crossplane only observes a resource. Used for [observe only resources]({{}}). | -| | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| Create | Delete | LateInitialize | Observe | Update | Orphan | MustCreate | Description | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: |--- | +| {{}} | {{}} | {{}} | {{}} | {{}} | | | _Default policy_. Crossplane has full control over the resource. | +| {{}} | {{}} | {{}} | {{}} | | | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | +| {{}} | {{}} | | {{}} | {{}} | | | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | +| {{}} | {{}} | | {{}} | | | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | +| {{}} | | {{}} | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. | +| {{}} | | {{}} | {{}} | | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | +| {{}} | | | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | +| {{}} | | | {{}} | | | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | +| | | | {{}} | | | | Crossplane only observes a resource. | +| | | | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| | | | | | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Equivalent to Observe, Create, Update, LateInitialize. | +| } | {{}} | {{}} | {{}} | {{}} | | {{}} | _Default policy_. Crossplane has full control over the resource. The resource must not already exist when the Managed Resource is created. | {{< /table >}} diff --git a/content/v2.0/managed-resources/managed-resources.md b/content/v2.0/managed-resources/managed-resources.md index 279b160f9..e83cd3883 100644 --- a/content/v2.0/managed-resources/managed-resources.md +++ b/content/v2.0/managed-resources/managed-resources.md @@ -337,22 +337,26 @@ Crossplane supports the following policies: | `LateInitialize` | Crossplane initializes some external resource settings not defined in the `spec.forProvider` of the managed resource. See [the late initialization]({{}}) section for more details. | | `Observe` | Crossplane only observes the resource and doesn't make any changes. Used for observe only resources. | | `Update` | Crossplane changes the external resource when changing the managed resource. | +|`Orphan` | Shorthand for the combination `Observe`, `Create`, `Update`, `LateInitialize`. Supports migration from the deprecated `deletionPolicy` attribute. | +|`MustCreate` | A stricter version of `Create` that requires the desired resource to _not_ already exist. | {{
}} The following is a list of common policy combinations: {{}} -| Create | Delete | LateInitialize | Observe | Update | Description | -| :---: | :---: | :---: | :---: | :---: | --- | -| {{}} | {{}} | {{}} | {{}} | {{}} | _Default policy_. Crossplane has full control over the resource. | -| {{}} | {{}} | {{}} | {{}} | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | -| {{}} | {{}} | | {{}} | {{}} | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | -| {{}} | {{}} | | {{}} | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | -| {{}} | | {{}} | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. | -| {{}} | | {{}} | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | -| {{}} | | | {{}} | {{}} | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | -| {{}} | | | {{}} | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | -| | | | {{}} | | Crossplane only observes a resource. | -| | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| Create | Delete | LateInitialize | Observe | Update | Orphan | MustCreate | Description | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: |--- | +| {{}} | {{}} | {{}} | {{}} | {{}} | | | _Default policy_. Crossplane has full control over the resource. | +| {{}} | {{}} | {{}} | {{}} | | | | After creation any changes made to the managed resource aren't passed to the external resource. Useful for immutable external resources. | +| {{}} | {{}} | | {{}} | {{}} | | | Prevent Crossplane from managing any settings not defined in the managed resource. Useful for immutable fields in an external resource. | +| {{}} | {{}} | | {{}} | | | | Crossplane doesn't import any settings from the external resource and doesn't push changes to the managed resource. Crossplane recreates the external resource if it's deleted. | +| {{}} | | {{}} | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. | +| {{}} | | {{}} | {{}} | | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't apply changes to the external resource after creation. | +| {{}} | | | {{}} | {{}} | | | Crossplane doesn't delete the external resource when deleting the managed resource. Crossplane doesn't import any settings from the external resource. | +| {{}} | | | {{}} | | | | Crossplane creates the external resource but doesn't apply any changes to the external resource or managed resource. Crossplane can't delete the resource. | +| | | | {{}} | | | | Crossplane only observes a resource. | +| | | | | | | | No policy set. An alternative method for [pausing](#paused) a resource. | +| | | | | | {{}} | | Crossplane doesn't delete the external resource when deleting the managed resource. Equivalent to Observe, Create, Update, LateInitialize. | +| } | {{}} | {{}} | {{}} | {{}} | | {{}} | _Default policy_. Crossplane has full control over the resource. The resource must not already exist when the Managed Resource is created. | {{< /table >}} diff --git a/utils/vale/styles/Crossplane/crossplane-words.txt b/utils/vale/styles/Crossplane/crossplane-words.txt index 7317d5c1f..7a0d26b8d 100644 --- a/utils/vale/styles/Crossplane/crossplane-words.txt +++ b/utils/vale/styles/Crossplane/crossplane-words.txt @@ -74,6 +74,7 @@ MRD MRD's MRDs MRs +MustCreate Operation-specific PatchSet PatchSets