|
| 1 | +--- |
| 2 | +title: System setup process |
| 3 | +description: A step-by-step guide to configure a production-ready Kubernetes environment on ComputeBlade. |
| 4 | +authors: brushknight |
| 5 | +# tags: [hello, docusaurus-v2] |
| 6 | +image: /img/blog/19in_blades.webp |
| 7 | +# hide_table_of_contents: false |
| 8 | +--- |
| 9 | +This guide outlines the complete process for setting up a Kubernetes system using MicroK8s, a lightweight Kubernetes distribution. The setup includes essential components like kubectl and Helm, along with necessary configurations for running containerized applications. |
| 10 | + |
| 11 | + |
| 12 | + |
| 13 | +<!-- truncate --> |
| 14 | + |
| 15 | + |
| 16 | + |
| 17 | + |
| 18 | +Follow these steps sequentially to ensure a proper setup of your Kubernetes environment. Each section provides detailed commands and explanations to help you understand what you’re implementing. |
| 19 | + |
| 20 | +## About ComputeBlade platform |
| 21 | +ComputeBlade is a rack-mountable, Power over Ethernet (PoE)-powered carrier board designed for the Raspberry Pi Compute Module 4 / Compute Module 5 (CM4 / CM5) and compatible devices. It enables the creation of high-density, low-power-consuming, plug-and-play blade servers suitable for both home and data center environments. |
| 22 | + |
| 23 | + |
| 24 | + |
| 25 | +## Step-by-step guide |
| 26 | +In the end of this instruction you’ll have set up ComputeBlade with a functioning Kubernetes environment, including: |
| 27 | +- A single-node MicroK8s Kubernetes cluster |
| 28 | +- kubectl command-line tool for cluster management |
| 29 | +- Helm package manager for Kubernetes |
| 30 | +- Basic understanding of cluster operations and management |
| 31 | +This setup will serve as a foundation for deploying and managing containerized applications on your ComputeBlade hardware. |
| 32 | + |
| 33 | +### Installing MicroK8s |
| 34 | +MicroK8s is a user-friendly Kubernetes distribution maintained by Canonical (Ubuntu). It provides a lightweight, production-ready Kubernetes that’s easy to install and manage, making it an ideal choice for both development and production environments. |
| 35 | +```bash |
| 36 | +sudo snap install microk8s --classic |
| 37 | +``` |
| 38 | +### Adding your user to the microk8s admin group |
| 39 | +MicroK8s creates a group to enable seamless usage of commands which require admin privilege. Use the following commands to join the group: |
| 40 | +```bash |
| 41 | +sudo usermod -a -G microk8s $USER |
| 42 | +sudo chown -f -R $USER ~/.kube |
| 43 | +``` |
| 44 | +You will also need to re-enter the session for the group update to take place: |
| 45 | +```bash |
| 46 | +su - $USER |
| 47 | +``` |
| 48 | +### Check the status while Kubernetes starts |
| 49 | +```bash |
| 50 | +microk8s status --wait-ready |
| 51 | +``` |
| 52 | +Give it some time to finish. |
| 53 | + |
| 54 | +### Turn on the services you want |
| 55 | +We recommend to start next services by default: |
| 56 | +```bash |
| 57 | +microk8s enable dashboard dns ingress |
| 58 | +``` |
| 59 | +Try `microk8s enable --help` for a list of available services and optional features. `microk8s disable ‹name›` turns off a service. |
| 60 | +### Start using Kubernetes |
| 61 | +```bash |
| 62 | +microk8s kubectl get all --all-namespaces |
| 63 | +``` |
| 64 | +### Access the Kubernetes dashboard (optional) |
| 65 | +```bash |
| 66 | +microk8s dashboard-proxy |
| 67 | +``` |
| 68 | + |
| 69 | +### Installing kubectl |
| 70 | +kubectl is the official command-line tool for Kubernetes that allows you to run commands against Kubernetes clusters. You can use kubectl to deploy applications, inspect and manage cluster resources, and view logs. It’s an essential tool for: |
| 71 | + |
| 72 | +- Deploying and managing applications in Kubernetes clusters |
| 73 | +- Viewing and modifying cluster state and configuration |
| 74 | +- Debugging and troubleshooting cluster issues |
| 75 | +- Accessing cluster documentation and getting help with commands |
| 76 | +- kubectl communicates with the Kubernetes API server to execute commands and manage your cluster resources. It’s a fundamental tool for any Kubernetes administrator or developer. |
| 77 | + |
| 78 | +To install it execute the following command: |
| 79 | +```bash |
| 80 | +sudo snap install kubectl --classic |
| 81 | +``` |
| 82 | +Export config for kubectl: |
| 83 | +```bash |
| 84 | +microk8s config > $HOME/.kube/config |
| 85 | +chmod -R 700 /home/ubuntu/.kube/config |
| 86 | +``` |
| 87 | +### Installing Helm |
| 88 | +Helm is a package manager for Kubernetes that simplifies the process of installing and managing applications. It serves several key purposes: |
| 89 | + |
| 90 | +- Manages complex application deployments through pre-configured “charts” — packages of Kubernetes resources |
| 91 | +- Enables version control and rollback of deployments to maintain application stability |
| 92 | +- Simplifies sharing and reuse of Kubernetes applications across different environments |
| 93 | +- Provides templating to customize application configurations without changing the original chart |
| 94 | +Think of Helm as the “apt” or “yum” of Kubernetes — it makes it much easier to install, upgrade, and manage applications in your Kubernetes cluster. |
| 95 | + |
| 96 | +You can fetch that script, and then execute it locally. It’s well documented so that you can read through it and understand what it is doing before you run it. |
| 97 | +```bash |
| 98 | +curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 |
| 99 | +chmod 700 get_helm.sh |
| 100 | +./get_helm.sh |
| 101 | +``` |
| 102 | +### Well done |
| 103 | +Congratulations! You have successfully set up a complete Kubernetes environment on your ComputeBlade. Your system now includes: |
| 104 | + |
| 105 | +- A functioning MicroK8s Kubernetes cluster |
| 106 | +- Kubectl command-line tool for cluster management |
| 107 | +- Helm package manager for deploying applications |
| 108 | +You’re now ready to start deploying and managing containerized applications on your ComputeBlade. The foundation you’ve built will allow you to explore more advanced Kubernetes features and deployments as needed. |
| 109 | + |
| 110 | +## Resources |
| 111 | +- [Installing Helm](https://helm.sh/docs/intro/install/) | HELM Project |
| 112 | +- [Install Kubernetes](https://ubuntu.com/kubernetes/install#multi-node) | Canonical Kubernetes |
| 113 | + |
| 114 | + |
| 115 | + |
0 commit comments