feat: compute_disk_create_secondary/regional/custom/(start/stop)replication

compute/disks/createCustomSecondaryDisk.js

@@ -0,0 +1,125 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+async function main(
+  secondaryDiskName,
+  secondaryLocation,
+  primaryDiskName,
+  primaryLocation
+) {
+  // [START compute_disk_create_secondary_custom]
+  // Import the Compute library
+  const computeLib = require('@google-cloud/compute');
+  const compute = computeLib.protos.google.cloud.compute.v1;
+
+  // If you want to create regional disk, you should use: RegionDisksClient and RegionOperationsClient.
+  // Instantiate a diskClient
+  const disksClient = new computeLib.DisksClient();
+  // Instantiate a zoneOperationsClient
+  const zoneOperationsClient = new computeLib.ZoneOperationsClient();
+
+  /**
+   * TODO(developer): Update/uncomment these variables before running the sample.
+   */
+  // The project for the secondary disk.
+  const secondaryProjectId = await disksClient.getProjectId();
+
+  // The zone or region for the secondary disk. The primary and secondary disks must be in different regions.
+  // If you use RegionDisksClient- define region, if DisksClient- define zone.
+  // secondaryLocation = 'us-central1-a';
+
+  // The name of the secondary disk.
+  // secondaryDiskName = 'secondary-disk-name';
+
+  // The project that contains the primary disk.
+  const primaryProjectId = await disksClient.getProjectId();
+
+  // The zone or region for the primary disk.
+  // If you use RegionDisksClient- define region, if DisksClient- define zone.
+  // primaryLocation = 'us-central1-b';
+
+  // The name of the primary disk that the secondary disk receives data from.
+  // primaryDiskName = 'primary-disk-name';
+
+  // The disk type. Must be one of `pd-ssd` or `pd-balanced`.
+  const diskType = `zones/${secondaryLocation}/diskTypes/pd-balanced`;
+
+  // The size of the secondary disk in gigabytes.
+  const diskSizeGb = 10;
+
+  // Create a secondary disk identical to the primary disk.
+  async function callCreateComputeSecondaryDisk() {
+    // Create a secondary disk
+    const disk = new compute.Disk({
+      sizeGb: diskSizeGb,
+      name: secondaryDiskName,
+      // If you use RegionDisksClient, pass region as an argument instead of zone
+      zone: secondaryLocation,
+      type: diskType,
+      asyncPrimaryDisk: new compute.DiskAsyncReplication({
+        // Make sure that the primary disk supports asynchronous replication.
+        // Only certain persistent disk types, like `pd-balanced` and `pd-ssd`, are eligible.
+        disk: `projects/${primaryProjectId}/zones/${primaryLocation}/disks/${primaryDiskName}`,
+      }),
+      // Specify additional guest OS features.
+      // To learn more about OS features, open: `https://cloud.google.com/compute/docs/disks/async-pd/configure?authuser=0#secondary2`.
+      // You don't need to include the guest OS features of the primary disk.
+      // The secondary disk automatically inherits the guest OS features of the primary disk.
+      guestOsFeatures: [
+        new compute.GuestOsFeature({
+          type: 'NEW_FEATURE_ID_1',
+        }),
+      ],
+      // Assign additional labels to the secondary disk.
+      // You don't need to include the labels of the primary disk.
+      // The secondary disk automatically inherits the labels from the primary disk
+      labels: {
+        key: 'value',
+      },
+    });
+
+    const [response] = await disksClient.insert({
+      project: secondaryProjectId,
+      // If you use RegionDisksClient, pass region as an argument instead of zone
+      zone: secondaryLocation,
+      diskResource: disk,
+    });
+
+    let operation = response.latestResponse;
+
+    // Wait for the create secondary disk operation to complete.
+    while (operation.status !== 'DONE') {
+      [operation] = await zoneOperationsClient.wait({
+        operation: operation.name,
+        project: secondaryProjectId,
+        // If you use RegionOperationsClient, pass region as an argument instead of zone
+        zone: operation.zone.split('/').pop(),
+      });
+    }
+
+    console.log(`Custom secondary disk: ${secondaryDiskName} created.`);
+  }
+
+  await callCreateComputeSecondaryDisk();
+  // [END compute_disk_create_secondary_custom]
+}
+
+main(...process.argv.slice(2)).catch(err => {
+  console.error(err);
+  process.exitCode = 1;
+});

compute/disks/createRegionalSecondaryDisk.js

