В этой статье я расскажу как построить простой пайплайн для деплоя Spring Boot проекта на сервере используя GitHub Actions и Docker.

Содержание:

1. Регистрация self-hosted раннера на VPS с ОС Linux и установленным Docker.

2. Создание .yml файла с описанием пайплайна — базовая структура, операции и команды. Создание статус — бейджика.

3. Функция оповещений в мобильном приложении GitHub.

Что имеем

• Арендованный VPS с установленным Docker и docker-compose

• Репозиторий базового Spring Boot проекта с Dockerfile и docker-compose.yml

Настройка раннера

Деплоить будем на сервере. Для этого нужно настроить раннер.

Логинимся на VPS. Раннер нельзя запустить от имени root пользователя, поэтому придется создать нового, не забыв предоставить ему права на использование Docker.

useradd -m user
paswwd user
groupadd docker
usermod -aG docker user
chsh -s /bin/bash user
su user

В репозитории переходим в Settings → Actions → Runners → New self-hosted runner

Указываем параметры нашего VPS. У меня это Linux. Архитектура процессора - x64. После этого появятся автосгенерированные скрипты для настройки раннера.

Вводим первую группу скриптов.

Запускаем скрипт конфигурации. Из всех дефолтных значений я изменил только название раннера.

Теперь можно запускать раннер. Я предпочитаю делать это в фоновом режиме с помощью nohup.

  nohup ./run.sh > runner.logs &

Проверим статус раннера в GitHub.

Создание пайплайна.

Все скрипты пайплайнов должны лежать в специальной папке {проект}/.github/workflows .

Создадим скрипт deploy-job.yml и поместим его в эту папку.

В первой строчке укажем название пайплайна. Оно будет отображаться в GitHub.

name: Deploy buy runner

Затем укажем когда запускать этот пайплайн - в нашем случае пускай это будет при пуше в ветку master или develop.

on:
  push:
    branches: [ "master", "develop" ]

Затем начнем описывать джобы.

Первым делом будем запускать тесты.

jobs:
  test: # Название джобы
    runs-on: ubuntu-latest   # Где должна выполняться джоба. 
# Здесь укажем GitHub-hosted runner - среду выполнения, которую предоставляет сам GitHub.
    steps: # Перечень шагов, которые необходимо выполнить в рамках джобы.
      - name: cd into repo # Название шага
        uses: actions/checkout@v3 # Ключевое слово uses используется для запуска заранее
# созданного набора команд. В данном случае используем дефолтную команду
# для обновления проекта до последнего коммита.
      - name: set up Java and Maven # Настраиваем Java и Maven.
        uses: actions/setup-java@v3 
        with:
          java-version: '11'
          distribution: 'temurin'
          cache: maven
      - name: run tests
        run: mvn test # Запускаем тесты.

Затем подготовим окружение - удалим старые контейнеры и имейджы.

  prepare-environment:
    runs-on: self-hosted # Запускаем на раннере, который настроили до этого.
    needs: test # Запускаем только если джоба test прошла успешно
    steps:
      - name: Stop and remove containers, networks
        run: docker-compose down
      - name: Remove unused data
        run: docker system prune -a -f

После этого запустим проект с помощью docker-compose.

  deploy:
    runs-on: self-hosted # Запускаем на раннере, который настроили до этого.
    needs: prepare-environment # Запускаем только если джоба prepare-environment прошла успешно
    steps:
      - name: checkout repo
        uses: actions/checkout@v3
      - name: docker-compose
        run: docker-compose up -d

Итоговый файл:

name: Deploy buy runner

on:
  push:
    branches: [ "master", "develop" ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: checkout repo
        uses: actions/checkout@v3
      - name: set up Java and Maven
        uses: actions/setup-java@v3
        with:
          java-version: '11'
          distribution: 'temurin'
          cache: maven
      - name: run tests
        run: mvn test
  prepare-environment:
    runs-on: self-hosted
    needs: test
    steps:
      - name: Stop and remove containers, networks
        run: docker-compose down
      - name: Remove unused data
        run: docker system prune -a -f
  deploy:
    runs-on: self-hosted
    needs: prepare-environment
    steps:
      - name: checkout repo
        uses: actions/checkout@v3
      - name: docker-compose
        run: docker-compose up -d

Коммитим, пушим, ждем, смотрим на результат.

Все работает. Теперь можем создать бейджик и запихнуть его в README.md. Шаги отмечены на картинке:

После этого появится окно с настройкой бейджика.

Дефолтные параметры я не менял. Копируем сгенерированную ссылку, вставляем в README.md и получаем следующее:

Мобильные оповещения.

Хотелось бы отметить функцию оповещений о работе пайплайнов в мобильном приложении GitHub. Включить ее можно в настройках. Выглядит это примерно вот так:

В случае фейла можно даже посмотреть логи.

Заключение

В этой статья я описал процесс создания простого пайплайна GitHub Actions для деплоя Spring Boot проекта с использованием Docker.

Единственное, что в этой статье сильно привязано к программной реализации, это джоба тестирования в созданном пайплайне. Все остальные аспекты создания и настройки CI/CD универсальны для любых проектов, использующих Docker.