From d849eced79be4214aef59700d11c80990f9c2c53 Mon Sep 17 00:00:00 2001 From: Kelsey Hightower Date: Thu, 7 Jul 2016 08:06:53 -0700 Subject: [PATCH] update docs --- docs/etcd.md | 49 +++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 43 insertions(+), 6 deletions(-) diff --git a/docs/etcd.md b/docs/etcd.md index a96b771..27c7c0c 100644 --- a/docs/etcd.md +++ b/docs/etcd.md @@ -1,8 +1,15 @@ -# etcd +# Bootstrapping a H/A etcd cluster -Setup a 3 node etcd cluster. +In this lab you will bootstrap a 3 node etcd cluster. The following virtual machines will be used: -### Copy TLS Certs +```` +NAME ZONE MACHINE_TYPE INTERNAL_IP STATUS +etcd0 us-central1-f n1-standard-1 10.240.0.10 RUNNING +etcd1 us-central1-f n1-standard-1 10.240.0.11 RUNNING +etcd2 us-central1-f n1-standard-1 10.240.0.12 RUNNING +```` + +## Copy TLS Certs ``` gcloud compute copy-files ca.pem kubernetes-key.pem kubernetes.pem etcd0:~/ @@ -16,14 +23,16 @@ gcloud compute copy-files ca.pem kubernetes-key.pem kubernetes.pem etcd1:~/ gcloud compute copy-files ca.pem kubernetes-key.pem kubernetes.pem etcd2:~/ ``` +## Provision the etcd Cluster -## etcd0 +### etcd0 ``` gcloud compute ssh etcd0 ``` +Move the TLS certificates in place: ``` sudo mkdir -p /etc/etcd/ @@ -33,6 +42,8 @@ sudo mkdir -p /etc/etcd/ sudo mv ca.pem kubernetes-key.pem kubernetes.pem /etc/etcd/ ``` +Download and install the etcd binaries: + ``` wget https://github.com/coreos/etcd/releases/download/v3.0.1/etcd-v3.0.1-linux-amd64.tar.gz ``` @@ -53,6 +64,8 @@ sudo cp etcd-v3.0.1-linux-amd64/etcd /usr/bin/ sudo mkdir -p /var/lib/etcd ``` +Create the etcd systemd unit file: + ``` sudo sh -c 'echo "[Unit] Description=etcd @@ -81,12 +94,16 @@ RestartSec=5 WantedBy=multi-user.target" > /etc/systemd/system/etcd.service' ``` +Start etcd: + ``` sudo systemctl daemon-reload sudo systemctl enable etcd sudo systemctl start etcd ``` +### Verification + ``` sudo systemctl status etcd ``` @@ -102,12 +119,14 @@ error #0: client: endpoint http://127.0.0.1:2379 exceeded header timeout error #1: dial tcp 127.0.0.1:4001: getsockopt: connection refused ``` -## etcd1 +### etcd1 ``` gcloud compute ssh etcd1 ``` +Move the TLS certificates in place: + ``` sudo mkdir -p /etc/etcd/ ``` @@ -116,6 +135,8 @@ sudo mkdir -p /etc/etcd/ sudo mv ca.pem kubernetes-key.pem kubernetes.pem /etc/etcd/ ``` +Download and install the etcd binaries: + ``` wget https://github.com/coreos/etcd/releases/download/v3.0.1/etcd-v3.0.1-linux-amd64.tar.gz ``` @@ -136,6 +157,8 @@ sudo cp etcd-v3.0.1-linux-amd64/etcd /usr/bin/ sudo mkdir /var/lib/etcd ``` +Create the etcd systemd unit file: + ``` sudo sh -c 'echo "[Unit] Description=etcd @@ -164,12 +187,16 @@ RestartSec=5 WantedBy=multi-user.target" > /etc/systemd/system/etcd.service' ``` +Start etcd: + ``` sudo systemctl daemon-reload sudo systemctl enable etcd sudo systemctl start etcd ``` +#### Verification + ``` sudo systemctl status etcd ``` @@ -185,12 +212,14 @@ member ffed16798470cab5 is healthy: got healthy result from https://10.240.0.11: cluster is healthy ``` -## etcd2 +### etcd2 ``` gcloud compute ssh etcd2 ``` +Move the TLS certificates in place: + ``` sudo mkdir -p /etc/etcd/ ``` @@ -199,6 +228,8 @@ sudo mkdir -p /etc/etcd/ sudo mv ca.pem kubernetes-key.pem kubernetes.pem /etc/etcd/ ``` +Download and install the etcd binaries: + ``` wget https://github.com/coreos/etcd/releases/download/v3.0.1/etcd-v3.0.1-linux-amd64.tar.gz ``` @@ -219,6 +250,8 @@ sudo cp etcd-v3.0.1-linux-amd64/etcd /usr/bin/ sudo mkdir /var/lib/etcd ``` +Create the etcd systemd unit file: + ``` sudo sh -c 'echo "[Unit] Description=etcd @@ -247,12 +280,16 @@ RestartSec=5 WantedBy=multi-user.target" > /etc/systemd/system/etcd.service' ``` +Start etcd: + ``` sudo systemctl daemon-reload sudo systemctl enable etcd sudo systemctl start etcd ``` +#### Verification + ``` sudo systemctl status etcd ```