@@ -0,0 +1,108 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+async function main(
+  secondaryDiskName,
+  secondaryLocation,
+  primaryDiskName,
+  primaryLocation
+) {
+  // [START compute_disk_create_secondary_regional]
+  // Import the Compute library
+  const computeLib = require('@google-cloud/compute');
+  const compute = computeLib.protos.google.cloud.compute.v1;
+
+  // Instantiate a regionDisksClient
+  const regionDisksClient = new computeLib.RegionDisksClient();
+  // Instantiate a regionOperationsClient
+  const regionOperationsClient = new computeLib.RegionOperationsClient();
+
+  /**
+   * TODO(developer): Update/uncomment these variables before running the sample.
+   */
+  // The project for the secondary disk.
+  const secondaryProjectId = await regionDisksClient.getProjectId();
+
+  // The region for the secondary disk.
+  // secondaryLocation = 'us-central1';
+
+  // The name of the secondary disk.
+  // secondaryDiskName = 'secondary-disk-name';
+
+  // The project that contains the primary disk.
+  const primaryProjectId = await regionDisksClient.getProjectId();
+
+  // The region for the primary disk.
+  // primaryLocation = 'us-central2';
+
+  // The name of the primary disk that the secondary disk receives data from.
+  // primaryDiskName = 'primary-disk-name';
+
+  // The disk type. Must be one of `pd-ssd` or `pd-balanced`.
+  const diskType = `regions/${secondaryLocation}/diskTypes/pd-balanced`;
+
+  // The size of the secondary disk in gigabytes.
+  const diskSizeGb = 10;
+
+  // Create a secondary disk identical to the primary disk.
+  async function callCreateComputeRegionalSecondaryDisk() {
+    // Create a secondary disk
+    const disk = new compute.Disk({
+      sizeGb: diskSizeGb,
+      name: secondaryDiskName,
+      region: secondaryLocation,
+      type: diskType,
+      replicaZones: [
+        `zones/${secondaryLocation}-a`,
+        `zones/${secondaryLocation}-b`,
+      ],
+      asyncPrimaryDisk: new compute.DiskAsyncReplication({
+        // Make sure that the primary disk supports asynchronous replication.
+        // Only certain persistent disk types, like `pd-balanced` and `pd-ssd`, are eligible.
+        disk: `projects/${primaryProjectId}/regions/${primaryLocation}/disks/${primaryDiskName}`,
+      }),
+    });
+
+    const [response] = await regionDisksClient.insert({
+      project: secondaryProjectId,
+      diskResource: disk,
+      region: secondaryLocation,
+    });
+
+    let operation = response.latestResponse;
+
+    // Wait for the create secondary disk operation to complete.
+    while (operation.status !== 'DONE') {
+      [operation] = await regionOperationsClient.wait({
+        operation: operation.name,
+        project: secondaryProjectId,
+        region: secondaryLocation,
+      });
+    }
+
+    console.log(`Secondary disk: ${secondaryDiskName} created.`);
+  }
+
+  await callCreateComputeRegionalSecondaryDisk();
+  // [END compute_disk_create_secondary_regional]
+}
+
+main(...process.argv.slice(2)).catch(err => {
+  console.error(err);
+  process.exitCode = 1;
+});

compute/disks/createZonalSecondaryDisk.js

@@ -0,0 +1,104 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+async function main(
+  secondaryDiskName,
+  secondaryLocation,
+  primaryDiskName,
+  primaryLocation
+) {
+  // [START compute_disk_create_secondary]
+  // Import the Compute library
+  const computeLib = require('@google-cloud/compute');
+  const compute = computeLib.protos.google.cloud.compute.v1;
+
+  // Instantiate a diskClient
+  const disksClient = new computeLib.DisksClient();
+  // Instantiate a zoneOperationsClient
+  const zoneOperationsClient = new computeLib.ZoneOperationsClient();
+
+  /**
+   * TODO(developer): Update/uncomment these variables before running the sample.
+   */
+  // The project for the secondary disk.
+  const secondaryProjectId = await disksClient.getProjectId();
+
+  // The zone for the secondary disk. The primary and secondary disks must be in different regions.
+  // secondaryLocation = 'us-central1-a';
+
+  // The name of the secondary disk.
+  // secondaryDiskName = 'secondary-disk-name';
+
+  // The project that contains the primary disk.
+  const primaryProjectId = await disksClient.getProjectId();
+
+  // The zone for the primary disk.
+  // primaryLocation = 'us-central1-b';
+
+  // The name of the primary disk that the secondary disk receives data from.
+  // primaryDiskName = 'primary-disk-name';
+
+  // The disk type. Must be one of `pd-ssd` or `pd-balanced`.
+  const diskType = `zones/${secondaryLocation}/diskTypes/pd-balanced`;
+
+  // The size of the secondary disk in gigabytes.
+  const diskSizeGb = 10;
+
+  // Create a secondary disk identical to the primary disk.
+  async function callCreateComputeSecondaryDisk() {
+    // Create a secondary disk
+    const disk = new compute.Disk({
+      sizeGb: diskSizeGb,
+      name: secondaryDiskName,
+      zone: secondaryLocation,
+      type: diskType,
+      asyncPrimaryDisk: new compute.DiskAsyncReplication({
+        // Make sure that the primary disk supports asynchronous replication.
+        // Only certain persistent disk types, like `pd-balanced` and `pd-ssd`, are eligible.
+        disk: `projects/${primaryProjectId}/zones/${primaryLocation}/disks/${primaryDiskName}`,
+      }),
+    });
+
+    const [response] = await disksClient.insert({
+      project: secondaryProjectId,
+      zone: secondaryLocation,
+      diskResource: disk,
+    });
+
+    let operation = response.latestResponse;
+
+    // Wait for the create secondary disk operation to complete.
+    while (operation.status !== 'DONE') {
+      [operation] = await zoneOperationsClient.wait({
+        operation: operation.name,
+        project: secondaryProjectId,
+        zone: operation.zone.split('/').pop(),
+      });
+    }
+
+    console.log(`Secondary disk: ${secondaryDiskName} created.`);
+  }
+
+  await callCreateComputeSecondaryDisk();
+  // [END compute_disk_create_secondary]
+}
+
+main(...process.argv.slice(2)).catch(err => {
+  console.error(err);
+  process.exitCode = 1;
+});