lollipopcloud/advanced/k3s.md

k3s

For those looking to deploy k3s (http://k3s.io/) the below notes should help get it setup and quickly deployed.

Inspiration / Further Reading

• https://github.com/kubernetes/dashboard
• https://kubernetes.io/docs/concepts/
• https://kubernetes.io/docs/tasks/
• https://kubernetes.io/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume/
• https://helm.sh/docs/using_helm/#quickstart
• https://helm.sh/docs/using_helm/#installing-helm
• https://github.com/helm/chartmuseum
• https://github.com/helm/monocular
• https://github.com/jessestuart/tiller-multiarch
• https://github.com/kubeapps/kubeapps
• https://github.com/kubeapps/kubeapps/issues/929
• [https://github.com/kubeapps/kubeapps/blob/master/Makefile]
• https://github.com/chartmuseum/ui
• https://github.com/helm/chartmuseum
• https://github.com/rancher/k3s/issues/81

Quick Deployment

Armbian Install / Setup

1. Install Armbian
2. Login and run through first login steps
3. apt update && apt install htop nload iotop vim nano tmux && apt upgrade
4. systemctl reboot

Run tmux as root

Prep

cat > admin-user.yaml <<EOF
apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin-user
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-user
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: admin-user
  namespace: kube-system
EOF

Session 1

1. curl -sfL https://get.k3s.io | sh -
2. journalctl -fu k3s

Session 2

1. k3s kubectl get node -- This should eventually give output
2. kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v1.10.0/src/deploy/recommended/kubernetes-dashboard-arm.yaml
3. kubectl apply -f admin-user.yaml
4. kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep admin-user | awk '{print $1}')

Session 3

1. cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
2. curl https://raw.githubusercontent.com/helm/helm/master/scripts/get | bash
3. helm init --tiller-image=jessestuart/tiller
4. helm repo add bitnami https://charts.bitnami.com/bitnami
5. helm install --name kubeapps --namespace kubeapps bitnami/kubeapps

Local Machine

1. Setup proxy per the "Accessing cluster from outside section" section at https://github.com/rancher/k3s/blob/master/README.md
2. Access dashboard at http://localhost:8001/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy/