You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/labs/kubernetes-the-hard-way/lab3-compute-resources.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,19 +13,19 @@ tags:
13
13
14
14
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.
15
15
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.
17
17
18
18
## Machine Database
19
19
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:
21
21
22
22
```text
23
23
IPV4_ADDRESS FQDN HOSTNAME POD_SUBNET
24
24
```
25
25
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.
27
27
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`.
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.
41
41
42
42
## Configuring SSH Access
43
43
44
44
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.
45
45
46
46
### Enable root SSH Access
47
47
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.
49
49
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 internetconnected 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.
51
51
52
52
Log on to each machine using SSH and your user account, then switch to the `root` user with the `su` command:
53
53
@@ -114,7 +114,7 @@ x86_64 GNU/Linux
114
114
115
115
## Hostnames
116
116
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.
118
118
119
119
To configure the hostname for each machine, run the following commands on the `jumpbox`.
120
120
@@ -145,7 +145,7 @@ node-1.kubernetes.local
145
145
146
146
## Host Lookup Table
147
147
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`.
149
149
150
150
Create a new `hosts` file and add a header to identify the machines being added:
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.
207
207
208
208
```bash
209
209
forhostin server node-0 node-1
@@ -219,7 +219,7 @@ node-1 x86_64 GNU/Linux
219
219
220
220
## Adding `/etc/hosts` Entries To The Remote Machines
221
221
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.
223
223
224
224
Copy the `hosts` file to each machine and append the contents to `/etc/hosts`:
225
225
@@ -231,6 +231,6 @@ while read IP FQDN HOST SUBNET; do
231
231
done< machines.txt
232
232
```
233
233
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`.
235
235
236
236
Next: [Provisioning a CA and Generating TLS Certificates](lab4-certificate-authority.md)
0 commit comments