tocdepth

2

Быстрый старт CodeArts

С помощью быстрого старта вы:

  • создадите репозиторий с веб-приложением на Spring Boot;

  • настроите сборку приложения при помощи инструментов CI/CD;

  • развернете приложение на виртуальной машине Elastic Cloud Server (ECS).

Перед началом работы

  1. Зарегистрируйтесь в личном кабинете Cloud.ru.

    Если вы уже зарегистрированы, войдите в консоль управления Advanced через личный кабинет Cloud.ru или как IAM-пользователь.

  2. Создайте виртуальную машину ECS, на которой развернете приложение. Задайте следующие обязательные параметры:

    Категория

    Настройки

    Configure Basic Settings

    • Specifications — выберите 2vCPUs и 4GiB или выше.

    • Image — выберите Public image → Ubuntu → Ubuntu 22.04 server 64bit(10 GiB).

    Configure Network

    • EIP — выберите Auto assign.

    • Billed By — выберите By bandwidth.

    Configure Advanced Settings

    • Login Mode — выберите Password.

    • Password — введите пароль.

    Остальные параметры могут быть по умолчанию.

  3. Добавьте правила группы безопасности, в которых разрешен входящий трафик для портов 22 и 8080. Через порт 22 CodeArts Deploy будет подключаться к вашей виртуальной машине, чтобы развернуть на ней приложение. Через порт 8080 будет доступно веб-приложение, развернутое на виртуальной машине.

    Подсказка

    Для большей безопасности вы можете настроить прокси-сервер (en).

Шаг 1. Подключите пакет сервисов CodeArts

  1. В списке сервисов выберите CodeArts.

  2. На вкладке Overview нажмите Pay-per-Use Package.

  3. Ознакомьтесь с информацией и нажмите Next.

  4. Подтвердите подписку, нажав Submit → Yes.

    На вкладках My Services и My Subscriptions появится информация о вашей подписке.

Шаг 2. Создайте проект

  1. В консоли CodeArts нажмите Access Service.

    Откроется рабочее пространство (Workspace).

  2. Нажмите Create Project и выберите Scrum.

  3. В Project Name задайте имя проекта и нажмите OK.

Шаг 3. Создайте репозиторий

Создайте репозиторий для исходных файлов приложения, используя готовый образец Java Web Demo:

  1. В рабочем пространстве CodeArts, на панели навигации слева выберите Code → Repo.

  2. Нажмите New Repository, выберите Template и нажмите Next.

  3. В списке доступных примеров выберите Java Web Demo и нажмите Next.

  4. В Repository Name задайте имя репозитория и нажмите OK.

Шаг 4. Запустите проверку кода

  1. На панели навигации слева выберите Code → Check.

  2. В строке с именем репозитория, в столбце Operation нажмите Запустить.

  3. Дождитесь окончания проверки.

    Значок Успешно в столбце Last Check означает, что проверка кода успешно пройдена. Также в коде обнаружатся ошибки, количество которых превышает допустимый порог, поэтому в столбце Gate Result появится статус «Failed». Эти ошибки сделаны для демонстрации и не влияют на работоспособность приложения.

  4. Чтобы посмотреть результаты проверки, в столбце Task нажмите на название задачи.

Шаг 5. Соберите пакет с приложением

  1. На панели навигации слева выберите CICD → Build.

  2. В строке с названием репозитория, в столбце Operation нажмите Запустить.

  3. Подтвердите параметры сборки, нажав Confirm.

  4. Дождитесь окончания сборки.

    Значок Успешно рядом с названием задачи означает, что сборка приложения успешно завершена.

Чтобы найти построенный артефакт:

  1. Нажмите на название задачи.

  2. В колонке Build ID найдите номер сборки.

  3. На панели навигации слева выберите Artifact → Release Repos.

  4. На вкладке Repository View перейдите в каталог с названием задачи сборки, а затем в каталог с номером сборки.

    В этом каталоге вы найдете архив приложения demoapp.jar.

Шаг 6. Разверните приложение

На этом шаге вы добавите виртуальную машину ECS в качестве хоста, настроите окружение и развернете приложение.

Сначала добавьте кластер хостов:

  1. На панели навигации слева выберите Settings → General.

  2. Выберите Basic Resources и нажмите Create Host Cluster.

  3. Укажите следующие параметры кластера хостов:

    • Cluster Name — задайте название кластера.

    • OS — выберите Linux.

    • Host Connection Mode — выберите Direct Connection.

      Если вы настроили прокси-сервер, выберите Proxy.

    • Execution Resource Pool — выберите Official.

  4. Нажмите Save.

    Создастся пустой кластер.

Чтобы добавить хост в кластер:

  1. Нажмите Add Target Host.

    Если ранее вы выбрали Proxy в Host Connection Mode, нажмите Add Proxy Host.

  2. Укажите следующие параметры:

    • Host Name — название виртуальной машины ECS, которую вы создали.

    • IP — EIP виртуальной машины ECS, которую вы создали.

    • Authorization — выберите Password.

    • Username — введите root.

    • Password — введите ваш пароль к виртуальной машине ECS.

    • SSH Port — введите 22.

  3. Нажмите OK.

