diff --git a/content/blog/aws-cdk-on-pulumi-1.0/index.md b/content/blog/aws-cdk-on-pulumi-1.0/index.md index 5f5d27ec1ac9..dd334d024093 100644 --- a/content/blog/aws-cdk-on-pulumi-1.0/index.md +++ b/content/blog/aws-cdk-on-pulumi-1.0/index.md @@ -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/) diff --git a/content/docs/iac/cli/commands/pulumi_state_protect.md b/content/docs/iac/cli/commands/pulumi_state_protect.md index 68fb59c18069..e0210d10f544 100644 --- a/content/docs/iac/cli/commands/pulumi_state_protect.md +++ b/content/docs/iac/cli/commands/pulumi_state_protect.md @@ -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. diff --git a/content/docs/iac/comparisons/terraform/opentofu.md b/content/docs/iac/comparisons/terraform/opentofu.md index 65002c70ae28..f94dc43726a8 100644 --- a/content/docs/iac/comparisons/terraform/opentofu.md +++ b/content/docs/iac/comparisons/terraform/opentofu.md @@ -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 diff --git a/content/docs/iac/concepts/resources/options/parent.md b/content/docs/iac/concepts/resources/options/parent.md index 0876e135a9ac..6bf010538d73 100644 --- a/content/docs/iac/concepts/resources/options/parent.md +++ b/content/docs/iac/concepts/resources/options/parent.md @@ -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`. diff --git a/content/docs/iac/guides/building-extending/providers/debugging-providers.md b/content/docs/iac/guides/building-extending/providers/debugging-providers.md index 170b935ff8c8..a47bf391658c 100644 --- a/content/docs/iac/guides/building-extending/providers/debugging-providers.md +++ b/content/docs/iac/guides/building-extending/providers/debugging-providers.md @@ -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/ diff --git a/content/docs/iac/guides/clouds/aws/cdk.md b/content/docs/iac/guides/clouds/aws/cdk.md index 767f7813716e..7230a205f42b 100644 --- a/content/docs/iac/guides/clouds/aws/cdk.md +++ b/content/docs/iac/guides/clouds/aws/cdk.md @@ -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. diff --git a/content/docs/iac/guides/migration/import/_index.md b/content/docs/iac/guides/migration/import/_index.md index 373ba1f0e047..d3148e129961 100644 --- a/content/docs/iac/guides/migration/import/_index.md +++ b/content/docs/iac/guides/migration/import/_index.md @@ -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 ` 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. diff --git a/content/docs/insights/policy/policy-packs/authoring.md b/content/docs/insights/policy/policy-packs/authoring.md index 567b1ca8b625..6c6449c305d5 100644 --- a/content/docs/insights/policy/policy-packs/authoring.md +++ b/content/docs/insights/policy/policy-packs/authoring.md @@ -755,7 +755,7 @@ 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. @@ -763,7 +763,7 @@ Resource validation callbacks receive an `args.opts` object of type `PolicyResou - `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 @@ -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 diff --git a/content/tutorials/creating-resources-gcp/index.md b/content/tutorials/creating-resources-gcp/index.md index b4dca0b70870..1b31ede0ad5f 100644 --- a/content/tutorials/creating-resources-gcp/index.md +++ b/content/tutorials/creating-resources-gcp/index.md @@ -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 diff --git a/content/tutorials/creating-resources-kubernetes/index.md b/content/tutorials/creating-resources-kubernetes/index.md index c12c09383ba8..e842114be0f2 100644 --- a/content/tutorials/creating-resources-kubernetes/index.md +++ b/content/tutorials/creating-resources-kubernetes/index.md @@ -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