Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/blog/aws-cdk-on-pulumi-1.0/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ new MyApp();

Pulumi let's you read and create any resource type across thousands of different cloud service providers and integrate them with your CDK stacks. Building CDK apps on Pulumi brings a host of other benefits too, including:

- Customize [resource options](https://www.pulumi.com/docs/iac/concepts/options/) (eg. to protect a database against accidental deletion or deploy to multiple regions in the same program)
- Customize [resource options](https://www.pulumi.com/docs/iac/concepts/resources/options/) (eg. to protect a database against accidental deletion or deploy to multiple regions in the same program)
- [Detect and manage drift](https://www.pulumi.com/docs/pulumi-cloud/deployments/drift/) with Pulumi deployments
- Track and store user actions and change history with [Audit Logs](https://www.pulumi.com/docs/pulumi-cloud/audit-logs/)
- And a host of other benefits from [Pulumi Cloud](https://www.pulumi.com/product/pulumi-cloud/)
Expand Down
2 changes: 1 addition & 1 deletion content/docs/iac/cli/commands/pulumi_state_protect.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Setting the 'protect' bit on a resource in your stack's state is not sufficient
all cases. If your program does not also set the 'protect' resource option, Pulumi will
unprotect the resource the next time your program runs (e.g. as part of a `pulumi up`).

See https://www.pulumi.com/docs/iac/concepts/options/protect/ for more information on
See https://www.pulumi.com/docs/iac/concepts/resources/options/protect/ for more information on
the 'protect' resource option and how it can be used to protect resources in your program.

To unprotect a resource, use `pulumi unprotect`on the resource URN.
Expand Down
2 changes: 1 addition & 1 deletion content/docs/iac/comparisons/terraform/opentofu.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ Transformations, which are unique to Pulumi, allow you to programmatically set o

### Import Code from Other IaC Tools {#converting}

Pulumi allows you to convert templates by Terraform HCL, Kubernetes YAML, and Azure ARM into Pulumi programs. This preserves the existing program structure, which may be important if you carefully designed your existing infrastructure as code layout in terms of names, modules, and configurability. Conversion takes care of the static program structure and will automatically generate a new, fully-functional Pulumi program that matches the source infrastructure as code program. To learn more, see [Conversion](/docs/using-pulumi/adopting-pulumi/migrating-to-pulumi/#conversion) in our Adopting Pulumi user guide.
Pulumi allows you to convert templates by Terraform HCL, Kubernetes YAML, and Azure ARM into Pulumi programs. This preserves the existing program structure, which may be important if you carefully designed your existing infrastructure as code layout in terms of names, modules, and configurability. Conversion takes care of the static program structure and will automatically generate a new, fully-functional Pulumi program that matches the source infrastructure as code program. To learn more, see [Conversion](/docs/iac/guides/migration/#conversion) in our Adopting Pulumi user guide.

## Get Started with Pulumi

Expand Down
4 changes: 2 additions & 2 deletions content/docs/iac/concepts/resources/options/parent.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,6 @@ Child resources always inherit the following resource options from their `parent

* [`transforms`](/docs/iac/concepts/resources/options/transforms/): Transforms applied to a parent will run on the parent and on all child resources. This allows a transform to be applied to a component to intercept and modify any resources created by its children. As a special case, [Stack transforms](/docs/iac/concepts/resources/options/transforms/#stack-transforms) will be applied to *all* resources (since all resources ultimately are parented directly or indirectly by the root stack resource).

* [`transformations`](/docs/iac/concepts/options/transformations): Transformations applied to a parent will run on the parent and on all child resources. This allows a transformation to be applied to a component to intercept and modify any resources created by its children. As a special case, [Stack transformations](/docs/iac/concepts/options/transformations#stack-transformations) will be applied to *all* resources (since all resources ultimately are parented directly or indirectly by the root stack resource). Prefer `transforms` over `transformations` as the latter is deprecated.
* [`transformations`](/docs/iac/concepts/resources/options/transformations): Transformations applied to a parent will run on the parent and on all child resources. This allows a transformation to be applied to a component to intercept and modify any resources created by its children. As a special case, [Stack transformations](/docs/iac/concepts/resources/options/transformations#stack-transformations) will be applied to *all* resources (since all resources ultimately are parented directly or indirectly by the root stack resource). Prefer `transforms` over `transformations` as the latter is deprecated.

* [`deletedWith`](/docs/iac/concepts/options/deletedwith): Child resources inherit their parent's `deletedWith` so that when a parent is being removed alongside the resource named in its `deletedWith`, child deletions are skipped as well. This matches how containing resources (such as a Kubernetes namespace or a cloud resource group) cascade-delete their contents in the backing provider — individual child deletes are unnecessary, and skipping them also speeds up `pulumi destroy`.
* [`deletedWith`](/docs/iac/concepts/resources/options/deletedwith): Child resources inherit their parent's `deletedWith` so that when a parent is being removed alongside the resource named in its `deletedWith`, child deletions are skipped as well. This matches how containing resources (such as a Kubernetes namespace or a cloud resource group) cascade-delete their contents in the backing provider — individual child deletes are unnecessary, and skipping them also speeds up `pulumi destroy`.
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,6 @@ menu:
aliases:
- /docs/iac/operations/debugging/debugging-providers/
- /docs/support/debugging/debugging-providers/
- /docs/using-pulumi/pulumi-packages/
- /docs/using-pulumi/pulumi-packages/debugging-provider-packages/
- /docs/iac/packages-and-automation/pulumi-packages/debugging-provider-packages/
- /docs/using-pulumi/pulumi-packages/debugging-provider-packages/
Expand Down
2 changes: 1 addition & 1 deletion content/docs/iac/guides/clouds/aws/cdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -636,7 +636,7 @@ set of feature flags [here](https://github.com/aws/aws-cdk/blob/main/packages/aw

## Setting Pulumi Options for CDK resources

You can set Pulumi resource options for CDK resources by using [Transforms](https://www.pulumi.com/docs/iac/concepts/options/transforms/).
You can set Pulumi resource options for CDK resources by using [Transforms](https://www.pulumi.com/docs/iac/concepts/resources/options/transforms/).
For example, if you wanted to set `protect` on database resources you could use
a transform like this.

Expand Down
2 changes: 1 addition & 1 deletion content/docs/iac/guides/migration/import/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -498,7 +498,7 @@ A `Resource` has the following schema:
| `version` | `string` | No | The [version](/docs/iac/concepts/resources/options/version/) of the provider to use. |
| `properties` | `array[string]` | No | The list of properties to include in the generated code. If unspecified all properties will be included. |
| `component` | `boolean` | No | This import should create an empty component resource. `id` must not be set if this is `true`. |
| `remote` | `boolean` | No | This is a component in a [component package](/docs/using-pulumi/pulumi-packages/#types-of-pulumi-packages). `component` must be `true` if this is `true`. |
| `remote` | `boolean` | No | This is a component in a [component package](/docs/iac/concepts/packages/). `component` must be `true` if this is `true`. |

To make it easier to import resources into complex programs, you can run `pulumi preview --import-file <file>` to generate a placeholder import file for every resource that would be created. The generated file will contain all the names, URNs, and types already filled in, with blank `id` fields that need to be filled in.

Expand Down
6 changes: 3 additions & 3 deletions content/docs/insights/policy/policy-packs/authoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -755,15 +755,15 @@ When writing policies for dynamic providers:

## Inspecting resource options

Resource validation callbacks receive an `args.opts` object of type `PolicyResourceOptions`. It mirrors the [resource options](/docs/iac/concepts/options/) set on the resource under validation, letting policies make decisions based on how a resource is configured rather than only its properties. The available fields are:
Resource validation callbacks receive an `args.opts` object of type `PolicyResourceOptions`. It mirrors the [resource options](/docs/iac/concepts/resources/options/) set on the resource under validation, letting policies make decisions based on how a resource is configured rather than only its properties. The available fields are:

- `protect` — whether the resource is protected from deletion.
- `ignoreChanges` (`ignore_changes` in Python) — properties whose changes the engine ignores.
- `deleteBeforeReplace` (`delete_before_replace`) — whether the resource is deleted before its replacement is created.
- `aliases` — additional URNs aliased to the resource.
- `customTimeouts` (`custom_timeouts`) — custom create, update, and delete timeouts.
- `additionalSecretOutputs` (`additional_secret_outputs`) — outputs always treated as secrets.
- `parent` — the [URN](/docs/iac/concepts/resources/names/#urns) of the resource's [parent](/docs/iac/concepts/options/parent/). For a resource created directly at the stack root rather than as a child of another resource or component, this is the URN of the root stack resource (type `pulumi:pulumi:Stack`).
- `parent` — the [URN](/docs/iac/concepts/resources/names/#urns) of the resource's [parent](/docs/iac/concepts/resources/options/parent/). For a resource created directly at the stack root rather than as a child of another resource or component, this is the URN of the root stack resource (type `pulumi:pulumi:Stack`).

### Example: Enforcing a resource's parent

Expand Down Expand Up @@ -840,7 +840,7 @@ PolicyPack(
{{< /chooser >}}

{{% notes type="info" %}}
`args.opts` is available on `ResourceValidationArgs` (resource validation policies), not on `StackValidationArgs`. To reason about parent-child relationships across the full resource graph, use a [stack validation policy](#stack-validation-policies) and inspect `args.resources`. See [resource options](/docs/iac/concepts/options/) for what each option means on the resource side.
`args.opts` is available on `ResourceValidationArgs` (resource validation policies), not on `StackValidationArgs`. To reason about parent-child relationships across the full resource graph, use a [stack validation policy](#stack-validation-policies) and inspect `args.resources`. See [resource options](/docs/iac/concepts/resources/options/) for what each option means on the resource side.
{{% /notes %}}

## Running policies locally
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/creating-resources-gcp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ Some of the properties inside of your `gcp.compute.Instance` resource include:
| **boot disk** | tells the provider the configuration for the instance's boot disk |
| **network interfaces** | tells the provider what networks to attach to the instance |

**Options** let you control certain aspects of a resource (such as showing explicit dependencies or importing existing infrastructure). You do not have any options defined for this resource, but you can learn more about how it works in the [Resource options documentation](/docs/iac/concepts/options/).
**Options** let you control certain aspects of a resource (such as showing explicit dependencies or importing existing infrastructure). You do not have any options defined for this resource, but you can learn more about how it works in the [Resource options documentation](/docs/iac/concepts/resources/options/).

## Deploy your resources

Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/creating-resources-kubernetes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,7 +260,7 @@ The property defined in your `kubernetes.apps/v1.Deployment` resource is:
|--------------|-------------|
| **spec** | tells the Kubernetes provider the specification of the desired behavior of the deployment |

**Options** let you control certain aspects of a resource (such as showing explicit dependencies or importing existing infrastructure). You do not have any options defined for this resource, but you can learn more about how it works in the [Resource options documentation](/docs/iac/concepts/options/).
**Options** let you control certain aspects of a resource (such as showing explicit dependencies or importing existing infrastructure). You do not have any options defined for this resource, but you can learn more about how it works in the [Resource options documentation](/docs/iac/concepts/resources/options/).

## Deploy your resources

Expand Down
Loading