Когда проверка подключения к хосту будет пройдена, в колонке Verification Result появится статус «Successful».

Чтобы развернуть приложение:

  1. На панели навигации слева выберите CICD → Deploy.

  2. В строке с названием задачи, в столбце Operation нажмите Еще и выберите Edit.

  3. Перейдите на вкладку Environment Management и настройте окружение для хоста:

    1. Нажмите Create Environment и укажите следующие параметры:

      • Environment — задайте название окружения.

      • Resource Type — выберите Host.

      • OS — выберите Linux.

    2. Нажмите Save.

    3. Нажмите Import Host, выберите кластер хостов и хост, которые вы добавили ранее, и нажмите Import.

    4. Когда хост добавится, закройте окно.

  4. Вернитесь на вкладку Deployment Actions и настройте этапы развертывания:

    1. Install JDK — убедитесь, что в JDK Version указана версия openjdk-1.8.0. Эта версия будет установлена на хост.

    2. Select Deployment Source — укажите параметры источника для развертывания:

      • Source — выберите Build task.

      • Build Task — выберите название задачи.

      • Download Path — введите /usr/local/${package_name}/..

    3. Stop Spring Boot — на карточке с действием нажмите Еще и выберите Disable, чтобы отменить остановку Spring Boot. Это необходимо делать при первом развертывании, чтобы не получить ошибку, так как сервис Spring Boot еще не запущен на хосте.

    4. Start Spring Boot — оставьте без изменений.

    5. Health Test Through URLs — оставьте без изменений.

  5. Перейдите на вкладку Parameters и в столбце Default Value задайте следующие параметры:

    • host_group — выберите окружение для хоста, которое вы добавили ранее.

    • package_url — удалите этот параметр, нажав Удалить в столбце Operation.

    • service_port — введите 8080.

    • package_name — введите demoapp.

  6. Нажмите Save & Deploy → OK.

    Когда все этапы развертывания приложения завершатся успешно, вы увидите сообщение «Successful».

Чтобы проверить развернутое приложение, в браузере перейдите по адресу http://<ip>:8080/test, где вместо <ip> введите EIP вашей виртуальной машины. Если открылась страница с надписью «hello world», вы успешно развернули веб-приложение на виртуальной машине.

Шаг 7. Настройте конвейер

В CodeArts вы можете объединить в один конвейер задачи по проверке кода, сборке и развертыванию приложения. Конвейер будет запускаться автоматически при изменениях в коде и обеспечивать непрерывную доставку приложения на сервер.

Чтобы настроить конвейер:

  1. На панели навигации слева выберите CICD → Pipeline.

  2. В строке с названием задачи, в столбце Operation нажмите Еще и выберите Edit.

  3. Для этапа Deploy-And-Test выполните следующее:

    1. Наведите на задачу apitest, выберите Удалить и нажмите OK. Для быстрого старта эта задача не требуется.

    2. Нажмите на задачу deploy, чтобы перейти в ее редактирование.

    3. В Build Task выберите cloudbuild и проверьте, что остальные параметры заполнены верно.

    4. Нажмите OK.

  4. В верхнем меню выберите More → Execution Plan.

  5. Активируйте опцию Code commit и убедитесь, что в Filter Branch выбрано Include и master.

  6. Нажмите Save.

  7. Выйдите из окна редактирования конвейера и на панели навигации слева выберите CICD → Deploy.

  8. В строке с названием задачи, в столбце Operation нажмите Еще и выберите Edit.

  9. На карточке с действием Stop Spring Boot нажмите Еще и выберите Enable.

  10. Нажмите Save.

Чтобы внести изменения в код приложения и запустить конвейер:

  1. На панели навигации слева выберите Code → Repo.

  2. Перейдите в репозиторий с приложением.

  3. Найдите файл TestController.java, который находится в каталоге src/main/java/com/codearts/controller.

  4. Перейдите в файл и нажмите Редактировать.

  5. Замените hello world на hello world again.

  6. Чтобы отправить изменения в репозиторий, нажмите OK.

  7. На панели навигации слева перейдите в CICD → Pipeline и убедитесь, что конвейер запустился.

  8. Когда появится значок Успешно рядом с названием конвейера, снова перейдите по адресу http://<ip>:8080/test, где <ip> — это EIP вашей виртуальной машины.

    Если открылась страница с надписью «hello world again», вы успешно настроили конвейер и обновили веб-приложение на виртуальной машине.

Шаг 8. Удалите ресурсы

Чтобы избежать лишних трат, после прохождения быстрого старта вы можете удалить проект CodeArts и виртуальную машину ECS, если они вам не нужны.

Внимание

Вы не сможете восстановить ресурсы после удаления.

Чтобы удалить проект CodeArts:

  1. На панели навигации слева выберите Settings > General > Basic Information > Delete Project.

  2. Введите название проекта, который собираетесь удалить, и нажмите Delete.

Чтобы удалить виртуальную машину ECS, воспользуйтесь инструкцией.

Что дальше

Узнайте больше о совместной работе над проектами (en) в CodeArts Req и тестировании продукта (en) в CodeArts TestPlan.

Запустили Evolution free tier
для Dev & Test
Получить