kubectl көмегімен кластерге қосылу

kubectl утилитасы Kubernetes кластерін пәрмен жолынан басқару бойынша барлық операциялар спектрін орындауға мүмкіндік береді. Толығырақ Kubernetes ресми құжаттамасында.

Кластерге қосылу тәсілі оның IP мекенжайына байланысты:

• Егер кластерге сыртқы IP мекенжайы тағайындалса, оған интернетке қолжетімділігі бар кез келген хосттан қосылуға болады.
• Егер кластерге тек ішкі IP мекенжайы тағайындалса, оған тек VK Cloud ішіндегі хосттан — кластермен бір ішкі желіде орналасқан виртуалды машинадан қосылуға болады.

1. Кластерге қосылу жоспарланып отырған хостта, егер kubectl утилитасы әлі орнатылмаған болса, оны орнатыңыз.

   Linux (curl)

   Linux (apt)

   Linux (yum)

   macOS (curl)

   macOS (Homebrew)

   Windows

   1. kubectl утилитасының қажетті нұсқасын жүктеп алыңыз.

      1.33.0 нұсқасындағы кластермен үйлесімді kubectl утилитасын жүктеу пәрменінің мысалы:

       
      curl -LO https://dl.k8s.io/release/v1.33.0/bin/linux/amd64/kubectl

   2. kubectl екілік файлын орындалатын етіңіз:

       
      sudo chmod +x ./kubectl

   3. Бұл файлды PATH орта айнымалысында қамтылған директорияға, мысалы, /usr/local/bin ішіне орналастырыңыз:

       
      sudo mv ./kubectl /usr/local/bin/kubectl

   4. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

   1. Kubernetes репозиторийін қосыңыз:

      1. apt пайдалану үшін қажетті бумаларды орнатыңыз:

          
         sudo apt-get updatesudo apt-get install -y apt-transport-https ca-certificates curl gnupg

      2. Репозиторий баптаулары бар файлды жасаңыз. 1.33.0 нұсқасындағы кластерлерге арналған пәрмендер мысалы:

          
         curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.33/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpgsudo chmod 644 /etc/apt/keyrings/kubernetes-apt-keyring.gpgecho 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.33/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.listsudo chmod 644 /etc/apt/sources.list.d/kubernetes.list

      3. Бумалар тізімін жаңартыңыз:

          
         sudo apt-get update

   2. kubectl орнатыңыз:

       
      sudo apt-get install -y kubectl

   3. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

   1. Kubernetes репозиторийін қосыңыз. 1.33.0 нұсқасындағы кластерлерге арналған пәрмендер мысалы:

       
      cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo[kubernetes]name=Kubernetesbaseurl=https://pkgs.k8s.io/core:/stable:/v1.33/rpm/enabled=1gpgcheck=1gpgkey=https://pkgs.k8s.io/core:/stable:/v1.33/rpm/repodata/repomd.xml.keyEOF

   2. kubectl орнатыңыз:

       
      sudo yum install -y kubectl

   3. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

   1. kubectl утилитасының қажетті нұсқасын жүктеп алыңыз.

      1.33.0 нұсқасындағы кластермен үйлесімді kubectl утилитасын жүктеу пәрмендерінің мысалдары:

      • Intel:

         
        curl -LO https://dl.k8s.io/release/v1.33.0/bin/darwin/amd64/kubectl

      • Apple Silicon:

         
        curl -LO https://dl.k8s.io/release/v1.33.0/bin/darwin/arm64/kubectl

   2. kubectl екілік файлын орындалатын етіңіз:

       
      sudo chmod +x ./kubectl

   3. Бұл файлды PATH орта айнымалысында қамтылған директорияға, мысалы, /usr/local/bin ішіне орналастырыңыз:

       
      sudo mv ./kubectl /usr/local/bin/kubectl

   4. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

   1. Орнату пәрмендерінің бірін орындаңыз:

       
      brew install kubectl

      Немесе:

       
      brew install kubernetes-cli

   2. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

   1. kubectl утилитасының қажетті нұсқасын жүктеп алыңыз.

      1.33.0 нұсқасындағы кластермен үйлесімді kubectl утилитасын жүктеу пәрменінің мысалы:

       
      curl -LO https://dl.k8s.io/release/v1.33.0/bin/windows/amd64/kubectl.exe

   2. PATH орта айнымалысында kubectl.exe файлы жүктелген директорияны көрсетіңіз:

      1. Бастау -> Бұл компьютер -> Қасиеттер -> Жүйенің қосымша параметрлері -> Орта айнымалылары -> Жүйелік айнымалылар мәзір бөліміне өтіңіз.
      2. kubectl.exe файлы бар директорияға жолды қосып, PATH айнымалысының мәнін өзгертіңіз.

   3. Пәрменді орындап, kubectl нұсқасын тексеріңіз:

       
      kubectl version

