Skip to content

Commit 89d14d4

Browse files
committed
add steps for adding dns records to vms
1 parent 8ef23e4 commit 89d14d4

File tree

2 files changed

+92
-3
lines changed

2 files changed

+92
-3
lines changed

docs/vendor/testing-how-to.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,13 +82,15 @@ To create a cluster using the Replicated CLI:
8282

8383
To create a cluster using the Vendor Portal:
8484

85-
1. Go to [**Compatibility Matrix > Create cluster**](https://vendor.replicated.com/compatibility-matrix/create-cluster).
85+
1. Go to [**Compatibility Matrix**](https://vendor.replicated.com/compatibility-matrix/create-cluster).
86+
87+
1. Click **Create > Create Kubernetes cluster**.
8688

8789
<img alt="Create a cluster page" src="/images/create-a-cluster.png" width="650px"/>
8890

8991
[View a larger version of this image](/images/create-a-cluster.png)
9092

91-
1. On the **Create a cluster** page, complete the following fields:
93+
1. On the **Create a Kubernetes cluster** page, complete the following fields:
9294

9395
<table>
9496
<tr>

docs/vendor/testing-vm-create.md

Lines changed: 88 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,8 @@ replicated vm create --distribution ubuntu --version 24.04 --ssh-public-key ~/.s
111111
112112
## Create VMs
113113
114+
### With the Replicated CLI
115+
114116
To create VMs with Compatibility Matrix:
115117
116118
1. (Optional) View the available VM distributions, including the supported VM distribution versions and instance types:
@@ -152,6 +154,70 @@ To create VMs with Compatibility Matrix:
152154
replicated vm create --distribution ubuntu --version 22.04 --disk 50 --instance-type r1.medium
153155
```
154156
157+
### With the Vendor Portal
158+
159+
To create a VM from the Vendor Portal:
160+
161+
To create a cluster using the Vendor Portal:
162+
163+
1. In the Vendor Portal, go to [**Compatibility Matrix](https://vendor.replicated.com/compatibility-matrix).
164+
165+
<img alt="Create a cluster page" src="/images/create-a-cluster.png" width="650px"/>
166+
167+
[View a larger version of this image](/images/create-a-cluster.png)
168+
169+
1. Click **Create > Create VM**.
170+
171+
1. On the **Create a Virtual Machine** page, complete the following fields:
172+
173+
<table>
174+
<tr>
175+
<th>Field</th>
176+
<th>Description</th>
177+
</tr>
178+
<tr>
179+
<td>OS distribution</td>
180+
<td>Select the OS distribution for the VM.</td>
181+
</tr>
182+
<tr>
183+
<td>Version</td>
184+
<td>Select the OS version. The options available are specific to the distribution selected.</td>
185+
</tr>
186+
<tr>
187+
<td>Name (optional)</td>
188+
<td>Enter an optional name for the VM.</td>
189+
</tr>
190+
<tr>
191+
<td>Tags</td>
192+
<td>Add one or more tags to the VM as key-value pairs.</td>
193+
</tr>
194+
<tr>
195+
<td>Set TTL</td>
196+
<td>Select the Time to Live (TTL) for the VM. When the TTL expires, the VM is automatically deleted. TTL can be adjusted after VM creation with [vm update ttl](/reference/replicated-cli-vm-update-ttl).</td>
197+
</tr>
198+
</table>
199+
200+
1. For **VM Config**, complete the following fields:
201+
202+
<table>
203+
<tr>
204+
<td>Instance type</td>
205+
<td>Select the instance type to use for the nodes in the node group. The options available are specific to the distribution selected.</td>
206+
</tr>
207+
<tr>
208+
<td>Disk size</td>
209+
<td>Select the disk size in GiB to use per node.</td>
210+
</tr>
211+
<tr>
212+
<td>Count</td>
213+
<td>Select the number of VMs to provision.</td>
214+
</tr>
215+
</table>
216+
217+
1. Click **Create VM**.
218+
219+
The VM is displayed on the **Compatibility Matrix** page. When the SSH endpoint for the VM is available, the VM's status is changed to `running`.
220+
155221
## Connect to a VM
156222

157223
You can SSH into a VM using one of the following methods:
@@ -236,7 +302,28 @@ To connect to a VM using direct SSH:
236302
237303
```
238304
ssh $(replicated vm ssh-endpoint aba1acc2)
239-
```
305+
```
306+
307+
## Expose Ports on Running VMs
308+
309+
After creating a VM, you can create update the ingress and ports settings to add DNS records. This allows you to connect to ports on the VM.
310+
311+
To update the ingress and ports settings for a running VM:
312+
313+
1. In the Vendor Portal, go to [**Compatibility Matrix**](https://vendor.replicated.com/compatibility-matrix).
314+
315+
1. Open the dot menu for the target VM and click **Edit**.
316+
317+
![Edit VM in the dot menu](/images/compatibility-matrix-edit-vm.png)
318+
319+
[View a larger version of this image](/images/compatibility-matrix-edit-vm.png)
320+
321+
1. Under **Ingress & Ports**, for **Add DNS record**, edit the fields as desired and click **Add** to create a DNS record.
322+
323+
![DNS record for a VM](/images/compatibility-matrix-dns-record.png)
324+
[View a larger version of this image](/images/compatibility-matrix-dns-record.png)
325+
326+
A DNS record and valid TLS cert are created and connected to the specified port.
240327
241328
## Copy Files to a VM
242329

0 commit comments

Comments
 (0)