Cara menggabungkan node master atau bidang kontrol ke kluster Kubernetes
Anda mungkin ingin menambahkan node master baru ke klaster Kubernetes baru atau yang sudah ada, atau mengubah peran node pekerja menjadi master, namun tidak tahu caranya. Dalam artikel ini, Anda akan mempelajari cara memiliki beberapa node bidang kontrol di klaster Kubernetes Anda untuk mencegah failover apa pun di klaster operasional Anda.
Dalam artikel ini, kita akan membahas dua skenario untuk klaster Anda. Dalam skenario pertama, Anda akan menginisialisasi klaster Anda. Dan, dalam skenario kedua, Anda sudah memiliki klaster dan ingin menambahkan 2 atau lebih node master.
Skenario 1 — Inisialisasi klaster:
Kami berasumsi Anda menginstal kluster kubeadm untuk pertama kalinya dan akan menjalankan perintah kubeadm init, tetapi jika Anda sudah memiliki kluster, Anda juga dapat menggunakan kubeadm reset dan menginisialisasi ulang kluster Anda untuk menggunakan pendekatan ini, tetapi Anda harus tahu bahwa hal itu memiliki konsekuensi. Pertama-tama, kami menjalankan perintah di bawah ini pada node target Anda sebagai master atau control plane:
kubeadm init --control-plane-endpoint <ip-simpul-master> \
--pod-network-cidr 11.0.0.0/16 \
--apiserver-advertise-address=<ip-simpul-master> \
--service-cidr 10.0.0.1/16 \
--upload-certs- - -upload certs: Seperti yang Anda ketahui, koneksi antara node master adalah mTLS, jadi kedua node harus diotorisasi dalam protokol ini. Tanda ini membantu Anda mengambil modul sertifikat Kubernetes pada node master Anda sehingga menjalankannya adalah suatu keharusan.
- - -control-plan-endpoint : Bendera berguna lainnya yang berguna saat Anda menambahkan master baru ke kluster yang sudah ada sehingga node master baru akan mengenali node master pertama dan utama.
- - -service-cidr : Anda akan mengalokasikan rentang IP layanan Kubernetes yang Anda inginkan di sini. cobalah untuk menghindari penggunaan rentang IP yang sama dengan jaringan pod.
- - -pod-network-cidr : Seperti disebutkan sebelumnya, IP pod dialokasikan dari rentang yang Anda tentukan di sini.
- - -apiserver-advertise-address = Alamat IP yang akan diiklankan oleh Server API untuk mendengarkannya. Jika tidak ditetapkan, antarmuka jaringan default akan digunakan.
Ini adalah hasil yang akan Anda lihat di terminal setelah menginisialisasi klaster Anda. Seperti yang Anda lihat, perintah pertama adalah untuk menggabungkan rencana kontrol tambahan dan perintah kedua adalah untuk menggabungkan simpul pekerja.
Bergabunglah dengan node master:
Untuk bergabung dengan node master baru di kluster yang sudah ada, cukup salin dan tempel perintah pertama yang Anda lihat di terminal:
kubeadm join <ip-anda>:6443 --token <token-anda> \
--discovery-token-ca-cert-hash <hash-sertifikat-anda> \
--control-plane \
--certificate-key <kunci-sertifikat>- - -certificate-key : Kunci yang digunakan untuk mengenkripsi sertifikat bidang kontrol dalam Rahasia kubeadm-certs. Kunci sertifikat adalah string berkode heksadesimal yang merupakan kunci AES berukuran 32 byte.
- - -discovery-token-ca-cert-hash: digunakan untuk memverifikasi keaslian cluster yang Anda ikuti
Saat Anda melihat halaman ini, master baru telah bergabung. Anda mungkin menghadapi kesalahan etcd tetapi Anda dapat mengabaikannya dan membuat file .kube di direktori home Anda dengan petunjuk yang ditampilkan.
Bergabunglah dengan simpul pekerja:
kubeadm join <master-ip>:6443 \
--token <token-anda> \
--discovery-token-ca-cert-hash <hash-sertifikat-anda>Bergabung dengan node pekerja mudah, cukup salin dan tempel perintah di atas yang Anda lihat di terminal.
Setelah menggabungkan kedua node dan memasang plugin jaringan kubernetes, klaster Anda dengan 2 node utama dan 1 node pekerja sudah siap.
Skenario 2 — Klaster yang ada:
Jika Anda tidak bermaksud menginisialisasi ulang klaster yang sudah ada dan beroperasi, kami punya solusi lain untuk Anda.
- Pastikan Anda telah menginstal openssl dan menjalankan perintah di bawah ini pada node master Anda:
openssl x509 -pubkey - dalam /etc/kubernetes/pki/ca.crt | openssl rsa -pubin -outform der 2>/dev/null | openssl dgst -sha256 -hex | sed 's/^.* //'Perintah ini mengekstrak kunci publik dari sertifikat CA, mengonversinya ke format DER, lalu menghitung hash SHA-256 dari kunci publik. Hash yang dihasilkan adalah yang Anda perlukan untuk bendera --discovery-token-ca-cert-hash. Anda juga harus menambahkan “sha256:” sebelum string yang Anda ambil pada perintah Anda.
2. Jika Anda belum menjalankan perintah kubeadm init dengan flag - -upload-certs, Anda harus menyalin sertifikat klaster secara manual ke node master tambahan. Salin sertifikat dari direktori /etc/Kubernetes/pki.
Berikut ini adalah sertifikat yang Anda perlukan:
·ca.crt
· ca.kunci
· kunci sa
· sa.pub
· proxy-depan-ca.crt
· proxy-depan-ca.key
Ini adalah instruksi yang harus Anda ikuti:
buat direktori yang diperlukan dan salin ke tujuan:
Bahasa Indonesia: sudo mkdir -p /etc/kubernetes/pki
sudo chown -R root:root /etc/kubernetes/pki
sudo chmod -R 700 /etc/kubernetes/pkiscp /etc/kubernetes/admin.conf <pengguna>@<ip-node-master-baru> :/etc/kubernetes/scp /etc/kubernetes/pki/ca.crt /etc/kubernetes/pki/ca.key /etc/kubernetes/pki/sa.key /etc/kubernetes/pki/sa.pub /etc/kubernetes/pki/front-proxy-ca.crt /etc/kubernetes/pki/front-proxy-ca.key <pengguna>@<ip-simpul-master-baru>:/etc/kubernetes/pki/jika Anda sudah menjalankan flag --upload-certs pada kubeadm init sebelumnya, Anda tidak perlu menyalin sertifikat secara manual tetapi Anda harus menggunakan --certificate-key pada perintah join dan mengetahui nilainya dari inisialisasi pertama.
Hasilkan token gabung baru:
pembuatan token kubeadmSekarang semuanya siap untuk menggabungkan bidang kontrol baru Anda ke kluster kubeadm dengan perintah di bawah ini, salin token dan sertifikat hash di sini:
kubeadm join <master-ip>:6443 \
--token <token-anda> \
--discovery-token-ca-cert-hash sha256:<hash-sertifikat-anda> \
--bidang-kendali \Dengan sertifikat yang disalin secara manual, kita tidak perlu menyetel tanda --certificate-key.
Jika Anda menjalankan “kubectl get nodes”, Anda akan melihat master node yang baru saja Anda tambahkan.
How to join master node or control plane to Kubernetes cluster
You might want to add a new master node to your new or existing Kubernetes cluster or change a worker node role to master but do not know how it is done, in this article, you will learn how to have multiple control plane nodes on your Kubernetes cluster to prevent any failover on your operational cluster.
In this article, we are going to talk about two scenarios for your cluster, in the first scenario you are about to initialize your cluster, and in the second scenario you already have a cluster and want to add 2 or additional master nodes.
Scenario 1 — Initialize cluster:
We assume you are installing kubeadm cluster for the first time and about to run kubeadm init command but if you have already an existing cluster you can also use kubeadm reset and reinitialize your cluster to use this approach but you should know it does have consequences. First of all, we run the below command on your target node as master or control plane:
kubeadm init --control-plane-endpoint <master-node-ip> \
--pod-network-cidr 11.0.0.0/16 \
--apiserver-advertise-address=<master-node-ip> \
--service-cidr 10.0.0.1/16 \
--upload-certs- - -upload certs: As you might know, the connection between master nodes is mTLS, so both nodes must be authorized in this protocol. This flag helps you to retrieve Kubernetes certificate modules on your master nodes so executing it is necessary.
- - -control-plan-endpoint: Another useful flag that comes in handy when you add a new master to an existing cluster so the new master nodes would recognize the first and primary master node.
- - -service-cidr: You will allocate your desired Kubernetes service IP rang here. try to avoid using the same IP rang pod network.
- - -pod-network-cidr: As it mentioned before, pods IPs get allocated from the range you define here.
- - -apiserver-advertise-address= The IP address the API Server will advertise it’s listening on. If not set the default network interface will be used.
This is the result you are going to see on your terminal after initializing your cluster. As you see the the first command is for joining the additional control plan and the second one is for joining worker node.
Join master node:
To join a new master node on your existing cluster just copy and paste the first command you see on the terminal:
kubeadm join <your-ip>:6443 --token <your-token> \
--discovery-token-ca-cert-hash <your-cert-hash> \
--control-plane \
--certificate-key <certificate-key>- - -certificate-key: Key used to encrypt the control-plane certificates in the kubeadm-certs Secret. The certificate key is a hex encoded string that is an AES key of size 32 bytes.
- - -discovery-token-ca-cert-hash: is used to verify the authenticity of the cluster you are joining
When you see this page, the new master is joined. You might face the etcd error but you can ignore it anyway and make your .kube file on your home directory by the instruction that is shown.
Join worker node:
kubeadm join <master-ip>:6443 \
--token <your-token> \
--discovery-token-ca-cert-hash <your-cert-hash>Joining worker node is easy, just copy and paste the above command which you saw on the terminal.
After joining both nodes and installing your kubernetes network plugin, your cluster with 2 master nodes and 1 worker node is ready.
Scenario 2 — Existing cluster:
If you do not intend to reinitialize your existing and operational cluster, we have another solution for you.
- Make sure to have openssl installed and run the below command on your master node:
openssl x509 -pubkey -in /etc/kubernetes/pki/ca.crt | openssl rsa -pubin -outform der 2>/dev/null | openssl dgst -sha256 -hex | sed 's/^.* //'This command extracts the public key from the CA certificate, converts it to DER format, and then calculates the SHA-256 hash of the public key. The resulting hash is what you need for the --discovery-token-ca-cert-hash flag. You should also add “sha256:” before the string you retrieved on your command.
2. If you have not run your kubeadm init command with - -upload-certs flag, you should copy your cluster certificates manually to your additional master node. Copy certificates from /etc/Kubernetes/pki directory.
These are the certificates you will need:
·ca.crt
· ca.key
· sa.key
· sa.pub
· front-proxy-ca.crt
· front-proxy-ca.key
This is the instruction you have to follow:
make necessary directories and copy to the destination:
sudo mkdir -p /etc/kubernetes/pki
sudo chown -R root:root /etc/kubernetes/pki
sudo chmod -R 700 /etc/kubernetes/pkiscp /etc/kubernetes/admin.conf <user>@<new-master-node-ip>:/etc/kubernetes/scp /etc/kubernetes/pki/ca.crt /etc/kubernetes/pki/ca.key /etc/kubernetes/pki/sa.key /etc/kubernetes/pki/sa.pub /etc/kubernetes/pki/front-proxy-ca.crt /etc/kubernetes/pki/front-proxy-ca.key <user>@<new-master-node-ip>:/etc/kubernetes/pki/if you already have run --upload-certs flag on kubeadm init before, you do not need to copy certs manually but you have to use --certificate-key on your join command and know the value from first initialization.
Generate new join token:
kubeadm token generateNow everything is ready to join your new control plane to kubeadm cluster with below command, copy token and hash cert here:
kubeadm join <master-ip>:6443 \
--token <your-token> \
--discovery-token-ca-cert-hash sha256:<your-cert-hash> \
--control-plane \With certificates copied manually, we do not need to set --certificate-key flag.
if you run “kubectl get nodes”you must see you your newly added master node.
Tidak ada komentar:
Posting Komentar