forked from rook/rook
Travis Nielsen
a251959061
The docs were in need of some restructuring wrt prerequisites. They were mingled with general k8s and Ceph requirements. For clarity, we need to separate the ceph prereqs from general k8s requirements. There is now only a single prereqs page. All other topics should be found under other sections, such as specific to Ceph. Having subtopics under the general prereqs caused users to frequently not even notice the main prereqs topic. Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
---
|
|
title: Tectonic Configuration
|
|
weight: 11800
|
|
indent: true
|
|
---
|
|
|
|
# Tectonic Configuration
|
|
|
|
Here is a running guide on how to implement Rook on Tectonic. A complete guide on how to install Tectonic is out of the scope of the Rook project. More info can be found on the [Tectonic website](https://coreos.com/tectonic/docs/latest/)
|
|
|
|
## Prerequisites
|
|
|
|
* An installed tectonic-installer. These steps are described on [the Tectonic website](https://coreos.com/tectonic/docs/latest/install/bare-metal/#4-tectonic-installer)
|
|
* A running matchbox node which will do the provisioning (Matchbox is only required if you are running Tectonic on Bare metal)
|
|
* You can run through all steps of the GUI installer, but in the last step, choose `Boot manually`. This way we can make the necessary changes first.
|
|
|
|
## Edit the kubelet.service file
|
|
We need to make a few adaptions to the Kubelet systemd service file generated by the Tectonic-installer.
|
|
|
|
First change to the directory in which you untarred the tectonic installer and find your newly generated cluster configuration files.
|
|
|
|
```console
|
|
cd ~/tectonic/tectonic-installer/LINUX-OR-DARWIN/clusters
|
|
```
|
|
|
|
|
|
Open the file `modules/ignition/resources/services/kubelet.service` in your favorite editor and after the last line containing `ExecStartPre=...`, paste the following extra lines:
|
|
|
|
```console
|
|
ExecStartPre=/bin/mkdir -p /var/lib/kubelet/volumeplugins
|
|
ExecStartPre=/bin/mkdir -p /var/lib/rook
|
|
```
|
|
|
|
And after the `ExecStart=/usr/lib/coreos/kubelet-wrapper \` line, insert the following flag for the kubelet-wrapper to point to a path reachable outside of the Kubelet rkt container:
|
|
|
|
```console
|
|
--volume-plugin-dir=/var/lib/kubelet/volumeplugins \
|
|
```
|
|
|
|
Save and close the file.
|
|
|
|
### Boot your Tectonic cluster
|
|
|
|
All the preparations are ready for Tectonic to boot now. We will use `terraform` to start the cluster.
|
|
Visit the official [Tectonic manual boot](https://coreos.com/tectonic/docs/latest/install/aws/manual-boot.html#deploy-the-cluster) page for the commands to use.
|
|
|
|
**Remark:** The Tectonic installer contains the correct terraform binary out of the box. This terraform binary can be found in following directory `~/tectonic/tectonic-installer/linux`.
|
|
|
|
## Start Rook
|
|
|
|
After the Tectonic Installer ran and the Kubernetes cluster is started and ready, you can follow the [Rook installation guide](ceph-quickstart.md).
|
|
If you want to specify which disks Rook uses, follow the instructions in [creating Rook clusters](ceph-cluster-crd.md)
|