Fix formatting

This commit is contained in:
Joshua Boniface 2024-10-25 02:25:47 -04:00
parent e853f972f1
commit c6eddb6ece
1 changed files with 28 additions and 11 deletions

View File

@ -66,10 +66,20 @@ You will also need a switch to connect the nodes, capable of vLAN trunks passing
``` ```
$ sudo mkdir -p /etc/apt/keyrings $ sudo mkdir -p /etc/apt/keyrings
```
```
$ wget -O- https://repo.parallelvirtualcluster.org/debian/pvc.pub | sudo gpg --dearmor --output /etc/apt/keyrings/pvc.gpg $ wget -O- https://repo.parallelvirtualcluster.org/debian/pvc.pub | sudo gpg --dearmor --output /etc/apt/keyrings/pvc.gpg
```
```
$ CODENAME="$( awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release )" $ CODENAME="$( awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release )"
```
```
$ echo "deb [signed-by=/etc/apt/keyrings/pvc.gpg] https://repo.parallelvirtualcluster.org/debian/ ${CODENAME} pvc" | sudo tee /etc/apt/sources.list.d/pvc.list $ echo "deb [signed-by=/etc/apt/keyrings/pvc.gpg] https://repo.parallelvirtualcluster.org/debian/ ${CODENAME} pvc" | sudo tee /etc/apt/sources.list.d/pvc.list
```
```
$ sudo apt update $ sudo apt update
```
```
$ sudo apt install pvc-client-cli $ sudo apt install pvc-client-cli
``` ```
@ -79,7 +89,6 @@ You will also need a switch to connect the nodes, capable of vLAN trunks passing
0. In your local repository, edit the `hosts` file and add a new cluster. How you do so is technically up to you, but for those without advanced Ansible experience, the following format is simplest: 0. In your local repository, edit the `hosts` file and add a new cluster. How you do so is technically up to you, but for those without advanced Ansible experience, the following format is simplest:
```
[cluster1] [cluster1]
hv1.cluster1.mydomain.tld hv1.cluster1.mydomain.tld
hv2.cluster1.mydomain.tld hv2.cluster1.mydomain.tld
@ -89,7 +98,6 @@ You will also need a switch to connect the nodes, capable of vLAN trunks passing
hv1.cluster2.mydomain.tld hv1.cluster2.mydomain.tld
hv2.cluster2.mydomain.tld hv2.cluster2.mydomain.tld
hv3.cluster2.mydomain.tld hv3.cluster2.mydomain.tld
```
Note that the hostnames given here must be the actual reachable FQDNs of the hypervisor nodes; if they do not resolve in DNS, you can use the `ansible_host=` per-entry variable to set the IP address in the "upstream" network for each node. Note that the hostnames given here must be the actual reachable FQDNs of the hypervisor nodes; if they do not resolve in DNS, you can use the `ansible_host=` per-entry variable to set the IP address in the "upstream" network for each node.
@ -107,7 +115,6 @@ The `default` version of this file is well-commented, and should hopefully provi
**NOTE** Pay close attention to any "Use X to generate" comments; these are recommendations to use the program "X" to generate a value that must be filled. **NOTE** Pay close attention to any "Use X to generate" comments; these are recommendations to use the program "X" to generate a value that must be filled.
```
--- ---
# The name of the Ansible cluster group, used to set file paths and determine hosts in the cluster # The name of the Ansible cluster group, used to set file paths and determine hosts in the cluster
# This should match the lowest-level group in the Ansible `hosts` file that defines this cluster # This should match the lowest-level group in the Ansible `hosts` file that defines this cluster
@ -318,7 +325,6 @@ The `default` version of this file is well-commented, and should hopefully provi
subnet: 10.0.1.0 # The CIDR subnet address without the netmask; this should be an UNROUTED network (no gateway) subnet: 10.0.1.0 # The CIDR subnet address without the netmask; this should be an UNROUTED network (no gateway)
netmask: 24 # The CIDR netmask netmask: 24 # The CIDR netmask
floating_ip: 10.0.1.254 # The floating IP used by the cluster primary coordinator; should be a high IP that won't conflict with any node IDs floating_ip: 10.0.1.254 # The floating IP used by the cluster primary coordinator; should be a high IP that won't conflict with any node IDs
```
### `pvc.yml` ### `pvc.yml`
@ -332,7 +338,6 @@ The `default` version of this file is well-commented, and should hopefully provi
Of special note is the `pvc_nodes` section. This must contain a listing of all nodes in the cluster. For most clusters, start only with the 3 (or 5 if a large cluster is planned) coordinator nodes, and add the remainder in later. Of special note is the `pvc_nodes` section. This must contain a listing of all nodes in the cluster. For most clusters, start only with the 3 (or 5 if a large cluster is planned) coordinator nodes, and add the remainder in later.
```
--- ---
# Logging configuration (uncomment to override defaults) # Logging configuration (uncomment to override defaults)
# These default options are generally best for most clusters; override these if you want more granular # These default options are generally best for most clusters; override these if you want more granular
@ -656,7 +661,6 @@ Of special note is the `pvc_nodes` section. This must contain a listing of all n
pvc_storage_netmask: "{{ networks['storage']['netmask'] }}" pvc_storage_netmask: "{{ networks['storage']['netmask'] }}"
pvc_storage_subnet: "{{ networks['storage']['subnet'] }}" pvc_storage_subnet: "{{ networks['storage']['subnet'] }}"
pvc_storage_floatingip: "{{ networks['storage']['floating_ip'] }}" pvc_storage_floatingip: "{{ networks['storage']['floating_ip'] }}"
```
## Part Three: Prepare the Installer ISO and install the node base OS ## Part Three: Prepare the Installer ISO and install the node base OS
@ -722,6 +726,8 @@ Of special note is the `pvc_nodes` section. This must contain a listing of all n
``` ```
$ pvc connection add -a <upstream_floating_ip> -d "My first PVC cluster" cluster1 $ pvc connection add -a <upstream_floating_ip> -d "My first PVC cluster" cluster1
```
```
$ pvc -c mycluster node list $ pvc -c mycluster node list
``` ```
@ -747,11 +753,22 @@ Of special note is the `pvc_nodes` section. This must contain a listing of all n
``` ```
$ pvc storage osd add --weight 1.0 pvchv1 /dev/sdb $ pvc storage osd add --weight 1.0 pvchv1 /dev/sdb
```
```
$ pvc storage osd add --weight 1.0 pvchv2 /dev/sdb $ pvc storage osd add --weight 1.0 pvchv2 /dev/sdb
```
```
$ pvc storage osd add --weight 1.0 pvchv3 /dev/sdb $ pvc storage osd add --weight 1.0 pvchv3 /dev/sdb
```
```
$ pvc storage osd add --weight 1.0 pvchv1 /dev/sdc $ pvc storage osd add --weight 1.0 pvchv1 /dev/sdc
```
```
$ pvc storage osd add --weight 1.0 pvchv2 /dev/sdc $ pvc storage osd add --weight 1.0 pvchv2 /dev/sdc
```
```
$ pvc storage osd add --weight 1.0 pvchv3 /dev/sdc $ pvc storage osd add --weight 1.0 pvchv3 /dev/sdc
```
**NOTE** On the CLI, the `--weight` argument is optional, and defaults to `1.0`. In the API, it must be specified explicitly, but the CLI sets a default value. OSD weights determine the relative amount of data which can fit onto each OSD. Under normal circumstances, you would want all OSDs to be of identical size, and hence all should have the same weight. If your OSDs are instead different sizes, the weight should be proportional to the size, e.g. `1.0` for a 100GB disk, `2.0` for a 200GB disk, etc. For more details, see the [Cluster Architecture](/cluster-architecture) and Ceph documentation. **NOTE** On the CLI, the `--weight` argument is optional, and defaults to `1.0`. In the API, it must be specified explicitly, but the CLI sets a default value. OSD weights determine the relative amount of data which can fit onto each OSD. Under normal circumstances, you would want all OSDs to be of identical size, and hence all should have the same weight. If your OSDs are instead different sizes, the weight should be proportional to the size, e.g. `1.0` for a 100GB disk, `2.0` for a 200GB disk, etc. For more details, see the [Cluster Architecture](/cluster-architecture) and Ceph documentation.