👋 Welcome

Привет, Эльбрусовец!

Поздравляю, ты прошёл(-ла) непростой путь и уже в понедельник начнётся твой путь самурая в Эльбрус Буткемп. Давай разберёмся с тем, что тебе необходимо сделать, чтобы быть во всеоружии к старту обучения:

⚙️ Настройка рабочего окружения

1. 💻 Подготовка операционной системы

✅ Если у тебя macOS — пропусти этот шаг, дополнительная настройка не требуется.

✅ Если у тебя Windows — для веб-разработки эта система полностью подходит: Git, Node.js, VS Code, браузеры и типичный стек фронтенда/бэкенда на ней работают так же нормально, как на macOS или Linux. Переходить на другую ОС не обязательно.

В индустрии часто встречаются и Unix-подобные системы, но это не требование для старта: ориентируйся на удобство и инструкции курса.

🪟 Для пользователей Windows

Работай в привычной Windows: устанавливай инструменты из следующих пунктов README (Git, Node.js, VS Code и т.д.) — этого достаточно для веб-разработки.

По желанию — WSL (Windows Subsystem for Linux)
Если в заданиях удобнее повторять команды в среде, близкой к Linux-серверу, или хочется привыкнуть к bash в том виде, как на продакшене, можно поставить WSL. Это Linux-окружение внутри Windows, без виртуальных машин и смены основной системы.

Установка WSL:

1. Откройте PowerShell или командную строку от имени администратора
2. Выполните команду:

   wsl --install
   

3. Перезагрузите компьютер
4. После перезагрузки Ubuntu установится автоматически

📑 Официальная документация Microsoft по установке WSL

📚 Дополнительные материалы (если пользуешься WSL)

• 📽 Основы Ubuntu
• 🎓 Введение в Linux

2. 🔀 Git

2.1 📖 Что такое Git?

Это система контроля версий. Вам она понадобится с первого дня работы. Работа с git-командами через терминал - это тот навык, который вам будет полезен. Но сначала будет достаточно уметь применять ряд простых команд и сценариев работы.

2.2 💾 Установка Git

При чистой установке Ubuntu 22.04 git по умолчанию не поставляется, как и для macOS.
Можно проверить это в терминале (сочетание клавиш для Linux Ctrl + Alt + T, на macOS - ищите Terminal (но рекомендуем установить iTerm2 и использовать его) через Spotlight): напишите в новом окне git. Если терминал вам говорит, что такого пакета нет - идём его устанавливать.
Следуйте инструкции для вашей ОС (в случае macOS можно выбрать любой вариант, но Homebrew потребуется вам в будущем).

3. 🐙 GitHub

3.1 📖 Что такое GitHub?

🎥 Видео по GitHub и настройке доступа

GitHub - это система управления версиями с социальной составляющей. В соцсети вы выкладываете фотографии, а тут исходный код. Это ещё и самая большая площадка для opensource проектов. Веб-сервис основан на системе контроля версий Git. Ну и конечно, вы можете сделать свою GitHub страницу своим резюме.

3.2 🔐 Настройка доступа по SSH

Для начала настроим доступ к репозиториям аккаунта.

🐧 Пример для Linux (Ubuntu)

• откройте терминал (Ctrl + Alt + T) на своём компьютере и выполните ряд команд
  • обновление списков пакетов для обновлений
  • установка пакета ssh

  sudo apt update    
  sudo apt-get install ssh    
  

🪟 Пример для Windows (10 и 11)

• откройте Терминал Windows или Windows PowerShell: меню «Пуск» → введите Терминал или PowerShell → запустите приложение (удобнее установить Windows Terminal из Microsoft Store и использовать его дальше).
• проверьте, есть ли уже клиент SSH, выполнив в окне:

  ssh -V
  

  если версия выводится — можно переходить к генерации ключей (шаг ниже). Если команда не найдена — включите компонент OpenSSH-клиент:
  • Через настройки: «Параметры» → «Приложения» → «Дополнительные компоненты» → «Добавить компонент» → найдите OpenSSH-клиент → «Установить».
  • Через PowerShell от имени администратора (правый клик по «Терминал» / «PowerShell» → «Запуск от имени администратора»):

  Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
  

  после установки закройте и снова откройте терминал и снова выполните ssh -V.
• сгенерируйте пару ключей (ed25519 — это крипто-схема), подставив свою почту GitHub:

  ssh-keygen -t ed25519 -C "подставь сюда свою почту, на которую регистрировался github и кавычки оставь"
  

  • три раза нажмите Enter (оставить путь по умолчанию и пустую passphrase — так проще для начала).
• папка с ключами: C:\Users\ВАШ_ЛОГИН\.ssh (в Проводнике включите отображение скрытых элементов: вкладка «Вид» → «Показать» → «Скрытые элементы»).
• чтобы вывести публичный ключ в терминале: в PowerShell — Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub, в cmd — type %USERPROFILE%\.ssh\id_ed25519.pub; в PowerShell можно сразу скопировать в буфер: Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard (дальше вставьте ключ на GitHub, как в абзацах ниже).

🍎 Для macOS начинайте отсюда

• далее мы запустим команды для генерации собственных SSH-ключей (ed25519 - это крипто-схема)

  ssh-keygen -t ed25519 -C "подставь сюда свою почту, на которую регистрировался github и кавычки оставь"
  

  • нажми на Enter три раза (так проще, заполнять ответы/фразы не обязательно)

