Skip to content

Commit c4b2a16

Browse files
lab3-compute-resources.md (#2642)
Grammar check
1 parent dda66e3 commit c4b2a16

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

docs/labs/kubernetes-the-hard-way/lab3-compute-resources.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,19 +13,19 @@ tags:
1313

1414
This is a fork of the original ["Kubernetes the hard way"](https://github.com/kelseyhightower/kubernetes-the-hard-way) originally written by Kelsey Hightower (GitHub: kelseyhightower). Unlike the original, which bases itself on Debian-like distributions for the ARM64 architecture, this fork targets Enterprise Linux distributions such as Rocky Linux, which runs on x86_64 architecture.
1515

16-
Kubernetes requires a set of machines to host the Kubernetes control plane and the worker nodes where containers are ultimately run. In this lab you will provision the machines required for setting up a Kubernetes cluster.
16+
Kubernetes requires a set of machines to host the Kubernetes control plane and the worker nodes where containers are ultimately run. In this lab, you will provide the machines required to set up a Kubernetes cluster.
1717

1818
## Machine Database
1919

20-
This tutorial will leverage a text file, which will serve as a machine database, to store the various machine attributes that you will use when setting up the Kubernetes control plane and worker nodes. The following schema represents entries in the machine database, one entry per line:
20+
This tutorial will leverage a text file, which will serve as a machine database, to store the various machine attributes you will use when setting up the Kubernetes control plane and worker nodes. The following schema represents entries in the machine database, one entry per line:
2121

2222
```text
2323
IPV4_ADDRESS FQDN HOSTNAME POD_SUBNET
2424
```
2525

26-
Each of the columns corresponds to a machine IP address `IPV4_ADDRESS`, fully qualified domain name `FQDN`, host name `HOSTNAME`, and the IP subnet `POD_SUBNET`. Kubernetes assigns one IP address per `pod` and the `POD_SUBNET` represents the unique IP address range assigned to each machine in the cluster for doing so.
26+
Each column corresponds to a machine IP address `IPV4_ADDRESS`, fully qualified domain name `FQDN`, host name `HOSTNAME`, and the IP subnet `POD_SUBNET`. Kubernetes assigns one IP address per `pod`, and the `POD_SUBNET` represents the unique IP address range assigned to each machine in the cluster for doing so.
2727

28-
Here is an example machine database similar to the one used when creating this tutorial. Notice the hidden IP addresses. You can assign any IP address to your machines provided that each machine is reachable from each other and the `jumpbox`.
28+
Here is an example machine database similar to the one used to create this tutorial. Please take a look at the hidden IP addresses. You can assign any IP address to your machines, provided they are reachable from each other and the `jumpbox`.
2929

3030
```bash
3131
cat machines.txt
@@ -37,17 +37,17 @@ XXX.XXX.XXX.XXX node-0.kubernetes.local node-0 10.200.0.0/24
3737
XXX.XXX.XXX.XXX node-1.kubernetes.local node-1 10.200.1.0/24
3838
```
3939

40-
Now it is your turn to create a `machines.txt` file with the details for the three machines you will be using to create your Kubernetes cluster. Use the example machine database from above and add the details for your machines.
40+
Now, it is your turn to create a `machines.txt` file with the details for the three machines you will use to create your Kubernetes cluster. You can use the example machine database from above to add the details for your machines.
4141

4242
## Configuring SSH Access
4343

4444
You will use SSH to configure the machines in the cluster. Verify that you have `root` SSH access to each machine listed in your machine database. You might need to enable root SSH access on each node by updating the `sshd_config` file and restarting the SSH server.
4545

4646
### Enable root SSH Access
4747

48-
If you have `root` SSH access for each of your machines you can skip this section.
48+
You can skip this section if you have `root` SSH access for each of your machines.
4949

50-
By default, a new `Rocky Linux` install disables SSH access for the `root` user. This is for security reasons, as the `root` user has total administrative control of unix-like systems. Weak passwords are very bad for internet connected machines. As mentioned earlier, you are going to enable `root` access over SSH to streamline the steps in this tutorial. Security is a trade-off, and in this case, you are optimizing for convenience.
50+
A new `Rocky Linux` install disables SSH access for the `root` user by default. This is for security reasons, as the `root` user has total administrative control of Unix-like systems. Weak passwords are awful for internet-connected machines. As mentioned earlier, you will enable `root` access over SSH to streamline the steps in this tutorial. Security is a trade-off; in this case, you are optimizing for convenience.
5151

5252
Log on to each machine using SSH and your user account, then switch to the `root` user with the `su` command:
5353

@@ -114,7 +114,7 @@ x86_64 GNU/Linux
114114

115115
## Hostnames
116116

117-
In this section you will assign hostnames to the `server`, `node-0`, and `node-1` machines. You will use the hostname when executing commands from the `jumpbox` to each machine. The hostname also plays a major role within the cluster. Instead of Kubernetes clients using an IP address to issue commands to the Kubernetes API server, those clients will use the `server` hostname instead. Hostnames are also used by each worker machine, `node-0` and `node-1` when registering with a given Kubernetes cluster.
117+
In this section, you will assign hostnames to the `server`, `node-0`, and `node-1` machines. You will use the hostname when executing commands from the `jumpbox` to each machine. The hostname also plays a major role within the cluster. Instead of Kubernetes clients using an IP address to issue commands to the Kubernetes API server, those clients will use the `server` hostname instead. Hostnames are also used by each worker machine, `node-0` and `node-1`, when registering with a given Kubernetes cluster.
118118

119119
To configure the hostname for each machine, run the following commands on the `jumpbox`.
120120

@@ -145,7 +145,7 @@ node-1.kubernetes.local
145145

146146
## Host Lookup Table
147147

148-
In this section you will generate a `hosts` file and append it to `/etc/hosts` file on `jumpbox` and to the `/etc/hosts` files on all three cluster members used for this tutorial. This will allow each machine to be reachable using a hostname such as `server`, `node-0`, or `node-1`.
148+
In this section, you will generate a `hosts` file and append it to `/etc/hosts` file on `jumpbox` and to the `/etc/hosts` files on all three cluster members used for this tutorial. This will allow each machine to be reachable using a hostname such as `server`, `node-0`, or `node-1`.
149149

150150
Create a new `hosts` file and add a header to identify the machines being added:
151151

@@ -179,7 +179,7 @@ XXX.XXX.XXX.XXX node-1.kubernetes.local node-1
179179

180180
## Adding `/etc/hosts` Entries To A Local Machine
181181

182-
In this section you will append the DNS entries from the `hosts` file to the local `/etc/hosts` file on your `jumpbox` machine.
182+
In this section, you will append the DNS entries from the `hosts` file to the local `/etc/hosts` file on your `jumpbox` machine.
183183

184184
Append the DNS entries from `hosts` to `/etc/hosts`:
185185

@@ -203,7 +203,7 @@ XXX.XXX.XXX.XXX node-0.kubernetes.local node-0
203203
XXX.XXX.XXX.XXX node-1.kubernetes.local node-1
204204
```
205205

206-
At this point you should be able to SSH to each machine listed in the `machines.txt` file by using a hostname.
206+
You should be able to SSH each machine listed in the `machines.txt` file using a hostname.
207207

208208
```bash
209209
for host in server node-0 node-1
@@ -219,7 +219,7 @@ node-1 x86_64 GNU/Linux
219219

220220
## Adding `/etc/hosts` Entries To The Remote Machines
221221

222-
In this section you will append the host entries from `hosts` to `/etc/hosts` on each machine listed in the `machines.txt` text file.
222+
In this section, you will append the host entries from `hosts` to `/etc/hosts` on each machine listed in the `machines.txt` text file.
223223

224224
Copy the `hosts` file to each machine and append the contents to `/etc/hosts`:
225225

@@ -231,6 +231,6 @@ while read IP FQDN HOST SUBNET; do
231231
done < machines.txt
232232
```
233233

234-
At this point you can use hostnames when connecting to machines from your `jumpbox` machine, or any of the three machines in the Kubernetes cluster. Instead of using IP addresses you can now connect to machines by using a hostname such as `server`, `node-0`, or `node-1`.
234+
You can use hostnames when connecting to machines from your `jumpbox` machine or any of the three machines in the Kubernetes cluster. Instead of using IP addresses, you can now connect to machines using a hostname such as `server`, `node-0`, or `node-1`.
235235

236236
Next: [Provisioning a CA and Generating TLS Certificates](lab4-certificate-authority.md)

0 commit comments

Comments
 (0)