Elastic Container Instance:Gunakan VNodectl untuk men-deploy VNode di kluster Kubernetes yang dikelola sendiri

Prasyarat

• Kluster Kubernetes versi 1.16 hingga 1.30 telah di-deploy.

• Jika kluster Kubernetes Anda di-deploy di pusat data, pastikan pusat data tersebut dan virtual private cloud (VPC) tempat Pod berbasis Elastic Container Instance berada saling terhubung melalui Express Connect, Smart Access Gateway (SAG), atau VPN Gateway. Untuk informasi selengkapnya, lihat topik berikut:

  • Apa itu Express Connect?

  • Apa itu SAG?

  • Apa itu VPN Gateway?

Persiapan

Sebelum men-deploy VNode di kluster Kubernetes yang dikelola sendiri, siapkan informasi parameter yang diperlukan untuk membuat VNode dan pahami izin yang dibutuhkan untuk men-deploy VNode di kluster tersebut. Tabel berikut menjelaskan parameter yang diperlukan untuk membuat VNode.

Untuk membuat VNode, Anda harus mengonfigurasi izin standar untuk node Kubernetes native dan izin tambahan untuk VNode, seperti yang ditunjukkan pada tabel berikut.

Instal VNodectl

Sebelum menggunakan VNodectl, instal CLI tersebut. Unduh paket instalasi sesuai lingkungan Anda dan instal VNodectl.

Kami menyarankan Anda menginstal VNodectl pada node master kluster Kubernetes Anda. Untuk menginstal VNodectl, lakukan langkah-langkah berikut:

1. Hubungkan ke kluster Anda.

2. Unduh paket instalasi.

   wget https://eci-docs.oss-cn-beijing.aliyuncs.com/vnode/vnodectl_0.0.5-beta_linux_amd64.tar.gz -O vnodectl.tar.gz 

3. Ekstrak paket tersebut.

   tar xvf vnodectl.tar.gz 

4. Salin vnodectl ke direktori tertentu.

   cp vnodectl /usr/local/bin/vnode

Konfigurasi kluster

VNode menggunakan file kubeconfig untuk terhubung ke kluster. Sebelum membuat VNode, buat file kubeconfig untuknya. Anda dapat membuat file kubeconfig dalam mode TLS Bootstrap atau mode ServiceAccount.

Konfigurasi file ~/.vnode/config

File ~/.vnode/config berisi konfigurasi VNode. VNodectl membaca file ini saat dijalankan. Konfigurasikan file ini sebelum membuat VNode.

1. Cetak konfigurasi yang diperlukan untuk menjalankan VNode.

   vnode config default

   Tabel berikut menjelaskan field di bawah contexts dalam konfigurasi.

   Field	Wajib	Deskripsi
   name	Ya	Nama konteks.
   vnode-name	Tidak	Nama VNode. Jangan atur field ini. Sistem akan menghasilkan nama unik secara otomatis.
   region-id	Ya	ID region tempat VNode berada. Untuk informasi cara memilih region, lihat Persiapan.
   access-key-id	Ya	Gunakan Pasangan Kunci Akses untuk menyelesaikan verifikasi identitas saat memanggil operasi API Alibaba Cloud. Pasangan Kunci Akses terdiri dari ID AccessKey dan Rahasia AccessKey. Untuk informasi selengkapnya, lihat Buat Pasangan Kunci Akses.
   access-key-secret	Ya
   vswitch-id	Ya	ID vSwitch yang terkait dengan VNode. Anda dapat menentukan beberapa vSwitch. Untuk informasi cara membuat vSwitch, lihat Persiapan.
   security-group-id	Ya	ID security group tempat VNode berada. Untuk informasi cara membuat security group, lihat Persiapan.
   resource-group-id	Tidak	Kelompok sumber daya tempat VNode berada. Kelompok sumber daya adalah mekanisme untuk mengelompokkan sumber daya dalam Akun Alibaba Cloud. Setiap akun memiliki kelompok sumber daya default. Untuk informasi selengkapnya, lihat Resource Management. Jika Anda tidak menentukan kelompok sumber daya, VNode akan bergabung ke kelompok sumber daya default.
   kubeconfig	Ya	Jalur file kubeconfig yang diperlukan untuk menghubungkan VNode ke kluster. Jalur ini dihasilkan secara otomatis setelah Anda mengonfigurasi kluster. Secara default, file kubeconfig disimpan ke ~/.vnode/deploy/kubeconfig.
   taints	Tidak	Taint yang terikat pada VNode.
   tags	Tidak	Tag yang terikat pada VNode. Tag membantu mengelola pemisahan tagihan. Setelah Anda mengikat tag kustom ke VNode, Anda dapat memfilter biaya instans yang dibebankan ke VNode dalam analisis biaya. Untuk informasi selengkapnya, lihat Lihat tagihan terpisah berdasarkan tag.
   network-type	Tidak	Jenis jaringan yang digunakan VNodectl untuk mengakses endpoint layanan kontrol ECI. Biarkan field ini kosong untuk menggunakan endpoint Internet. Jika VNodectl dijalankan di VPC, atur field ini ke vpc untuk menggunakan endpoint VPC.

