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

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

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. Создайте репозиторий

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. Разверните приложение

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.

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».

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

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. Удалите ресурсы

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

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

Что дальше