Skip to content

Commit eaa33a5

Browse files
Sita04Sita04
authored
docs(compute-samples): added windows samples and tests (GoogleCloudPlatform#7141)
* docs(compute-samples): added windows samples and tests for 1. Creating and managing instances 2. OS image * modified junit expected exception to jupiter assertThrows
1 parent b4b7b03 commit eaa33a5

8 files changed

Lines changed: 925 additions & 0 deletions

File tree

‎compute/cloud-client/src/main/java/compute/windows/osimage/CreateWindowsOsImage.java‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
// Copyright 2022 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
package compute.windows.osimage;
16+
17+
// [START compute_windows_image_create]
18+
19+
import com.google.cloud.compute.v1.Disk;
20+
import com.google.cloud.compute.v1.DisksClient;
21+
import com.google.cloud.compute.v1.Image;
22+
import com.google.cloud.compute.v1.ImagesClient;
23+
import com.google.cloud.compute.v1.InsertImageRequest;
24+
import com.google.cloud.compute.v1.Instance;
25+
import com.google.cloud.compute.v1.InstancesClient;
26+
import com.google.cloud.compute.v1.Operation;
27+
import java.io.IOException;
28+
import java.util.Arrays;
29+
import java.util.HashMap;
30+
import java.util.Map;
31+
import java.util.concurrent.ExecutionException;
32+
import java.util.concurrent.TimeUnit;
33+
import java.util.concurrent.TimeoutException;
34+
35+
public class CreateWindowsOsImage {
36+
37+
public static void main(String[] args)
38+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
39+
// TODO(developer): Replace these variables before running the sample.
40+
41+
// Project ID or project number of the Cloud project you use.
42+
String project = "your-project-id";
43+
// Zone of the disk you copy from.
44+
String zone = "europe-central2-b";
45+
// Name of the source disk you copy from.
46+
String sourceDiskName = "source-disk-name";
47+
// Name of the image you want to create.
48+
String imageName = "your-image-name";
49+
// Storage location for the image. If the value is undefined,
50+
// function will store the image in the multi-region closest to your image's source location.
51+
String storageLocation = "eu";
52+
// Create the image even if the source disk is attached to a running instance.
53+
boolean forceCreate = false;
54+
55+
createWindowsOsImage(project, zone, sourceDiskName, imageName, storageLocation, forceCreate);
56+
}
57+
58+
// Creates a new Windows image from the specified source disk.
59+
public static void createWindowsOsImage(String project, String zone, String sourceDiskName,
60+
String imageName, String storageLocation, boolean forceCreate)
61+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
62+
63+
try (ImagesClient imagesClient = ImagesClient.create();
64+
InstancesClient instancesClient = InstancesClient.create();
65+
DisksClient disksClient = DisksClient.create()) {
66+
67+
Disk disk = disksClient.get(project, zone, sourceDiskName);
68+
69+
// Getting instances where source disk is attached.
70+
for (String fullInstanceName : disk.getUsersList()) {
71+
Map<String, String> instanceInfo = parseInstanceName(fullInstanceName);
72+
Instance instance = instancesClient.get(instanceInfo.get("instanceProjectId"),
73+
instanceInfo.get("instanceZone"), instanceInfo.get("instanceName"));
74+
75+
// Сhecking whether the instances is stopped.
76+
if (!Arrays.asList("TERMINATED", "STOPPED").contains(instance.getStatus())
77+
&& !forceCreate) {
78+
throw new IllegalStateException(
79+
String.format(
80+
"Instance %s should be stopped. Please stop the instance using GCESysprep command or set forceCreate parameter to true (not recommended). More information here: https://cloud.google.com/compute/docs/instances/windows/creating-windows-os-image#api.",
81+
instanceInfo.get("instanceName")));
82+
}
83+
}
84+
85+
if (forceCreate) {
86+
System.out.println(
87+
"Warning: forceCreate option compromise the integrity of your image. "
88+
+ "Stop the instance before you create the image if possible.");
89+
}
90+
91+
// Create Image.
92+
Image image = Image.newBuilder()
93+
.setName(imageName)
94+
.setSourceDisk(String.format("/zones/%s/disks/%s", zone, sourceDiskName))
95+
.addStorageLocations(storageLocation.isEmpty() ? "" : storageLocation)
96+
.build();
97+
98+
InsertImageRequest insertImageRequest = InsertImageRequest.newBuilder()
99+
.setProject(project)
100+
.setForceCreate(forceCreate)
101+
.setImageResource(image)
102+
.build();
103+
104+
Operation response = imagesClient.insertAsync(insertImageRequest).get(3, TimeUnit.MINUTES);
105+
106+
if (response.hasError()) {
107+
System.out.println("Windows OS Image creation failed ! ! " + response);
108+
return;
109+
}
110+
111+
System.out.println("Image created.");
112+
}
113+
}
114+
115+
116+
public static Map<String, String> parseInstanceName(String name) {
117+
String[] parsedName = name.split("/");
118+
int splitLength = parsedName.length;
119+
120+
if (splitLength < 5) {
121+
throw new IllegalArgumentException(
122+
"Provide correct instance name in the following format: "
123+
+ "https://www.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME");
124+
}
125+
126+
return new HashMap<>() {
127+
{
128+
put("instanceName", parsedName[splitLength - 1]);
129+
put("instanceZone", parsedName[splitLength - 3]);
130+
put("instanceProjectId", parsedName[splitLength - 5]);
131+
}
132+
};
133+
}
134+
135+
}
136+
// [END compute_windows_image_create]

