Использование Artifact Registry при развертывании приложений в Managed Kubernetes

Вы можете хранить Docker-образы в реестре Artifact Registry и использовать их при развертывании приложений в кластере Managed Kubernetes.

В этом руководстве загрузка образа в реестр и управление кластером Managed Kubernetes осуществляется с помощью виртуальной машины. В качестве примера используется образ nginx из официального репозитория Docker Hub.

1. Создайте реестр Artifact Registry с именем k8s-registry.

2. Создайте NAT-шлюз для подсети, в которой будет развернут кластер Managed Kubernetes.

3. Создайте сервисные аккаунты:

   • C именем sa-k8s и ролью registry.puller — для работы группы узлов Managed Kubernetes.
   • С именем sa-vm и ролями editor и registry.pusher — для инициализации MWS CLI на виртуальной машине, загрузки образа и работы с утилитой kubectl.

4. Создайте кластер Managed Kubernetes и группу узлов для него. При создании группы используйте сервисный аккаунт sa-k8s.

5. Создайте виртуальную машину с внешним IP-адресом в той же сети, где развернут кластер Managed Kubernetes. При создании ВМ привяжите к ней сервисный аккаунт sa-vm.

1. Подключитесь к ВМ по SSH.

2. Установите утилиту MWS CLI.

3. Инициализируйте профиль MWS CLI:

   1
   mws init --vm-sa

4. Установите Docker и пройдите аутентификацию.

5. Установите утилиту командной строки kubectl.

6. Получите kubeconfig:

   1
   mws mk8s get-kubeconfig --name <имя кластера>

7. Убедитесь, что кластер доступен:

   1
   kubectl cluster-info

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

   1
   Kubernetes control plane is running at https://<IP-адрес кластера>
   2
   KubeDNS is running at https://<IP-адрес кластера>/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

1. Скачайте образ nginx из репозитория Docker Hub:

   1
   docker pull nginx:latest

2. Установите тег на образ. Тег нужен для идентификации версии образа в репозитории:

   1
   docker tag nginx:latest registry.mwsapis.ru/<имя проекта>/k8s-registry/nginx:latest

3. Загрузите образ в репозиторий MWS Artifact Registry:

   1
   docker push registry.mwsapis.ru/<имя проекта>/k8s-registry/nginx:latest

1. Создайте файл nginx-deployment.yaml, содержащий манифест для развертывания приложения. В качестве источника образа укажите путь к образу в Artifact Registry:

   1
   apiVersion: apps/v1
   2
   kind: Deployment
   3
   metadata:
   4
     name: nginx-deployment
   5
     labels:
   6
       app: nginx
   7
   spec:
   8
     replicas: 1
   9
     selector:
   10
       matchLabels:
   11
         app: nginx
   12
     template:
   13
       metadata:
   14
         labels:
   15
           app: nginx
   16
       spec:
   17
         containers:
   18
           - name: nginx
   19
             image: registry.mwsapis.ru/<имя проекта>/k8s-registry/nginx:latest
   20
             ports:
   21
               - containerPort: 80
   22
             resources:
   23
               requests:
   24
                 memory: "64Mi"
   25
                 cpu: "250m"
   26
               limits:
   27
                 memory: "128Mi"
   28
                 cpu: "500m"
   29
   ---
   30
   apiVersion: v1
   31
   kind: Service
   32
   metadata:
   33
     name: nginx-service
   34
   spec:
   35
     selector:
   36
       app: nginx
   37
     ports:
   38
       - protocol: TCP
   39
         port: 80
   40
         targetPort: 80
   41
     type: ClusterIP

2. Примените манифест:

   1
   kubectl apply -f nginx-deployment.yaml

3. Убедитесь, что под приложения запущен и работает:

   1
   kubectl get pods -l app=nginx

   Ожидаемый результат:

   1
   NAME                               READY   STATUS    RESTARTS   AGE
   2
   nginx-deployment-dc7b9b9d6-ddd7v   1/1     Running   0          28m

1. Создайте переадресацию порта для сервиса NGINX на виртуальной машине:

   1
   kubectl port-forward service/nginx-service 8080:80

2. Откройте новую сессию подключения к ВМ, после чего получите содержимое приветственной страницы NGINX:

   1
   curl http://localhost:8080

   Ожидаемый результат

   1
   <!DOCTYPE html>
   2
   <html>
   3
   <head>
   4
   <title>Welcome to nginx!</title>
   5
   <style>
   6
   html { color-scheme: light dark; }
   7
   body { width: 35em; margin: 0 auto;
   8
   font-family: Tahoma, Verdana, Arial, sans-serif; }
   9
   </style>
   10
   </head>
   11
   <body>
   12
   <h1>Welcome to nginx!</h1>
   13
   <p>If you see this page, the nginx web server is successfully installed and
   14
   working. Further configuration is required.</p>
   15
   
   16
   <p>For online documentation and support please refer to
   17
   <a href="http://nginx.org/">nginx.org</a>.<br/>
   18
   Commercial support is available at
   19
   <a href="http://nginx.com/">nginx.com</a>.</p>
   20
   
   21
   <p><em>Thank you for using nginx.</em></p>
   22
   </body>
   23
   </html>

В руководстве были созданы ресурсы, которые могут тарифицироваться. Если вы не планируете использовать их, удалите:

• кластер Managed Kubernetes;
• виртуальную машину;
• NAT-шлюз;
• реестр.