[Документация Yandex Cloud](../../index.md) > [Yandex Managed Service for GitLab](../index.md) > [Практические руководства](index.md) > Непрерывное развертывание контейнеризованных приложений Managed Service for Kubernetes # Непрерывное развертывание контейнеризованных приложений Managed Service for Kubernetes {% note warning %} Часть ресурсов, необходимых для прохождения практического руководства, доступны только в [регионе Россия](../../overview/concepts/region.md). {% endnote %} [GitLab](https://about.gitlab.com/) — инструмент [непрерывной интеграции (Continuous integration, CI)](https://yandex.cloud/ru-kz/blog/posts/2022/10/ci-cd). В этом руководстве описаны: * Сборка приложения в [Docker-контейнер](https://yandex.cloud/ru-kz/blog/posts/2022/03/docker-containers). * Развертывание приложения из контейнера в [кластере Yandex Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster) через GitLab с помощью инструментов Yandex Cloud. После каждого коммита в GitLab: * Выполнится сценарий, в котором описаны шаги сборки [Docker-образа](../../container-registry/concepts/docker-image.md). * Применится новая конфигурация кластера Managed Service for Kubernetes, в которой будет указано приложение для развертывания. Чтобы настроить необходимую инфраструктуру для хранения исходного кода, сборки Docker-образа и развертывания приложения: 1. [Подготовьте облако к работе](#before-you-begin). 1. [Изучите список необходимых платных ресурсов](#paid-resources). 1. [Подготовьте инфраструктуру](#deploy-infrastructure). 1. [Создайте инстанс GitLab](#create-gitlab). 1. [Настройте GitLab](#configure-gitlab). 1. [Создайте тестовое приложение](#app-create). 1. [Создайте GitLab Runner](#runners). 1. [Настройте аутентификацию Kubernetes в GitLab](#gitlab-authentication). 1. [Настройте сценарий CI](#ci). 1. [Проверьте результат](#check-result). Если созданные ресурсы больше не нужны, [удалите их](#clear-out). ## Подготовьте облако к работе {#before-you-begin} Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../../billing/concepts/billing-account.md): 1. Перейдите в [консоль управления](https://console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь. 1. На странице **[Yandex Cloud Billing](https://kz.console.yandex.cloud/billing)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../../billing/quickstart/index.md) и [привяжите](../../billing/operations/pin-cloud.md) к нему облако. Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://kz.console.yandex.cloud/cloud). [Подробнее об облаках и каталогах](../../resource-manager/concepts/resources-hierarchy.md). ### Необходимые платные ресурсы {#paid-resources} В стоимость поддержки инфраструктуры входит плата за следующие ресурсы: * [Диски](../../compute/concepts/disk.md) и постоянно запущенные [виртуальные машины](../../compute/concepts/vm.md) ([тарифы Yandex Compute Cloud](../../compute/pricing.md)). * Использование динамического [публичного IP-адреса](../../vpc/concepts/ips.md) ([тарифы Yandex Virtual Private Cloud](../../vpc/pricing.md#prices-public-ip)). * Хранение созданных Docker-образов ([тарифы Container Registry](../../container-registry/pricing.md)). * Использование [мастера Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#master) ([тарифы Managed Service for Kubernetes](../../managed-kubernetes/pricing.md)). ### Подготовьте инфраструктуру {#deploy-infrastructure} {% list tabs group=instructions %} - Вручную {#manual} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Если у вас еще нет [сети](../../vpc/concepts/network.md#network), [создайте ее](../../vpc/operations/network-create.md). 1. Если у вас еще нет [подсетей](../../vpc/concepts/network.md#subnet), [создайте их](../../vpc/operations/subnet-create.md) в [зонах доступности](../../overview/concepts/geo-scope.md), где будут созданы [кластер Yandex Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster) и [группа узлов](../../managed-kubernetes/concepts/index.md#node-group). 1. [Создайте сервисные аккаунты](../../iam/operations/sa/create.md): * Для ресурсов с [ролями](../../iam/concepts/access-control/roles.md) `k8s.clusters.agent` и `vpc.publicAdmin` на [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором создается кластер Managed Service for Kubernetes. От его имени будут создаваться ресурсы, необходимые кластеру Managed Service for Kubernetes. * Для узлов с ролями [container-registry.images.puller](../../container-registry/security/index.md#container-registry-images-puller), [container-registry.images.pusher](../../container-registry/security/index.md#container-registry-images-pusher) и [container-registry.images.scanner](../../container-registry/security/index.md#container-registry-images-scanner) на каталог с [реестром](../../container-registry/concepts/registry.md) [Docker-образов](../../container-registry/concepts/docker-image.md). От его имени узлы Managed Service for Kubernetes будут загружать в реестр собранные в GitLab Docker-образы, а также скачивать их для запуска [подов](../../managed-kubernetes/concepts/index.md#pod). {% note tip %} Вы можете использовать один и тот же [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) для обеих операций. {% endnote %} 1. [Создайте группы безопасности](../../managed-kubernetes/operations/connect/security-groups.md) для кластера Managed Service for Kubernetes и входящих в него групп узлов. {% note warning %} От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений. {% endnote %} 1. [Создайте группу безопасности](../operations/configure-security-group.md) для работы [инстанса Managed Service for GitLab](../concepts/index.md#instance). 1. [Создайте кластер Managed Service for Kubernetes](../../managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-create.md#kubernetes-cluster-create) и [группу узлов](../../managed-kubernetes/operations/node-group/node-group-create.md). При создании кластера Managed Service for Kubernetes укажите ранее созданные сервисные аккаунты для ресурсов и узлов и группы безопасности. 1. [Создайте реестр Yandex Container Registry](../../container-registry/operations/registry/registry-create.md). 1. [Создайте авторизованный ключ](../../iam/operations/authentication/manage-authorized-keys.md#create-authorized-key) для сервисного аккаунта с ролью `container-registry.images.pusher` и сохраните в файл `key.json`: ```bash yc iam key create \ --service-account-name <имя_сервисного_аккаунта> \ --output key.json ``` Ключ необходим для доступа к реестру из GitLab. - Terraform {#tf} 1. Если у вас еще нет Terraform, [установите его](../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). 1. [Получите данные для аутентификации](../../tutorials/infrastructure-management/terraform-quickstart.md#get-credentials). Вы можете добавить их в переменные окружения или указать далее в файле с настройками провайдера. 1. [Настройте и инициализируйте провайдер](../../tutorials/infrastructure-management/terraform-quickstart.md#configure-provider). Чтобы не создавать конфигурационный файл с настройками провайдера вручную, [скачайте его](https://github.com/yandex-cloud-examples/yc-terraform-provider-settings/blob/main/provider.tf). 1. Поместите конфигурационный файл в отдельную рабочую директорию и [укажите значения параметров](../../tutorials/infrastructure-management/terraform-quickstart.md#configure-provider). Если данные для аутентификации не были добавлены в переменные окружения, укажите их в конфигурационном файле. 1. Скачайте в ту же рабочую директорию файл конфигурации [k8s-and-registry-for-gitlab.tf](https://github.com/yandex-cloud-examples/yc-mk8s-cr-gitlab/blob/main/k8s-and-registry-for-gitlab.tf). В этом файле описаны: * [Сеть](../../vpc/concepts/network.md#network). * [Подсеть](../../vpc/concepts/network.md#subnet). * [Кластер Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster). * [Сервисный аккаунт](../../iam/concepts/users/service-accounts.md), необходимый для работы кластера Managed Service for Kubernetes и [группы узлов](../../managed-kubernetes/concepts/index.md#node-group). * [Группы безопасности](../../vpc/concepts/security-groups.md), которые содержат [необходимые правила](../../managed-kubernetes/operations/connect/security-groups.md) для кластера Managed Service for Kubernetes и входящих в него групп узлов. {% note warning %} От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений. {% endnote %} * [Группа безопасности по умолчанию](../../vpc/concepts/security-groups.md#default-security-group) и правила, необходимые для работы [инстанса Managed Service for GitLab](../concepts/index.md#instance). * [Реестр](../../container-registry/concepts/registry.md) [Yandex Container Registry](../../container-registry/index.md). * [Авторизованный ключ](../../iam/concepts/authorization/key.md) для сервисного аккаунта. Ключ необходим для доступа к реестру из GitLab. * Локальный файл `key.json` с данными авторизованного ключа. 1. Укажите в файле `k8s-and-registry-for-gitlab.tf`: * [Идентификатор каталога](../../resource-manager/operations/folder/get-id.md). * [Версию Kubernetes](../../managed-kubernetes/concepts/release-channels-and-updates.md) для кластера Managed Service for Kubernetes и групп узлов. * Имя сервисного аккаунта кластера Managed Service for Kubernetes. * Имя реестра Container Registry. 1. Проверьте корректность файлов конфигурации Terraform с помощью команды: ```bash terraform validate ``` Если в файлах конфигурации есть ошибки, Terraform на них укажет. 1. Создайте необходимую инфраструктуру: 1. Выполните команду для просмотра планируемых изменений: ```bash terraform plan ``` Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены. 1. Если вас устраивают планируемые изменения, внесите их: 1. Выполните команду: ```bash terraform apply ``` 1. Подтвердите изменение ресурсов. 1. Дождитесь завершения операции. В указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в [консоли управления](https://console.yandex.cloud). {% endlist %} {% note warning %} Для реальных приложений доступ сервисных аккаунтов кластера Managed Service for Kubernetes к загрузке Docker-образов в реестр должен быть ограничен по соображениям безопасности. В этом случае создайте отдельный сервисный аккаунт с ролью `container-registry.images.pusher` и указывайте его для развертывания приложений. {% endnote %} ### Установите дополнительные зависимости {#prepare} Установите в локальном окружении: * [Утилиту потоковой обработки JSON-файлов `jq`](https://stedolan.github.io/jq/). * [Инструмент командной строки kubectl](https://kubernetes.io/ru/docs/tasks/tools/install-kubectl) и [настройте его на работу с созданным кластером Managed Service for Kubernetes](../../managed-kubernetes/operations/connect/index.md#kubectl-connect). ## Создайте инстанс GitLab {#create-gitlab} Создайте [инстанс Managed Service for GitLab](../concepts/index.md#instance) или [виртуальную машину](../../compute/concepts/vm.md) с [образом](../../compute/concepts/image.md) GitLab в той же [облачной сети](../../vpc/concepts/network.md#network), где расположен [кластер Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster). {% list tabs group=gl_installation %} - Инстанс Managed Service for GitLab {#instance-mgl} Создайте инстанс Managed Service for GitLab [согласно инструкции](../quickstart.md#instance-create). - ВМ с образом GitLab {#gl-image-vm} Запустите GitLab на ВМ с [публичным IP-адресом](../../vpc/concepts/address.md#public-addresses). 1. На странице [каталога](../../resource-manager/concepts/resources-hierarchy.md#folder) в [консоли управления](https://console.yandex.cloud) нажмите кнопку **Создать ресурс** и выберите `Виртуальная машина`. 1. В блоке **Образ загрузочного диска** в поле **Поиск продукта** введите `Gitlab` и выберите публичный образ [GitLab](https://yandex.cloud/ru-kz/marketplace/products/yc/gitlab). 1. В блоке **Расположение** выберите [зону доступности](../../overview/concepts/geo-scope.md), в которой будет находиться ВМ. Если вы не знаете, какая зона доступности вам нужна, оставьте выбранную по умолчанию. 1. В блоке **Вычислительные ресурсы** перейдите на вкладку `Своя конфигурация` и укажите необходимую [платформу](../../compute/concepts/vm-platforms.md), количество vCPU и объем RAM: * **Платформа** — `Intel Ice Lake`. * **vCPU** — `4`. * **Гарантированная доля vCPU** — `100%`. * **RAM** — `8 ГБ`. 1. В блоке **Сетевые настройки**: * В поле **Подсеть** выберите сеть и подсеть, к которым нужно подключить ВМ. Если нужной [сети](../../vpc/concepts/network.md#network) или [подсети](../../vpc/concepts/network.md#subnet) еще нет, [создайте их](../../vpc/operations/subnet-create.md). * В поле **Публичный IP-адрес** оставьте значение `Автоматически`, чтобы назначить ВМ случайный внешний IP-адрес из пула Yandex Cloud, или выберите статический адрес из списка, если вы зарезервировали его заранее. 1. В блоке **Доступ** выберите вариант **SSH-ключ** и укажите данные для доступа на ВМ: * В поле **Логин** введите имя пользователя. Не используйте имя `root` или другие имена, зарезервированные ОС. Для выполнения операций, требующих прав суперпользователя, используйте команду `sudo`. * В поле **SSH-ключ** выберите SSH-ключ, сохраненный в вашем профиле [пользователя организации](../../organization/concepts/membership.md). Если в вашем профиле нет сохраненных SSH-ключей или вы хотите добавить новый ключ: 1. Нажмите кнопку **Добавить ключ**. 1. Задайте имя SSH-ключа. 1. Выберите вариант: * `Ввести вручную` — вставьте содержимое открытого [SSH](../../glossary/ssh-keygen.md)-ключа. Пару SSH-ключей необходимо [создать](../../compute/operations/vm-connect/ssh.md#creating-ssh-keys) самостоятельно. * `Загрузить из файла` — загрузите открытую часть SSH-ключа. Пару SSH-ключей необходимо создать самостоятельно. * `Сгенерировать ключ` — автоматическое создание пары SSH-ключей. При добавлении сгенерированного SSH-ключа будет создан и загружен архив с парой ключей. В ОС на базе Linux или macOS распакуйте архив в папку `/home/<имя_пользователя>/.ssh`. В ОС Windows распакуйте архив в папку `C:\Users\<имя_пользователя>/.ssh`. Дополнительно вводить открытый ключ в консоли управления не требуется. 1. Нажмите кнопку **Добавить**. SSH-ключ будет добавлен в ваш профиль пользователя организации. Если в организации [отключена](../../organization/operations/os-login-access.md) возможность добавления пользователями SSH-ключей в свои профили, добавленный открытый SSH-ключ будет сохранен только в профиле пользователя внутри создаваемого ресурса. 1. В блоке **Общая информация** задайте имя ВМ: `ci-tutorial-gitlab`. 1. Нажмите кнопку **Создать ВМ**. Создание ВМ может занять несколько минут. Когда ВМ перейдет в статус `RUNNING` и запустится GitLab, настройте его. {% endlist %} ## Настройте GitLab {#configure-gitlab} Чтобы настроить GitLab и подготовить процесс непрерывной интеграции ([Continuous Integration](https://yandex.cloud/ru-kz/blog/posts/2022/10/ci-cd), CI), создайте новый проект и введите параметры для аутентификации в CI: {% list tabs group=gl_installation %} - Инстанс Managed Service for GitLab {#instance-mgl} 1. Авторизуйтесь в веб-интерфейсе [инстанса Managed Service for GitLab](../concepts/index.md#instance). 1. Нажмите кнопку **Create a project**. 1. Нажмите кнопку **Create blank project**. 1. Заполните поля: * **Project name** — `gitlab-test`. * **Project URL** — выберите пользователя-администратора в поле рядом с FQDN инстанса Managed Service for GitLab. Остальные поля оставьте без изменений. 1. Нажмите кнопку **Create project**. - ВМ с образом GitLab {#gl-image-vm} 1. На странице сервиса Yandex Compute Cloud выберите созданную [ВМ](../../compute/concepts/vm.md) и скопируйте ее [публичный IP-адрес](../../vpc/concepts/address.md#public-addresses). 1. [Подключитесь](../../compute/operations/vm-connect/ssh.md) к ВМ по протоколу SSH. 1. Получите пароль администратора GitLab с помощью команды ВМ: ```bash sudo cat /etc/gitlab/initial_root_password ``` 1. Скопируйте пароль из строки `Password` (исключая пробелы) в буфер обмена или отдельный файл. 1. Откройте в браузере ссылку `http://<публичный_IP-адрес_ВМ>`. Откроется веб-интерфейс GitLab. 1. Войдите в систему с учетной записью администратора: * **Username or email** — `root`. * **Password** — пароль, скопированный ранее. Если вы не можете войти, [сбросьте пароль учетной записи администратора](https://docs.gitlab.com/security/reset_user_password/#reset-your-root-password). 1. [Смените пароль учетной записи администратора](https://docs.gitlab.com/user/profile/user_passwords/#change-your-password). 1. Повторно войдите в систему с учетной записью администратора, используя новый пароль. 1. Выберите **Create a project**. 1. Задайте имя проекта: `gitlab-test`. 1. Нажмите кнопку **Create project**. {% endlist %} ## Создайте тестовое приложение {#app-create} Создайте тестовое приложение, которое можно будет развернуть в [кластере Yandex Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster): 1. Добавьте в проект `Dockerfile`: 1. Авторизуйтесь в GitLab. 1. Откройте проект GitLab. 1. В строке навигации по репозиторию нажмите кнопку ![image](../../_assets/console-icons/plus.svg) и в выпадающем меню выберите пункт **New file**. 1. Назовите файл `Dockerfile` и добавьте в него код: ```Dockerfile FROM alpine:3.10 CMD echo "Hello" ``` 1. Напишите комментарий к коммиту в поле **Commit message**: `Dockerfile for test application`. 1. Нажмите кнопку **Commit changes**. 1. Добавьте в проект манифест создания ресурсов кластера Managed Service for Kubernetes: 1. Откройте проект GitLab. 1. В строке навигации по репозиторию нажмите кнопку ![image](../../_assets/console-icons/plus.svg) и в выпадающем меню выберите пункт **New file**. 1. Назовите файл `k8s.yaml`: {% cut "k8s.yaml" %} ```yaml apiVersion: v1 kind: Namespace metadata: name: hello-world --- apiVersion: apps/v1 kind: Deployment metadata: name: hello-world-deployment namespace: hello-world spec: replicas: 1 selector: matchLabels: app: hello template: metadata: namespace: hello-world labels: app: hello spec: containers: - name: hello-world image: __VERSION__ imagePullPolicy: Always ``` {% endcut %} 1. Напишите комментарий к коммиту в поле **Commit message**: `Docker image deployment config`. 1. Нажмите кнопку **Commit changes**. ## Создайте GitLab Runner {#runners} Чтобы запускать задачи сборки в [кластере Yandex Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster), создайте [GitLab Runner](https://docs.gitlab.com/runner/install/kubernetes/). После установки вы можете запускать автоматизированные сборки внутри своего [кластера Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster). Подробнее про установку и настройку GitLab Runner читайте в [документации GitLab](https://docs.gitlab.com/runner/install/). ## Настройте аутентификацию Kubernetes в GitLab {#gitlab-authentication} Настроить аутентификацию в GitLab можно с помощью токена сервисного аккаунта Kubernetes или приложения GitLab Agent: {% list tabs group=gl_auth %} - Токен сервисного аккаунта {#token} ### Получите токен сервисного аккаунта Kubernetes для аутентификации в GitLab {#k8s-get-token} {% note info %} [Сервисный аккаунт Kubernetes](../../managed-kubernetes/concepts/index.md#service-accounts) отличается от [сервисного аккаунта Yandex Identity and Access Management](../../iam/concepts/users/service-accounts.md). {% endnote %} Чтобы получить токен сервисного аккаунта Kubernetes: 1. [Создайте сервисный аккаунт](../../managed-kubernetes/operations/connect/create-static-conf.md#create-sa). 1. [Получите токен сервисного аккаунта](../../managed-kubernetes/operations/connect/create-static-conf.md#prepare-token). 1. Сохраните полученный токен — он понадобится для следующих шагов. - GitLab Agent {#gla} ## Создайте GitLab Agent {#agent} Чтобы подключить [кластер Yandex Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster) к GitLab, создайте [GitLab Agent](https://docs.gitlab.com/ee/user/clusters/agent/). После установки вы можете подключать [кластер Managed Service for Kubernetes](../../managed-kubernetes/concepts/index.md#kubernetes-cluster) к [инстансу GitLab](../concepts/index.md#instance). Подробнее про установку и настройку GitLab Agent читайте в [документации GitLab](https://docs.gitlab.com/ee/user/clusters/agent/). {% endlist %} ## Настройте сценарий CI {#ci} 1. Создайте [переменные окружения GitLab](https://docs.gitlab.com/ee/ci/variables/): 1. На панели слева в GitLab перейдите в раздел **Settings** и во всплывающем списке выберите пункт **CI/CD**. 1. Нажмите кнопку **Expand** напротив пункта **Variables**. 1. Добавьте переменные окружения в зависимости от способа аутентификации Kubernetes в GitLab: {% list tabs group=gl_auth %} - Токен сервисного аккаунта {#token} * `KUBE_URL` — адрес мастера Managed Service for Kubernetes. Узнайте его с помощью команды: ```bash yc managed-kubernetes cluster get <идентификатор_или_имя_кластера> --format=json \ | jq -r .master.endpoints.external_v4_endpoint ``` * `KUBE_TOKEN` — токен, который GitLab будет использовать для применения конфигурации. Используйте токен, полученный ранее. - GitLab Agent {#gla} {% endlist %} * `CI_REGISTRY` — адрес созданного ранее реестра в формате `cr.yandex/<идентификатор_реестра>`. * `CI_REGISTRY_KEY` — ключ, который GitLab будет использовать для доступа к реестру. Скопируйте содержимое файла статического ключа `key.json` для доступа к реестру, полученного ранее. Для добавления переменной: * Нажмите кнопку **Add variable**. * В появившемся окне в поле **Key** укажите имя переменной, в поле **Value** — значение переменной. * Нажмите кнопку **Add variable**. 1. Создайте файл конфигурации сценария CI: 1. Откройте проект `gitlab-test`. 1. В строке навигации по репозиторию нажмите кнопку ![image](../../_assets/console-icons/plus.svg) и в выпадающем меню выберите пункт **New file**. 1. Назовите файл `.gitlab-ci.yml`. Добавьте в него шаги сборки и загрузки Docker-образа и обновления конфигурации приложения в кластере Managed Service for Kubernetes. Структура файла зависит от способа аутентификации Kubernetes в GitLab: {% list tabs group=gl_auth %} - Токен сервисного аккаунта {#token} * Для сборки контейнера с помощью `kaniko` без использования привилегированного режима GitLab Runner: {% cut ".gitlab-ci.yml" %} ```yaml stages: - build - deploy build: stage: build image: name: gcr.io/kaniko-project/executor:debug entrypoint: [""] script: - mkdir -p /kaniko/.docker - echo "{\"auths\":{\"${CI_REGISTRY}\":{\"auth\":\"$(echo -n "json_key:${CI_REGISTRY_KEY}" | base64 | tr -d '\n' )\"}}}" > /kaniko/.docker/config.json - >- /kaniko/executor --context "${CI_PROJECT_DIR}" --dockerfile "${CI_PROJECT_DIR}/Dockerfile" --destination "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" deploy: image: gcr.io/cloud-builders/kubectl:latest stage: deploy script: - kubectl config set-cluster k8s --server="$KUBE_URL" --insecure-skip-tls-verify=true - kubectl config set-credentials admin --token="$KUBE_TOKEN" - kubectl config set-context default --cluster=k8s --user=admin - kubectl config use-context default - sed -i "s,__VERSION__,${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}," k8s.yaml - kubectl apply -f k8s.yaml ``` {% endcut %} * Для сборки контейнера с помощью `docker:dind` c использованием привилегированного режима GitLab Runner: {% cut ".gitlab-ci.yml" %} ```yaml stages: - build - deploy image: docker:20.10.16 variables: DOCKER_HOST: tcp://docker:2376 DOCKER_TLS_CERTDIR: "/certs" DOCKER_TLS_VERIFY: 1 DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client" DOCKER_DRIVER: overlay2 services: - docker:20.10.16-dind before_script: - for try in {1..10}; do sleep 0.5; docker info && break ; done build: stage: build script: - echo "${CI_REGISTRY_KEY}" | docker login ${CI_REGISTRY} -u json_key --password-stdin - >- docker build "${CI_PROJECT_DIR}" --file "${CI_PROJECT_DIR}/Dockerfile" --tag "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" - docker push "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" deploy: image: gcr.io/cloud-builders/kubectl:latest stage: deploy script: - kubectl config set-cluster k8s --server="$KUBE_URL" --insecure-skip-tls-verify=true - kubectl config set-credentials admin --token="$KUBE_TOKEN" - kubectl config set-context default --cluster=k8s --user=admin - kubectl config use-context default - sed -i "s,__VERSION__,${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}," k8s.yaml - kubectl apply -f k8s.yaml ``` {% endcut %} - GitLab Agent {#gla} * Для сборки контейнера с помощью `kaniko` без использования привилегированного режима GitLab Runner: {% cut ".gitlab-ci.yml" %} ```yaml stages: - build - deploy build: stage: build image: name: gcr.io/kaniko-project/executor:debug entrypoint: [""] script: - mkdir -p /kaniko/.docker - echo "{\"auths\":{\"${CI_REGISTRY}\":{\"auth\":\"$(echo -n "json_key:${CI_REGISTRY_KEY}" | base64 | tr -d '\n' )\"}}}" > /kaniko/.docker/config.json - >- /kaniko/executor \ --context "${CI_PROJECT_DIR}" \ --dockerfile "${CI_PROJECT_DIR}/Dockerfile" \ --destination "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" deploy: image: bitnamilegacy/kubectl:latest stage: deploy script: - kubectl config use-context ${CI_PROJECT_PATH}:<имя_GitLab_Agent> - cat k8s.yaml | sed -e "s,__VERSION__,${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}," | kubectl apply -f - ``` {% endcut %} * Для сборки контейнера с помощью `docker:dind` с использованием привилегированного режима GitLab Runner: {% cut ".gitlab-ci.yml" %} ```yaml stages: - build - deploy image: docker:20.10.16 variables: DOCKER_HOST: tcp://docker:2376 DOCKER_TLS_CERTDIR: "/certs" DOCKER_TLS_VERIFY: 1 DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client" DOCKER_DRIVER: overlay2 services: - docker:20.10.16-dind before_script: - for try in {1..10}; do sleep 0.5; docker info && break ; done build: stage: build script: - echo "${CI_REGISTRY_KEY}" | docker login ${CI_REGISTRY} -u json_key --password-stdin - >- docker build "${CI_PROJECT_DIR}" --file "${CI_PROJECT_DIR}/Dockerfile" --tag "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" - docker push "${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}" deploy: image: name: bitnamilegacy/kubectl:latest entrypoint: [""] stage: deploy script: - kubectl config use-context ${CI_PROJECT_PATH}:<имя_GitLab_Agent> - cat k8s.yaml | sed -e "s,__VERSION__,${CI_REGISTRY}/${CI_PROJECT_PATH}:${CI_COMMIT_SHORT_SHA}," | kubectl apply -f - ``` {% endcut %} Вместо `<имя_GitLab_Agent>` укажите имя агента в Managed Service for GitLab. {% endlist %} 1. Напишите комментарий к коммиту в поле **Commit message**: `CI scripts`. 1. Нажмите кнопку **Commit changes**. В файле `.gitlab-ci.yml` описаны два шага сборки проекта: * Сборка Docker-образа с использованием `Dockerfile` и загрузка образа в Container Registry. * Настройка окружения для работы с Kubernetes и применение конфигурации `k8s.yaml` к кластеру Managed Service for Kubernetes. Таким образом приложение развертывается на созданном ранее кластере Managed Service for Kubernetes. ## Проверьте результат {#check-result} 1. После сохранения файла конфигурации `.gitlab-ci.yml` запустится сценарий сборки. Чтобы проверить результаты его выполнения, на панели слева в проекте `gitlab-test` выберите пункт **Build**, в выпадающем меню выберите пункт **Pipelines** и дождитесь успешного завершения обоих этапов сборки. 1. Чтобы проверить работу созданного приложения в кластере Managed Service for Kubernetes, посмотрите логи контейнера в кластере: ```bash kubectl logs deployment/hello-world-deployment -n hello-world ``` Результат: ```text Hello ``` ## Удалите созданные ресурсы {#clear-out} Некоторые ресурсы платные. Удалите ресурсы, которые вы больше не будете использовать, во избежание списания средств за них: 1. [Удалите созданные Docker-образы](../../container-registry/operations/docker-image/docker-image-delete.md). 1. Удалите кластер Managed Service for Kubernetes и реестр Container Registry: {% list tabs group=instructions %} - Вручную {#manual} 1. [Удалите кластер Managed Service for Kubernetes](../../managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-delete.md). 1. [Удалите реестр Container Registry](../../container-registry/operations/registry/registry-delete.md). 1. [Удалите созданные подсети](../../vpc/operations/subnet-delete.md) и [сети](../../vpc/operations/network-delete.md). 1. [Удалите созданные сервисные аккаунты](../../iam/operations/sa/delete.md). - Terraform {#tf} 1. В терминале перейдите в директорию с планом инфраструктуры. {% note warning %} Убедитесь, что в директории нет Terraform-манифестов с ресурсами, которые вы хотите сохранить. Terraform удаляет все ресурсы, которые были созданы с помощью манифестов в текущей директории. {% endnote %} 1. Удалите ресурсы: 1. Выполните команду: ```bash terraform destroy ``` 1. Подтвердите удаление ресурсов и дождитесь завершения операции. Все ресурсы, которые были описаны в Terraform-манифестах, будут удалены. {% endlist %} 1. [Удалите созданную ВМ GitLab](../../compute/operations/vm-control/vm-delete.md) или инстанс Managed Service for GitLab. ## Полезные ссылки {#see-also} * [Создание тестовых ВМ через GitLab CI](../../tutorials/testing/ci-for-snapshots.md).