2. Single Sign-On (SSO) пайдаланып қосылу үшін қажет нәрсенің бәрін дайындаңыз.

   1. Кластерге қосылу жоспарланып отырған хостта, егер client-keystone-auth плагині әлі орнатылмаған болса, оны орнатыңыз:

      Linux (bash)

      macOS (zsh)

      Windows (PowerShell)

      1. zip және unzip пакеттері орнатылмаған болса, оларды орнатыңыз:

          
         sudo apt install zip unzip

      2. Терминалда келесі пәрменді орындаңыз:

          
         curl -sSL \  https://hub.mcs.mail.ru/repository/client-keystone-auth/latest/linux/client-install.sh \| bash

         keystone-auth утилитасын орнату басталады.

      3. Егер bash-тен өзгеше командалық қабықты пайдалансаңыз, утилитаға дейінгі жолды PATH орта айнымалысына қосыңыз.

      4. Командалық қабықты қайта іске қосыңыз немесе source пәрменін орындаңыз.

         Қажетті пәрмендер бойынша нұсқау орнату аяқталғаннан кейін көрсетіледі.

      1. Терминалда келесі пәрменді орындаңыз:

          
         curl -sSL \  https://hub.mcs.mail.ru/repository/client-keystone-auth/latest/linux/client-install.sh \| bash

         keystone-auth утилитасын орнату басталады.

      2. Егер zsh-тен өзгеше командалық қабықты пайдалансаңыз, утилитаға дейінгі жолды PATH орта айнымалысына қосыңыз.

      3. Командалық қабықты қайта іске қосыңыз немесе source пәрменін орындаңыз.

         Қажетті пәрмендер бойынша нұсқау орнату аяқталғаннан кейін көрсетіледі.

      1. PowerShell ішінде келесі пәрменді орындаңыз:

          
         iex (New-Object System.Net.WebClient).DownloadString( `'https://hub.mcs.mail.ru/repository/client-keystone-auth/latest/windows/client-install.ps1' `)

         keystone-auth утилитасын орнату басталады.

      2. Сұрауға жауап ретінде Y енгізіп, утилита директориясын PATH орта айнымалысына қосуды растаңыз:

          
         Add client-keystone-auth installation dir to your PATH? [Y/n]

   2. Сізде Kubernetes кластерлерімен жұмыс істеу үшін қажетті рөл бар екенін тексеріңіз. Егер мұндай рөл болмаса, жоба иесінен немесе суперәкімшіден оны сізге қосуды сұраңыз.

   3. API арқылы қолжетімділікті белсендіріңіз.

Кластерге қосылу жоспарланып отырған хостта мына әрекеттерді орындаңыз:

1. Кластердің конфигурация файлын жүктеп алыңыз:

   1. Кластерге қосылатын пайдаланушы аккаунтымен VK Cloud жеке кабинетіне өтіңіз.
   2. Қажетті кластер орналасқан жобаны таңдаңыз.
   3. Контейнерлер → Кластерлер Kubernetes бөліміне өтіңіз.
   4. Қажетті кластер үшін батырмасын басып, Кластерге қол жеткізу үшін Kubeconfig алу тармағын таңдаңыз.

   Конфигурация файлы әрбір жаңа кластер үшін автоматты түрде жасалады және <кластер атауы>_kubeconfig.yaml пішіміндегі атауға ие болады.

   Бұдан әрі жүктеп алынған файлдың атауы kubernetes-cluster-1234_kubeconfig.yaml және ол C:\Users\user\.kube директориясында (Windows үшін) немесе /home/user/.kube директориясында (Linux және macOS үшін) орналасқан деп есептеледі. Қажет болса, төменде келтірілген командаларды түзетіңіз.

2. Конфигурация файлында басқа пайдаланушыларға қолжетімді болмауы тиіс сезімтал ақпарат бар. Сондықтан осы файлға қол жеткізу құқықтарын шектеңіз:

   Linux (bash)/macOS (zsh)

   Windows (PowerShell)

    
   sudo chmod 0600 /home/user/.kube/kubernetes-cluster-1234_kubeconfig.yaml

    
   icacls.exe 'C:\Users\user\.kube\kubernetes-cluster-1234_kubeconfig.yaml' `  /c /t `  /Inheritance:d `  /Remove:g BUILTIN\Administrators Everyone Users `  /Grant:r ${env:UserName}:RW

3. Конфигурация файлының жолын $KUBECONFIG орта айнымалысында көрсетіңіз:

   Linux (bash)/macOS (zsh)

   Windows (PowerShell)

    
   export KUBECONFIG=/home/user/.kube/kubernetes-cluster-1234_kubeconfig.yaml

    
   $env:KUBECONFIG = 'C:\Users\user\.kube\kubernetes-cluster-1234_kubeconfig.yaml'

 
kubectl cluster-info

Егер кластер қалыпты жұмыс істеп тұрса және kubectl онымен жұмыс істеуге бапталған болса, ұқсас ақпарат шығарылады:

 
Kubernetes control plane is running at...CoreDNS is running at...To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.