‎compute/cloud-client/src/main/java/compute/windows/windowsinstances/CreateFirewallRuleForWindowsActivationHost.java‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
// Copyright 2022 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
package compute.windows.windowsinstances;
16+
17+
// [START compute_create_egress_rule_windows_activation]
18+
19+
import com.google.cloud.compute.v1.Allowed;
20+
import com.google.cloud.compute.v1.Firewall;
21+
import com.google.cloud.compute.v1.FirewallsClient;
22+
import com.google.cloud.compute.v1.InsertFirewallRequest;
23+
import com.google.cloud.compute.v1.Operation;
24+
import java.io.IOException;
25+
import java.util.concurrent.ExecutionException;
26+
import java.util.concurrent.TimeUnit;
27+
import java.util.concurrent.TimeoutException;
28+
29+
public class CreateFirewallRuleForWindowsActivationHost {
30+
31+
public static void main(String[] args)
32+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
33+
// TODO(developer): Replace these variables before running the sample.
34+
// projectId - ID or number of the project you want to use.
35+
String projectId = "your-google-cloud-project-id";
36+
37+
// firewallRuleName - Name of the firewall rule you want to create.
38+
String firewallRuleName = "firewall-rule-name";
39+
40+
// networkName - Name of the network you want the new instance to use.
41+
// * For example: "global/networks/default" represents the network
42+
// * named "default", which is created automatically for each project.
43+
String networkName = "global/networks/default";
44+
45+
createFirewallRuleForWindowsActivationHost(projectId, firewallRuleName, networkName);
46+
}
47+
48+
// Creates a new allow egress firewall rule with the highest priority for host
49+
// kms.windows.googlecloud.com (35.190.247.13) for Windows activation.
50+
public static void createFirewallRuleForWindowsActivationHost(String projectId,
51+
String firewallRuleName, String networkName)
52+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
53+
// Instantiates a client.
54+
try (FirewallsClient firewallsClient = FirewallsClient.create()) {
55+
56+
Firewall firewall = Firewall.newBuilder()
57+
.setName(firewallRuleName)
58+
// These are the default values for kms.windows.googlecloud.com
59+
// See, https://cloud.google.com/compute/docs/instances/windows/creating-managing-windows-instances#firewall_rule_requirements
60+
.addAllowed(Allowed.newBuilder()
61+
.setIPProtocol("tcp")
62+
.addPorts("1688")
63+
.build())
64+
.setDirection("EGRESS")
65+
.setNetwork(networkName)
66+
.addDestinationRanges("35.190.247.13/32")
67+
.setPriority(0)
68+
.build();
69+
70+
InsertFirewallRequest request = InsertFirewallRequest.newBuilder()
71+
.setProject(projectId)
72+
.setFirewallResource(firewall)
73+
.build();
74+
75+
// Wait for the operation to complete.
76+
Operation operation = firewallsClient.insertAsync(request).get(3, TimeUnit.MINUTES);
77+
78+
if (operation.hasError()) {
79+
System.out.println("Firewall rule creation failed ! ! " + operation.getError());
80+
return;
81+
}
82+
83+
System.out.printf("Firewall rule created %s", firewallRuleName);
84+
}
85+
}
86+
}
87+
// [END compute_create_egress_rule_windows_activation]

