Skip to content

Commit

Permalink
Merge pull request #1352 from replicatedhq/replicated-instance-types
Browse files Browse the repository at this point in the history
HOLD FOR RELEASE - Document replicated instance types for VMs
  • Loading branch information
paigecalvert authored Aug 4, 2023
2 parents 9529cd5 + b841ca2 commit dfb93e8
Show file tree
Hide file tree
Showing 4 changed files with 83 additions and 14 deletions.
15 changes: 1 addition & 14 deletions docs/reference/replicated-cli-cluster-create.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,12 +35,7 @@ replicated cluster create [flags]
<tr>
<td>--instance-type</td>
<td>string</td>
<td>The type of instance to use for cloud-based clusters, such as x5.xlarge.</td>
</tr>
<tr>
<td>--memory</td>
<td>integer</td>
<td>The amount of memory (GiB) to request per node. Required for VM clusters. <strong>Default:</strong> 4</td>
<td>The type of instance to use for nodes in the cluster, such as x5.xlarge. For VM-based clusters, see <a href="/vendor/testing-replicated-instance-types">Replicated Instance Types</a>.</td>
</tr>
<tr>
<td>--name</td>
Expand All @@ -62,11 +57,6 @@ replicated cluster create [flags]
<td>string</td>
<td>The cluster Time to Live (TTL) duration, in hours, before the cluster is automatically deleted by the service. TTL starts when the cluster is in a Ready state. <strong>Valid values:</strong> 1 - 48. <strong>Default:</strong> 1</td>
</tr>
<tr>
<td>--vcpu</td>
<td>integer</td>
<td>The number of vCPUs to request per node. Required for VM clusters. <strong>Default:</strong> 4</td>
</tr>
<tr>
<td>--version</td>
<td>string</td>
Expand All @@ -87,6 +77,3 @@ For an EKS distribution:
replicated cluster create --name eks-example --distribution eks --version 1.27 --node-count 3 --instance-type m5.xlarge
```

:::note
For VM distributions, you must specify `--vpcu` and `--memory` instead of `--instance-type`.
:::
37 changes: 37 additions & 0 deletions docs/vendor/testing-replicated-instance-types.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Replicated Instance Types

When creating a VM-based cluster, you must specify a Replicated instance type.


<table>
<tr>
<th width="30%">Type</th>
<th width="35%">Memory (GiB)</th>
<th width="35%">VCPU Count</th>
</tr>
<tr>
<th>r1.small</th>
<td>8 GB</td>
<td>2 VCPUs</td>
</tr>
<tr>
<th>r1.medium</th>
<td>16 GB</td>
<td>4 VCPUs</td>
</tr>
<tr>
<th>r1.large</th>
<td>32 GB</td>
<td>8 VCPUs</td>
</tr>
<tr>
<th>r1.xlarge</th>
<td>64 GB</td>
<td>16 VCPUs</td>
</tr>
<tr>
<th>r1.2xlarge</th>
<td>128 GB</td>
<td>32 VCPUs</td>
</tr>
</table>
44 changes: 44 additions & 0 deletions docs/vendor/testing-supported-clusters.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,11 @@ The compatibility matrix supports creating single-node [kind](https://kind.sigs.
<th>Limitations</th>
<td>See <a href="testing-how-to#limitations">Limitations</a></td>
</tr>
<tr>
<th>Node and Supported Instance Types</th>
<td><ul><li>Specify a Replicated instance type for the nodes.
</li></ul></td>
</tr>
<tr>
<th>Common Use Cases</th>
<td>Smoke tests</td>
Expand All @@ -50,6 +55,11 @@ The compatibility matrix supports creating single-node [k3s](https://k3s.io) clu
<th>Supported Kubernetes Versions</th>
<td>1.24, 1.25, 1.26</td>
</tr>
<tr>
<th>Node and Supported Instance Types</th>
<td><ul><li>Specify a Replicated instance type for the nodes.
</li></ul></td>
</tr>
<tr>
<th>Limitations</th>
<td>You can only choose a minor version, not a patch version. The K3s installer chooses the latest patch for that minor version. See <a href="https://docs.k3s.io/upgrades/manual">k3s</a>.<br></br><br></br>For additional limitations, see <a href="testing-how-to#limitations">Limitations</a>.</td>
Expand Down Expand Up @@ -77,6 +87,40 @@ The compatibility matrix supports creating single-node [Red Hat OpenShift OKD](h
<th>Limitations</th>
<td>See <a href="testing-how-to#limitations">Limitations</a></td>
</tr>
<tr>
<th>Node and Supported Instance Types</th>
<td><ul><li>Specify a Replicated instance type for the nodes.
</li></ul></td>
</tr>
<tr>
<th>Common Use Cases</th>
<td>Customer release tests</td>
</tr>
</table>


### Helm VM

The compatibility matrix supports creating single-node [HelmVM](https://github.com/replicatedhq/helmbin) clusters, which is a version of Kubernetes that has a Helm chart embedded and runs as a single binary.

<table>
<tr>
<th width="35%">Type</th>
<th width="65%">Description</th>
</tr>
<tr>
<th>Supported HelmVM Version</th>
<td>1.27</td>
</tr>
<tr>
<th>Limitations</th>
<td>See <a href="testing-how-to#limitations">Limitations</a></td>
</tr>
<tr>
<th>Node and Supported Instance Types</th>
<td><ul><li>Specify a Replicated instance type for the nodes.
</li></ul></td>
</tr>
<tr>
<th>Common Use Cases</th>
<td>Customer release tests</td>
Expand Down
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -583,6 +583,7 @@ const sidebars = {
items: [
'vendor/testing-about',
'vendor/testing-supported-clusters',
'vendor/testing-replicated-instance-types',
'vendor/testing-how-to',
],
},
Expand Down

0 comments on commit dfb93e8

Please sign in to comment.