pulumi-gcp-kotlin/com.pulumi.gcp.osconfig.kotlin/PatchDeployment

PatchDeployment

class PatchDeployment : KotlinCustomResource

Patch deployments are configurations that individual patch jobs use to complete a patch. These configurations include instance filter, package repository settings, and a schedule. To get more information about PatchDeployment, see:

Example Usage

Os Config Patch Deployment Basic

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.osconfig.PatchDeployment;
import com.pulumi.gcp.osconfig.PatchDeploymentArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentInstanceFilterArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentOneTimeScheduleArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var patch = new PatchDeployment("patch", PatchDeploymentArgs.builder()
            .instanceFilter(PatchDeploymentInstanceFilterArgs.builder()
                .all(true)
                .build())
            .oneTimeSchedule(PatchDeploymentOneTimeScheduleArgs.builder()
                .executeTime("2999-10-10T10:10:10.045123456Z")
                .build())
            .patchDeploymentId("patch-deploy")
            .build());
    }
}
Content copied to clipboard

Os Config Patch Deployment Daily

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.osconfig.PatchDeployment;
import com.pulumi.gcp.osconfig.PatchDeploymentArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentInstanceFilterArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeOfDayArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeZoneArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var patch = new PatchDeployment("patch", PatchDeploymentArgs.builder()
            .instanceFilter(PatchDeploymentInstanceFilterArgs.builder()
                .all(true)
                .build())
            .patchDeploymentId("patch-deploy")
            .recurringSchedule(PatchDeploymentRecurringScheduleArgs.builder()
                .timeOfDay(PatchDeploymentRecurringScheduleTimeOfDayArgs.builder()
                    .hours(0)
                    .minutes(30)
                    .nanos(20)
                    .seconds(30)
                    .build())
                .timeZone(PatchDeploymentRecurringScheduleTimeZoneArgs.builder()
                    .id("America/New_York")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Os Config Patch Deployment Daily Midnight

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.osconfig.PatchDeployment;
import com.pulumi.gcp.osconfig.PatchDeploymentArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentInstanceFilterArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeOfDayArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeZoneArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var patch = new PatchDeployment("patch", PatchDeploymentArgs.builder()
            .instanceFilter(PatchDeploymentInstanceFilterArgs.builder()
                .all(true)
                .build())
            .patchDeploymentId("patch-deploy")
            .recurringSchedule(PatchDeploymentRecurringScheduleArgs.builder()
                .timeOfDay(PatchDeploymentRecurringScheduleTimeOfDayArgs.builder()
                    .hours(0)
                    .minutes(0)
                    .nanos(0)
                    .seconds(0)
                    .build())
                .timeZone(PatchDeploymentRecurringScheduleTimeZoneArgs.builder()
                    .id("America/New_York")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Os Config Patch Deployment Instance

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetImageArgs;
import com.pulumi.gcp.compute.Instance;
import com.pulumi.gcp.compute.InstanceArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskInitializeParamsArgs;
import com.pulumi.gcp.compute.inputs.InstanceNetworkInterfaceArgs;
import com.pulumi.gcp.osconfig.PatchDeployment;
import com.pulumi.gcp.osconfig.PatchDeploymentArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentInstanceFilterArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentPatchConfigArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentPatchConfigYumArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeZoneArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleTimeOfDayArgs;
import com.pulumi.gcp.osconfig.inputs.PatchDeploymentRecurringScheduleMonthlyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var myImage = ComputeFunctions.getImage(GetImageArgs.builder()
            .family("debian-11")
            .project("debian-cloud")
            .build());
        var foobar = new Instance("foobar", InstanceArgs.builder()
            .machineType("e2-medium")
            .zone("us-central1-a")
            .canIpForward(false)
            .tags(
                "foo",
                "bar")
            .bootDisk(InstanceBootDiskArgs.builder()
                .initializeParams(InstanceBootDiskInitializeParamsArgs.builder()
                    .image(myImage.applyValue(getImageResult -> getImageResult.selfLink()))
                    .build())
                .build())
            .networkInterfaces(InstanceNetworkInterfaceArgs.builder()
                .network("default")
                .build())
            .metadata(Map.of("foo", "bar"))
            .build());
        var patch = new PatchDeployment("patch", PatchDeploymentArgs.builder()
            .patchDeploymentId("patch-deploy")
            .instanceFilter(PatchDeploymentInstanceFilterArgs.builder()
                .instances(foobar.id())
                .build())
            .patchConfig(PatchDeploymentPatchConfigArgs.builder()
                .yum(PatchDeploymentPatchConfigYumArgs.builder()
                    .security(true)
                    .minimal(true)
                    .excludes("bash")
                    .build())
                .build())
            .recurringSchedule(PatchDeploymentRecurringScheduleArgs.builder()
                .timeZone(PatchDeploymentRecurringScheduleTimeZoneArgs.builder()
                    .id("America/New_York")
                    .build())
                .timeOfDay(PatchDeploymentRecurringScheduleTimeOfDayArgs.builder()
                    .hours(0)
                    .minutes(30)
                    .seconds(30)
                    .nanos(20)
                    .build())
                .monthly(PatchDeploymentRecurringScheduleMonthlyArgs.builder()
                    .monthDay(1)
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Os Config Patch Deployment Full

No Java example available.

Import

PatchDeployment can be imported using any of these accepted formats

$ pulumi import gcp:osconfig/patchDeployment:PatchDeployment default projects/{{project}}/patchDeployments/{{name}}
Content copied to clipboard
$ pulumi import gcp:osconfig/patchDeployment:PatchDeployment default {{project}}/{{name}}
Content copied to clipboard
$ pulumi import gcp:osconfig/patchDeployment:PatchDeployment default {{name}}
Content copied to clipboard

Properties

Link copied to clipboard
val createTime: Output<String>

Time the patch deployment was created. Timestamp is in RFC3339 text format. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Link copied to clipboard
val description: Output<String>?

Description of the patch deployment. Length of the description is limited to 1024 characters.

Link copied to clipboard
val duration: Output<String>?

Duration of the patch. After the duration ends, the patch times out. A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s"

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val instanceFilter: Output<PatchDeploymentInstanceFilter>

VM instances to patch. Structure is documented below.

Link copied to clipboard
val lastExecuteTime: Output<String>

(Output) The time the last patch job ran successfully. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Link copied to clipboard
val name: Output<String>

Unique name for the patch deployment resource in a project. The patch deployment name is in the form: projects/{project_id}/patchDeployments/{patchDeploymentId}.

Link copied to clipboard
val oneTimeSchedule: Output<PatchDeploymentOneTimeSchedule>?

Schedule a one-time execution. Structure is documented below.

Link copied to clipboard
val patchConfig: Output<PatchDeploymentPatchConfig>?

Patch configuration that is applied. Structure is documented below.

Link copied to clipboard
val patchDeploymentId: Output<String>

A name for the patch deployment in the project. When creating a name the following rules apply:

Link copied to clipboard
val project: Output<String>

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val recurringSchedule: Output<PatchDeploymentRecurringSchedule>?

Schedule recurring executions. Structure is documented below.

Link copied to clipboard
val rollout: Output<PatchDeploymentRollout>?

Rollout strategy of the patch job. Structure is documented below.

Link copied to clipboard
val updateTime: Output<String>

Time the patch deployment was last updated. Timestamp is in RFC3339 text format. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Link copied to clipboard
val urn: Output<String>