Теперь в корневой папке твоего компьютера есть скрытая папка .ssh (на Mac Command+Shift+.), внутри лежат два файла id_ed25519 и id_ed25519.pub. Первый - твой приватный ключ устройства, второй - публичный, его мы и будем использовать в качестве ключа на странице добавления публичных ключей в аккаунт GitHub.

• можно запустить команду чтения содержимого файла cat .ssh/id_ed25519.pub,
• выделить и скопировать из терминала через сочетание клавиш Ctrl+Shift+C, содержимое публичного ключа (на Mac просто Command+C)
• копируем всю строку от включительно ssh-ed25519 ... и до ... ваша@почта.com включительно
• пора скопировать ключ на GitHub
• название Title можно задать любое, обычно такое, чтобы вам было понятно, о ключе с какого компьютера идёт речь

3.3 ✅ Проверка настройки SSH или твой первый Fork

Когда ваша система уже настроена, получен и подключён SSH-ключ, вам ничего не мешает создать копию этого репозитория у себя в аккаунте. Нужно лишь нажать на кнопку Fork сверху справа на главной странице репозитория - https://github.com/Elbrus-DataScience/starter_pack

Теперь можно перейти на свою страницу с репозиториями https://github.com/USER?tab=repositories, здесь и далее USER – ваш ник в GitHub. Второй вариант - вы кликаете на фото профиля в правом верхнем углу и переходите во вкладку Your profile или Your repositories для доступа к странице аккаунта и репозиториев соответственно.

• переходим на страницу вашего форка (в поле ввода браузера должно быть https://github.com/USER/starter_pack)
• здесь нажимаем на зелёную кнопку Code
• выбираем вкладку SSH
• копируем ссылку на репозиторий (она должна быть такого вида: git@github.com:USER/starter-pack.git)

3.4 📚 Дополнительные материалы

📑 Инструкция по генерации ключа SSH
📑 Статья про fork на GitHub

4. 🟢 Node.js (LTS)

4.1 📖 Зачем нужен Node.js

Node.js — среда выполнения JavaScript вне браузера. Она нужна для инструментов разработки (линтеры, сборщики, тесты), части экосистемы фронтенда и многих учебных материалов. Для буткемпа важно иметь стабильную LTS-версию (Long-Term Support): она дольше получает исправления безопасности и реже ломает совместимость с проектами.

Актуальную ветку LTS и номер версии смотри на главной странице nodejs.org — там по умолчанию предлагается именно LTS.

4.2 💾 Установка и рекомендации по ОС

Общие ссылки

• Скачать Node.js (официальный сайт) — выбери LTS, затем свой тип установщика (Windows / macOS / исходники).
• Установка через пакетные менеджеры — варианты для apt, brew, chocolatey, winget и др.

🪟 Windows (нативно)

• Самый простой путь: с страницы загрузки скачай Windows Installer (.msi) для LTS и пройди мастер установки (можно оставить опцию добавления в PATH включённой).
• Альтернатива для переключения версий: nvm-windows — удобно, если позже понадобятся разные версии Node.

🐧 Linux (Ubuntu / WSL)

• Удобно для разработки: nvm — ставишь LTS командой вроде nvm install --lts и nvm use --lts (инструкции в README репозитория nvm).
• Либо системный пакет: следуй разделу для своего дистрибутива на nodejs.org — package manager (часто через репозиторий NodeSource или аналог — так ты получаешь конкретную LTS без сюрпризов от устаревшего apt-пакета в старых образах).

🍎 macOS

• Официальный macOS Installer (.pkg) с nodejs.org/en/download для LTS.
• Если уже пользуешься Homebrew: на странице package manager есть команда для brew; для фиксации именно LTS ориентируйся на актуальную формулу/версию в документации Homebrew.
• Для нескольких версий Node на одной машине: nvm или fnm.

4.3 ✅ Проверка

В терминале выполни:

node -v
npm -v

Должны отобразиться номера версий; у node это должна быть текущая LTS (сверь с сайтом nodejs.org).

5. 💻 VS Code

5.1 📖 Что такое VS Code?

Visual Studio Code (VS Code) — это редактор кода для разных языков программирования.
В нём можно писать, форматировать и редактировать код на разных языках.
Это будет нашим основным инструментом, где мы будем писать код и делать проекты.

5.2 💾 Установка VS Code

• Переходим на сайт
• Скачиваем пакет в зависимости от нужной ОС. Для Linux (Ubuntu/WSL) выбираем пакет .deb
• Устанавливаем

5.3 ⚙️ Оптимизация работы в VS Code

5.3.1 💾 Автосохранение

Откройте VS Code и пройдите по пути Files -> Auto Save.
Измените значение с «Off» на «afterDelay», задайте промежуток времени — и файлы будут автоматически сохраняться в заданный промежуток.

5.3.2 🔌 Расширения

Jupyter

Расширение позволяет работать с файлами формата .ipynb
ссылка на установку

Python Environment Manager

Расширение предоставляет удобный менеджер просмотра всех созданных окружений в Python
ссылка на установку

📚 Дополнительные материалы

• Подробное руководство по VS Code
• 10 рекомендаций для новичков по ускорению работы в VS Code

✅ Итог

На этом установка необходимого ПО завершена. Необходимо переходить к инструкциям по настройке VS Code и использованию GitHub