‎compute/cloud-client/src/main/java/compute/windows/windowsinstances/CreateRouteToWindowsActivationHost.java‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
// Copyright 2022 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
package compute.windows.windowsinstances;
16+
17+
// [START compute_create_route_windows_activation]
18+
19+
import com.google.cloud.compute.v1.InsertRouteRequest;
20+
import com.google.cloud.compute.v1.Operation;
21+
import com.google.cloud.compute.v1.Route;
22+
import com.google.cloud.compute.v1.RoutesClient;
23+
import java.io.IOException;
24+
import java.util.concurrent.ExecutionException;
25+
import java.util.concurrent.TimeUnit;
26+
import java.util.concurrent.TimeoutException;
27+
28+
public class CreateRouteToWindowsActivationHost {
29+
30+
public static void main(String[] args)
31+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
32+
// TODO(developer): Replace these variables before running the sample.
33+
// projectId - ID or number of the project you want to use.
34+
String projectId = "your-google-cloud-project-id";
35+
36+
// routeName - Name of the route you want to create.
37+
String routeName = "route-name";
38+
39+
// networkName - Name of the network you want the new instance to use.
40+
// * For example: "global/networks/default" represents the network
41+
// * named "default", which is created automatically for each project.
42+
String networkName = "global/networks/default";
43+
44+
createRouteToWindowsActivationHost(projectId, routeName, networkName);
45+
}
46+
47+
// Creates a new route to kms.windows.googlecloud.com (35.190.247.13) for Windows activation.
48+
public static void createRouteToWindowsActivationHost(String projectId, String routeName,
49+
String networkName)
50+
throws IOException, ExecutionException, InterruptedException, TimeoutException {
51+
// Instantiates a client.
52+
try (RoutesClient routesClient = RoutesClient.create()) {
53+
54+
// If you have Windows instances without external IP addresses,
55+
// you must also enable Private Google Access so that instances
56+
// with only internal IP addresses can send traffic to the external
57+
// IP address for kms.windows.googlecloud.com.
58+
// More information: https://cloud.google.com/vpc/docs/configure-private-google-access#enabling
59+
Route route = Route.newBuilder()
60+
.setName(routeName)
61+
.setDestRange("35.190.247.13/32")
62+
.setNetwork(networkName)
63+
.setNextHopGateway(
64+
String.format("projects/%s/global/gateways/default-internet-gateway", projectId))
65+
.build();
66+
67+
InsertRouteRequest request = InsertRouteRequest.newBuilder()
68+
.setProject(projectId)
69+
.setRouteResource(route)
70+
.build();
71+
72+
// Wait for the operation to complete.
73+
Operation operation = routesClient.insertAsync(request).get(3, TimeUnit.MINUTES);
74+
75+
if (operation.hasError()) {
76+
System.out.printf("Error in creating route %s", operation.getError());
77+
return;
78+
}
79+
80+
System.out.printf("Route created %s", routeName);
81+
}
82+
}
83+
}
84+
// [END compute_create_route_windows_activation]

0 commit comments

Comments
 (0)