Skip to content

Commit 03c48c4

Browse files
committed
Document how to create a Google Cloud VM
1 parent a353235 commit 03c48c4

16 files changed

+98
-0
lines changed

README.md

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,3 +140,101 @@ assistance.
140140
1. Click the **download JSON** button in the resulting dialog, and save the file for later:
141141

142142
![download JSON button](docs/download_json.png)
143+
144+
145+
### Optional: Creating a Google Cloud virtual machine
146+
147+
This section illustrates how to set up a hosted VM on Google Cloud, which is free in the short term
148+
under the service's trial. There is no technical reason this project has to be hosted on Google
149+
infrastructure. Skip this section if you already have a server or VM available.
150+
151+
1. From the Google Cloud console at [console.cloud.google.com](https://console.cloud.google.com),
152+
click the **activate** button in the upper-right corner of the page and follow the resulting
153+
steps to start your free trial:
154+
155+
![activate button](docs/activate.png)
156+
157+
1. In the upper-left corner of the page, click **Select a project** or the name of the selected
158+
project:
159+
160+
![select a project button](docs/select_a_project_button.png)
161+
162+
1. In the upper-right corner of the resulting dialog, click **new project**:
163+
164+
![select a project dialog](docs/select_a_project_dialog.png)
165+
166+
1. Give your project a(n internal) name and hit **create**:
167+
168+
![new project page](docs/new_project.png)
169+
170+
1. Once the Notifications panel shows a green check mark, click **select project**:
171+
172+
![notifications](docs/notifications.png)
173+
174+
1. If no sidebar is open on the left side of the page, click the hamburger button in the upper left:
175+
176+
![navigation menu button](docs/hamburger.png)
177+
178+
1. In the sidebar on the left, hover over **VPC network** and select **IP addresses**:
179+
180+
![VPC network menu](docs/vpc_network.png)
181+
182+
1. Click the **reserve external static address** button:
183+
184+
![reserve external static address button](docs/ip_addresses.png)
185+
186+
1. Give the IP address a name, set its Network Service Tier to **Standard**, and hit **reserve**:
187+
188+
![reserve a static address page](docs/reserve_a_static_address.png)
189+
190+
1. Take note of the IP address on the resulting page, as you will need it later:
191+
192+
![IP address display](docs/ip_address.png)
193+
194+
1. If you do not want your instance to support GUI applications, skip this step. Otherwise, in the
195+
sidebar on the left, hover over **VPC network** and select **Firewall**. Click the **create
196+
firewall rule** button at the top. Name the rule `allow-novnc`, leave Direction of traffic set
197+
to Ingress and Action on match set to Allow, and set Targets to **All instances in the network**
198+
and Source IPv4 ranges to `0.0.0.0/0`. Check the **TCP** box and enter `6081-7999`. Finally,
199+
hit the **create** button.
200+
201+
![create a firewall rule page](docs/create_a_firewall_rule.png)
202+
203+
1. In the sidebar on the left, hover over **Compute Engine** and select **VM instances** under
204+
virtual machines:
205+
206+
![Compute Engine menu](docs/compute_engine.png)
207+
208+
1. Click the blue **enable** button and wait for the spinner to go away and the page to reload:
209+
210+
![enable button](docs/enable_compute_engine.png)
211+
212+
1. At the top of the page, click **create instance**:
213+
214+
![create instance button](docs/create_instance.png)
215+
216+
1. Select a name and region, and leave the default Debian boot disk image selected:
217+
218+
![name and region](docs/name_and_region.png)
219+
220+
1. Under Firewall, check **Allow HTTPS traffic**:
221+
222+
![firewall](docs/firewall.png)
223+
224+
1. Expand **networking, disks, security, management, sole-tenancy**, expand **Networking**, then
225+
expand **default** under Network interfaces:
226+
227+
![network interfaces heading](docs/network_interfaces.png)
228+
229+
1. Set **External IPv4 address** to the one you created above and hit **done**:
230+
231+
![external IPv4 address dropdown](docs/external_ipv4_address.png)
232+
233+
1. At the bottom of the page, hit the **create** button:
234+
235+
![create button](docs/create.png)
236+
237+
1. On the resulting page, wait for the Status spinner to turn into a green check mark, then click
238+
the SSH button:
239+
240+
![VM instances page](docs/vm_instances.png)

docs/activate.png

1.11 KB
Loading

docs/compute_engine.png

34.3 KB
Loading

docs/create.png

943 Bytes
Loading

docs/create_a_firewall_rule.png

38.4 KB
Loading

docs/create_instance.png

1.6 KB
Loading

docs/enable_compute_engine.png

9.7 KB
Loading

docs/external_ipv4_address.png

21.4 KB
Loading

docs/firewall.png

9.31 KB
Loading

docs/ip_address.png

9.66 KB
Loading

docs/ip_addresses.png

21.4 KB
Loading

docs/name_and_region.png

12.7 KB
Loading

docs/network_interfaces.png

10.8 KB
Loading

docs/reserve_a_static_address.png

50.6 KB
Loading

docs/vm_instances.png

7.92 KB
Loading

docs/vpc_network.png

24.1 KB
Loading

0 commit comments

Comments
 (0)