CI/CD на GitHub Actions + Node.js + Vultr

Полное пошаговое руководство простыми словами

Эта статья — для разработчиков, начинающих и тех, кто только слышал слово CI/CD.
Мы не будем «умничать», а разберём всё медленно, логично и по шагам.

---

Что мы сделаем в этой статье (коротко)

В конце у тебя будет:

• простой сайт на Node.js
• код, хранящийся на GitHub
• сервер на Vultr
• автоматический деплой:

🔁 изменил код → GitHub → сервер → сайт обновился сам

Без FTP. Без ручной загрузки файлов.

---

Важно: где мы будем что-то делать

Чтобы не было путаницы, сразу договоримся:

Есть 3 места, где мы работаем

1️⃣ Твой компьютер

Здесь мы:

• создаём папку проекта
• пишем файлы сайта

2️⃣ GitHub (через браузер)

Здесь:

• хранится код
• настраивается CI/CD

3️⃣ Сервер Vultr

Здесь:

• работает сайт
• выполняется деплой

---

Шаг 1. Создаём папку проекта

📍 На компьютере

Это обычная папка, внутри которой лежат файлы сайта.

1. Открой любую папку на компьютере
2. Нажми Правой кнопкой → Создать → Папку
3. Назови её:

cicd-node-site

Готово ✅
Это и есть наш проект.

---

Шаг 2. Создаём простой сайт на Node.js

📍 В этой папке

Зачем Node.js

Node.js позволяет запускать JavaScript на сервере.
Он:

• простой
• популярный
• идеально подходит для CI/CD

---

2.1 Создаём файл index.js

1. Зайди в папку cicd-node-site
2. Нажми ПКМ → Создать → Текстовый документ
3. Переименуй файл в:

index.js

⚠️ Важно: чтобы не было .txt в конце

---

2.2 Вставь код в index.js

Открой файл и вставь:

const http = require('http');

const server = http.createServer((req, res) => {
  res.end('CI/CD работает! 🚀');
});

server.listen(3000, () => {
  console.log('Сервер запущен на порту 3000');
});

👉 Это минимальный сайт
👉 Он просто выводит текст в браузере

---

Шаг 3. Загружаем проект на GitHub

📍 В браузере

Зачем GitHub

GitHub нужен, чтобы:

• хранить код
• отслеживать изменения
• запускать CI/CD автоматически

---

3.1 Создай репозиторий

1. Перейди на github.com
2. Нажми New repository
3. Название:

cicd-node-demo

4. Нажми Create repository

---

3.2 Загрузи файлы (без терминала)

1. Открой репозиторий
2. Нажми Add file → Upload files
3. Перетащи файл index.js
4. Нажми Commit changes

Готово ✅
Код теперь в GitHub.

---

Шаг 4. Создаём сервер на Vultr

📍 В браузере

Что такое Vultr простыми словами

Vultr это:

• компьютер в интернете
• работает 24/7
• там будет наш сайт

---

Что выбрать при создании сервера

• OS: Ubuntu 22.04
• Тариф: минимальный
• Регион: любой

После создания ты получишь:

• IP-адрес сервера
• доступ по SSH

---

Шаг 5. Подключаемся к серверу

📍 На компьютере

Что такое SSH

SSH — это способ подключиться к серверу, как будто ты сидишь за ним.

---

Как подключиться

Windows

• Используй PowerShell

Mac / Linux

• Используй Terminal

Команда:

ssh root@IP_СЕРВЕРА

Пример:

ssh root@123.45.67.89

Если спросит подтверждение — напиши yes.

---

Шаг 6. Устанавливаем Node.js на сервер

📍 На сервере (через SSH)

apt update
apt install nodejs npm -y

Проверка:

node -v
npm -v

Если версии выводятся — всё ок ✅

---

Шаг 7. Готовим сервер для деплоя

📍 На сервере

Создадим папку для сайта:

mkdir /var/www/cicd-site

---

Шаг 8. Настраиваем GitHub Actions (CI/CD)

📍 В GitHub

Что такое GitHub Actions

Это встроенный механизм GitHub, который:

• реагирует на изменения кода
• выполняет команды автоматически

---

8.1 Создай файл CI/CD

В репозитории:

1. Add file → Create new file
2. Название:

.github/workflows/deploy.yml

---

8.2 Вставь конфигурацию

name: Deploy to Vultr

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3

    - name: Copy files to server
      uses: appleboy/scp-action@v0.1.3
      with:
        host: ${{ secrets.SERVER_IP }}
        username: root
        key: ${{ secrets.SSH_KEY }}
        source: "."
        target: "/var/www/cicd-site"

---

Шаг 9. Добавляем секреты

📍 В GitHub

1. Settings → Secrets → Actions
2. Добавь:
   • SERVER_IP — IP сервера
   • SSH_KEY — приватный SSH-ключ

👉 Это безопасный способ хранить данные.

---

Шаг 10. Запускаем сайт

📍 На сервере

cd /var/www/cicd-site
node index.js

Открой в браузере:

http://IP_СЕРВЕРА:3000

🎉 Сайт работает!

---

Шаг 11. Проверяем CI/CD

1. Измени текст в index.js
2. Загрузи файл в GitHub
3. GitHub Actions запустится автоматически
4. Код обновится на сервере

👉 Это и есть CI/CD

---

Что ты понял после этой статьи

• что такое CI/CD на практике
• как связаны GitHub, сервер и код
• как выглядит реальный автодеплой
• что это не магия, а цепочка шагов