Создание файла конфигурации

Статические файлы конфигурации позволяют получить доступ к кластеру Kubernetes без использования CLI, например из систем непрерывной интеграции.

Также с помощью статического файла конфигурации можно настроить доступ к нескольким кластерам Kubernetes. Между описанными в конфигурациях кластерами Kubernetes можно быстро переключаться с помощью команды kubectl config use-context. Подробнее о настройке доступа к нескольким кластерам Kubernetes читайте в документации Kubernetes.

Чтобы создать файл конфигурации:

• Подготовьте сертификат кластера Kubernetes.
• Создайте объект ServiceAccount.
• Подготовьте токен объекта ServiceAccount.
• Создайте и заполните файл конфигурации.
• Проверьте результат.

Для выполнения bash-команд вам понадобится парсер JSON-файлов — jq.

Получите уникальный идентификатор кластера Kubernetes

Для обращения к кластеру Kubernetes используйте его уникальный идентификатор. Запишите его в переменную для использования в других командах.

1. Узнайте уникальный идентификатор кластера Kubernetes:

   Консоль управления

   CLI

   1. Перейдите на страницу каталога и выберите Managed Service for Kubernetes.
   2. Нажмите на имя нужного кластера Kubernetes.

   В блоке Общая информация отобразится уникальный идентификатор кластера Kubernetes.

   $ yc managed-kubernetes cluster list
   +----------------------+----------+---------------------+---------+---------+-------------------------+----------------------+
   |          ID          |   NAME   |     CREATED AT      | HEALTH  | STATUS  |    EXTERNAL ENDPOINT    |  INTERNAL ENDPOINT   |
   +----------------------+----------+---------------------+---------+---------+-------------------------+----------------------+
   | catb3ppsdsh7vajr216f | my-k8s   | 2019-09-04 15:17:11 | HEALTHY | RUNNING | https://84.201.148.31/  | https://10.0.0.24/   |
   +----------------------+----------+---------------------+---------+---------+-------------------------+----------------------+
   

2. Запишите уникальный идентификатор кластера Kubernetes в переменную.

   Bash

   PowerShell

   Выполните команду:

   CLUSTER_ID=catb3ppsdsh7vajr216f
   

   Выполните команду:

   $CLUSTER_ID = "catb3ppsdsh7vajr216f"
   

Подготовьте сертификат кластера Kubernetes

Сохраните сертификат кластера Kubernetes в файл ca.pem. С помощью этого сертификата подтверждается подлинность кластера Kubernetes.

yc managed-kubernetes cluster get --id $CLUSTER_ID --format json | \
    jq -r .master.master_auth.cluster_ca_certificate | \
    awk '{gsub(/\\n/,"\n")}1' > ca.pem

Создайте объект ServiceAccount

Создайте объект ServiceAccount для взаимодействия с API Kubernetes внутри кластера Kubernetes.

1. Сохраните следующую спецификацию для создания объекта ServiceAccount в YAML-файл с названием sa.yaml.

   Подробную спецификацию объекта ServiceAccount читайте в документации Kubernetes.

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: admin-user
     namespace: kube-system
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: admin-user
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: cluster-admin
   subjects:
   - kind: ServiceAccount
     name: admin-user
     namespace: kube-system
   

2. Создайте объект ServiceAccount:

   kubectl create -f sa.yaml
   

Подготовьте токен объекта ServiceAccount

Токен необходим для аутентификации объекта ServiceAccount в кластере Kubernetes.

SA_TOKEN=$(kubectl -n kube-system get secret $(kubectl -n kube-system get secret | \
    grep admin-user | \
    awk '{print $1}') -o json | \
    jq -r .data.token | \
    base64 --d)

Получите IP-адрес кластера Kubernetes

Получите IP-адрес кластера Kubernetes и добавьте его в переменную MASTER_ENDPOINT для дальнейшего использования.

MASTER_ENDPOINT=$(yc managed-kubernetes cluster get --id $CLUSTER_ID \
    --format json | \
    jq -r .master.endpoints.external_v4_endpoint)

MASTER_ENDPOINT=$(yc managed-kubernetes cluster get --id $CLUSTER_ID \
    --format json | \
    jq -r .master.endpoints.internal_v4_endpoint)

$MASTER_ENDPOINT = $CLUSTER.master.endpoints.external_v4_endpoint

$MASTER_ENDPOINT = $CLUSTER.master.endpoints.internal_v4_endpoint

Создайте и заполните файл конфигурации

1. Добавьте сведения о кластере Kubernetes в файл конфигурации.

   Bash

   PowerShell

   Выполните команду:

   kubectl config set-cluster sa-test2 \
                  --certificate-authority=ca.pem \
                  --server=$MASTER_ENDPOINT \
                  --kubeconfig=test.kubeconfig
   

   kubectl config set-cluster sa-test2 `
                  --certificate-authority=ca.pem `
                  --server=$MASTER_ENDPOINT `
                  --kubeconfig=test.kubeconfig
   

2. Добавьте информацию о токене для admin-user в файл конфигурации.

   Bash

   PowerShell

   Выполните команду:

   kubectl config set-credentials admin-user \
                   --token=$SA_TOKEN \
                   --kubeconfig=test.kubeconfig
   

   Выполните команду:

   kubectl config set-credentials admin-user `
                   --token=$SA_TOKEN `
                   --kubeconfig=test.kubeconfig
   

3. Добавьте информацию о контексте в файл конфигурации.

   Bash

   PowerShell

   Выполните команду:

   kubectl config set-context default \
                  --cluster=sa-test2 \
                  --user=admin-user \
                  --kubeconfig=test.kubeconfig
   

   Выполните команду:

   kubectl config set-context default `
                  --cluster=sa-test2 `
                  --user=admin-user `
                  --kubeconfig=test.kubeconfig
   

4. Используйте созданную конфигурацию для дальнейшей работы.

   Bash

   PowerShell

   Выполните команду:

   kubectl config use-context default \
                  --kubeconfig=test.kubeconfig
   

   Выполните команду:

   kubectl config use-context default `
                  --kubeconfig=test.kubeconfig
   

Проверьте результат

Проверьте, что конфигурация настроена верно, выполнив команду:

kubectl get namespace --kubeconfig=test.kubeconfig

NAME          STATUS   AGE
default       Active   9d