Memperpanjang sertifikat cluster yang telah habis masa berlakunya secara manual

Dokumen ini menjelaskan cara memperpanjang sertifikat yang habis masa berlakunya secara manual untuk GKE Anda di Bare Metal. Sertifikat Transport Layer Security (TLS) digunakan oleh komponen bidang kontrol GKE di Bare Metal. Saat masa berlaku sertifikat ini berakhir, kemampuan Anda untuk mengelola workload dan siklus proses cluster akan diblokir hingga sertifikat dapat diperpanjang. Untuk mengetahui informasi selengkapnya tentang dampak sertifikat yang habis masa berlakunya, lihat Masa berlaku sertifikat.

Secara default, sertifikat TLS memiliki masa berlaku 1 tahun. GKE on Bare Metal memperbarui sertifikat ini secara otomatis selama upgrade cluster dan saat Anda Merotasikan otoritas sertifikat. Sebaiknya upgrade cluster Anda secara rutin untuk menjaganya tetap aman, didukung, dan untuk mencegah masa berlaku sertifikat TLS berakhir.

Error yang disebabkan oleh masa berlaku sertifikat habis

Jika masa berlaku sertifikat TLS pada cluster Anda berakhir, pengontrol inti tidak dapat membuat koneksi TLS dengan server Kubernetes API. Kurangnya konektivitas ini menyebabkan error berikut:

  • Unable to connect to the server: x509: Unable to connect to the server

    Saat Anda menggunakan kubectl untuk mendapatkan node cluster, responsnya akan menyertakan error yang merujuk pada akhir masa berlaku sertifikat:

    kubectl get nodes --kubeconfig KUBECONFIG_PATH
    

    Ganti KUBECONFIG_PATH dengan jalur ke file kubeconfig untuk cluster Anda.

    Jika masa berlaku sertifikat telah berakhir, responsnya akan seperti berikut:

    Unable to connect to the server: x509: certificate has expired or is not yet valid
    
  • could not connect: x509 atau rejected connection

    Sertifikat yang habis masa berlakunya akan memblokir akses ke cluster etcd karena peer tidak dapat berkomunikasi satu sama lain. Log etcd dapat berisi entri error seperti ini:

    W | rafthttp: health check for peer 6221a1d241bb2d0a could not connect: x509: certificate
    has expired or is not yet valid
    I | embed: rejected connection from "10.200.0.4:46108" (error "remote error: tls: bad
    certificate", ServerName "")
    

Periksa waktu habis masa berlaku sertifikat

Bagian ini berisi petunjuk untuk memeriksa waktu habis masa berlaku sertifikat yang digunakan oleh cluster Anda. Lakukan langkah-langkah berikut pada setiap node bidang kontrol.

Untuk memeriksa waktu habis masa berlaku sertifikat:

  1. Login ke salah satu mesin node bidang kontrol dan jalankan perintah berikut:

    sudo kubeadm certs check-expiration
    

    Output perintah mencantumkan sertifikat yang dibuat oleh kubeadm untuk komponen bidang kontrol dan masa berlakunya:

    CERTIFICATE                EXPIRES                  RESIDUAL TIME   CERTIFICATE AUTHORITY   EXTERNALLY MANAGED
    admin.conf                 Nov 28, 2021 19:09 UTC   53m                                     no
    apiserver                  Nov 28, 2021 19:09 UTC   53m             ca                      no
    apiserver-etcd-client      Nov 28, 2021 19:09 UTC   53m             etcd-ca                 no
    apiserver-kubelet-client   Nov 28, 2021 19:09 UTC   53m             ca                      no
    controller-manager.conf    Nov 28, 2021 19:09 UTC   53m                                     no
    etcd-healthcheck-client    Nov 28, 2021 19:09 UTC   53m             etcd-ca                 no
    etcd-peer                  Nov 28, 2021 19:09 UTC   53m             etcd-ca                 no
    etcd-server                Nov 28, 2021 19:09 UTC   53m             etcd-ca                 no
    front-proxy-client         Nov 28, 2021 19:09 UTC   53m             front-proxy-ca          no
    scheduler.conf             Nov 28, 2021 19:09 UTC   53m                                     no
    
    CERTIFICATE AUTHORITY   EXPIRES                  RESIDUAL TIME   EXTERNALLY MANAGED
    ca                      Nov 26, 2031 18:06 UTC   9y              no
    etcd-ca                 Nov 26, 2031 18:06 UTC   9y              no
    front-proxy-ca          Nov 26, 2031 18:06 UTC   9y              no
    
  2. Jalankan perintah berikut untuk memeriksa waktu habis masa berlaku untuk sertifikat kubelet:

    sudo openssl x509 -in /var/lib/kubelet/pki/kubelet-client-current.pem -text | grep Validity -A2
    sudo openssl x509 -in /var/lib/kubelet/pki/kubelet-server-current.pem -text | grep Validity -A2
    

    Respons untuk setiap perintah akan terlihat seperti output berikut:

    Validity
        Not Before: Sep 17 22:27:53 2021 GMT
        Not After : Sep 17 22:33:16 2022 GMT
    

    Jika semua node bidang kontrol telah di-bootstrap secara bersamaan, waktu habis masa berlaku sertifikat akan berada dalam hitungan menit satu sama lain. Hubungan pengaturan waktu ini berlaku di semua node bidang kontrol. Anda dapat memverifikasi waktu habis masa berlaku dengan menjalankan perintah sebelumnya pada setiap node bidang kontrol.

  3. Jalankan perintah berikut di workstation admin untuk memeriksa waktu habis masa berlaku sertifikat klien dalam file kubeconfig cluster:

    grep 'client-certificate-data' KUBECONFIG_PATH | \
        awk '{print $2}' | base64 -d | openssl x509 -text | grep Validity -A2
    

    Responsnya akan terlihat seperti contoh output ini:

    Validity
        Not Before: Sep 17 22:27:53 2021 GMT
        Not After : Sep 17 22:33:16 2022 GMT
    
  4. Jalankan perintah berikut guna mencari masa berlaku sertifikat untuk cluster kubeconfig di cluster admin:

    kubectl get secret/CLUSTER_NAME-kubeconfig -n CLUSTER_NAMESPACE -o --kubeconfig=ADMIN_KUBECONFIG jsonpath='{.data.value}' | base64 --decode | grep client-certificate-data | awk '{print $2}' | base64 -d | openssl x509 -text | grep Validity -A2
    
    Validity
        Not Before: Sep 17 22:27:53 2021 GMT
        Not After : Sep 17 22:33:16 2022 GMT
    

    Sertifikat kubeconfig di cluster admin dan sertifikat dalam file kubeconfig di workstation admin adalah sama. Oleh karena itu, output untuk perintah ini dan perintah dari langkah sebelumnya harus cocok.

Perpanjang sertifikat secara manual

Untuk memperpanjang sertifikat TLS secara manual untuk cluster, gunakan petunjuk di bagian berikut.

Memperpanjang sertifikat untuk setiap node bidang kontrol

Lakukan langkah-langkah berikut pada setiap node bidang kontrol cluster yang terpengaruh:

  1. Cadangkan folder /etc/kubernetes.

  2. Jalankan perintah kubeadm berikut untuk memperpanjang semua sertifikat:

    Perintah ini memperpanjang sertifikat menggunakan Certificate Authority (CA) yang ada di perangkat.

    sudo kubeadm certs renew all
    

    Output perintahnya mirip dengan contoh berikut:

    certificate embedded in the kubeconfig file for the admin to use and for kubeadm itself renewed
    certificate for serving the Kubernetes API renewed
    certificate the apiserver uses to access etcd renewed
    certificate for the API server to connect to kubelet renewed
    certificate embedded in the kubeconfig file for the controller manager to use renewed
    certificate for liveness probes to healthcheck etcd renewed
    certificate for etcd nodes to communicate with each other renewed
    certificate for serving etcd renewed
    certificate for the front proxy client renewed
    certificate embedded in the kubeconfig file for the scheduler manager to use renewed
    
  3. Pastikan bahwa sertifikat memiliki waktu habis masa berlaku yang baru dengan menjalankan perintah berikut:

    sudo kubeadm certs check-expiration
    
  4. Mulai ulang container dengan perintah berikut:

    Tidak semua komponen bidang kontrol mendukung pemuatan ulang sertifikat dinamis, sehingga langkah ini akan memulai ulang penampung berikut: kube-apiserver, kube-scheduler, kube-controller-manager, dan etcd untuk mengambil sertifikat yang diperpanjang.

    Ulangi langkah-langkah berikut untuk masing-masing dari keempat penampung:

    1. Temukan ID penampung untuk setiap penampung:

      sudo crictl ps | grep CONTAINER_NAME
      

      Ganti CONTAINER_NAME dengan nama penampung berikut: kube-apiserver, kube-scheduler, kube-controller-manager, atau etcd (bukan etcd-defrag).

      Responsnya mirip dengan output berikut:

      c331ade490cb6       28df10594cd92      26 hours ago       Running          kube-apiserver ...
      

      ID penampung adalah nilai di kolom pertama.

    2. Hentikan setiap container:

      sudo crictl stop CONTAINER_ID
      

      Ganti CONTAINER_ID dengan ID penampung dari langkah sebelumnya.

      Saat container yang dihentikan keluar, kubelet akan membuat container baru sebagai penggantinya dan menghapus container yang telah dihentikan. Jika Anda mengalami error, seperti context deadline exceeded (kode error DeadlineExceeded), jalankan kembali perintah tersebut.

Memverifikasi bahwa konektivitas telah dipulihkan

Pada tahap ini, sertifikat kubeadm harus diperbarui di semua node bidang kontrol. Jika Anda memperpanjang sertifikat yang habis masa berlakunya, lakukan langkah berikut.

  • Untuk memverifikasi koneksi dengan server Kubernetes API, jalankan perintah kubectl berikut pada node bidang kontrol mana pun:

    kubectl get nodes --kubeconfig=/etc/kubernetes/admin.conf
    

Respons akan menampilkan daftar node untuk cluster. Jika sertifikat Anda diperpanjang dengan benar, tidak ada error TLS atau sertifikat yang ditampilkan.

Mengganti file kubeconfig cluster

Untuk mengganti file kubeconfig bagi cluster Anda dengan file yang memiliki sertifikat yang diperpanjang, gunakan langkah-langkah berikut:

  1. Untuk membuat file kubeconfig baru, jalankan perintah kubectl berikut di workstation admin:

    kubectl --kubeconfig="ADMIN_KUBECONFIG" get secret/CLUSTER_NAME-kubeconfig  \
        -n "CLUSTER_NAMESPACE"  -o jsonpath='{.data.value}'  | base64 --decode > new_kubeconfig.conf
    

    Ganti kode berikut:

    • ADMIN_KUBECONFIG: jalur ke file kubeconfig cluster admin.

    • CLUSTER_NAME: nama cluster yang sertifikatnya akan diperpanjang.

    • CLUSTER_NAMESPACE: namespace cluster yang sertifikatnya Anda perpanjang.

    File new_kubeconfig.conf berisi data sertifikat yang diperbarui.

  2. Pastikan kubeconfig yang baru berfungsi dengan menjalankan perintah kubectl apa pun menggunakan kredensial baru:

    kubectl get nodes --kubeconfig new_kubeconfig.conf
    
  3. Ganti konten file kubeconfig lama yang disimpan di direktori cluster pada workstation admin dengan konten file kubeconfig baru new-kubeconfig.conf.

    Secara default, jalur ke file konfigurasi cluster adalah bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig.

Verifikasi sertifikat kubelet dan mulai ulang etcd-defrag

Untuk menyelesaikan proses perpanjangan sertifikat cluster secara manual, lakukan langkah-langkah berikut untuk setiap node bidang kontrol:

  1. Login ke node bidang kontrol dan verifikasi klien kubelet serta layani masa berlaku sertifikat dengan menjalankan perintah berikut:

    Sertifikat Kubelet diputar secara otomatis selama bidang kontrol dapat dijangkau. Periode untuk perpanjangan otomatis sertifikat kubelet lebih singkat daripada periode habis masa berlaku sertifikat komponen bidang kontrol. Oleh karena itu, kemungkinan sertifikat kubelet telah diperpanjang sebelum

    sudo openssl x509 -in /var/lib/kubelet/pki/kubelet-client-current.pem -text | grep Validity -A2
    sudo openssl x509 -in /var/lib/kubelet/pki/kubelet-server-current.pem -text | grep Validity -A2
    

    Output dari salah satu perintah terlihat seperti contoh berikut:

    Validity
        Not Before: Nov 28 18:04:57 2022 GMT
        Not After : Nov 28 19:04:57 2023 GMT
    
  2. Gunakan perintah berikut untuk memulai ulang container etcd-defrag:

    Penampung etcd-defrag menggunakan sertifikat klien apiserver-etcd untuk berkomunikasi dengan etcd dan harus dimulai ulang untuk mengambil sertifikat yang diperbarui.

    kubectl rollout restart daemonset etcd-defrag -n kube-system --kubeconfig KUBECONFIG_PATH
    

Anda telah menyelesaikan langkah manual untuk memperpanjang sertifikat cluster. Pastikan semua pod berjalan dengan baik dan tidak ada error TLS yang dilaporkan untuk penampung bidang kontrol.