2. Arahkan konfigurasi ke file ~/.vnode/config dan konfigurasikan field-field tersebut.

   vnode config default > ~/.vnode/config
   vim ~/.vnode/config

   Ubah file ~/.vnode/config sesuai kebutuhan Anda. Contoh berikut hanya menampilkan field wajib.

   kind: vnode
   contexts:
       - name: default
         region-id: cn-guangzhou
         access-key-id: <yourAccessKeyID>
         access-key-secret: <yourAccessKeySecret>
         vswitch-id: vsw-7xv2yk45qp5etidgf****
         security-group-id: sg-7xv5tcch4kjdr65t****
         kubeconfig: ~/.vnode/deploy/kubeconfig
   current-context: default

3. Verifikasi konfigurasi yang dibaca VNode saat runtime.

   vnode config

4. Alihkan konteks agar VNode memuat konfigurasi dalam konteks tersebut.

   vnode config set-context <context-name>

Buat VNode

1. Buat VNode.

   vnode create

   Catatan

   VNode dibuat menggunakan konfigurasi dalam file ~/.vnode/config. Anda dapat menambahkan parameter untuk mengonfigurasi customResources, clusterDNS, dan clusterDomain. Untuk informasi selengkapnya, lihat Kelola VNode.

   Output contoh berikut akan muncul. Nilai VirtualNodeId adalah ID VNode baru.

   {"RequestId":"AB772F9D-2FEF-5BFD-AAFB-DA3444851F29","VirtualNodeId":"vnd-7xvetkyase7gb62u****"}

2. Lihat status VNode.

   vnode list

   Output contoh berikut akan muncul. Jika STATUS adalah Ready, VNode berhasil dibuat.

   VNODE ID                    VNODE NAME                                   CREATED          STATUS    SCHEDULABLE ZONES
   vnd-7xvetkyase7gb62u****    vnode-cn-guangzhou-a-7xvetkyase7gb62u****    2 minutes ago    Ready     cn-guangzhou-a

3. Lihat informasi node.

   kubectl get node

   Output contoh berikut akan muncul. Ini menunjukkan bahwa VNode terhubung ke kluster.

   NAME                                    STATUS     ROLES                  AGE    VERSION
   cn-guangzhou.vnd-7xvetkyase7gb62u****   Ready      agent                  174m   v1.20.6
   vnode-test001                           Ready      control-plane,master   23h    v1.20.6
   vnode-test002                           Ready      <none>                 22h    v1.20.6

Cegah DaemonSet dijadwalkan ke VNode

DaemonSet tidak dapat dijalankan di VNode karena VNode bukan node nyata. Setelah membuat VNode, Anda perlu memodifikasi DaemonSet di kube-proxy dan mengonfigurasi nodeAffinity untuk mencegah DaemonSet dijadwalkan ke VNode.

1. Modifikasi konfigurasi DaemonSet.

   kubectl -n kube-system edit ds kube-proxy

2. Konfigurasi nodeAffinity.

   Tambahkan konten YAML berikut ke spec.template.spec.

   affinity:
     nodeAffinity:
       requiredDuringSchedulingIgnoredDuringExecution:
         nodeSelectorTerms:
         - matchExpressions:
           - key: type
             operator: NotIn
             values:
             - virtual-kubelet

Jadwalkan Pod ke VNode

Setelah membuat VNode, Anda dapat menggunakan salah satu metode berikut untuk menjadwalkan Pod ke VNode. Dengan demikian, Anda dapat menjalankan Pod sebagai instans container elastis di VNode.

• Penjadwalan manual

  Anda dapat mengonfigurasi parameter nodeSelector dan tolerations atau menentukan parameter nodeName untuk menjadwalkan Pod ke VNode. Untuk informasi selengkapnya, lihat Jadwalkan Pod ke VNode.

• Penjadwalan Otomatis

  Setelah men-deploy komponen eci-profile, Anda dapat menentukan parameter Selector. Dengan cara ini, sistem secara otomatis menjadwalkan Pod yang memenuhi kondisi yang ditentukan oleh Selector ke VNode. Untuk informasi selengkapnya, lihat Gunakan eci-profile untuk menjadwalkan Pod ke VNode.

Referensi

• Perintah VNodectl umum