День 0 · установка · README.md

День 0 — подготовка рабочего места

Делается до старта программы, занимает 1–2 часа. Если что-то не получится, останется время разобраться спокойно.

Задача одна: получить виртуальную машину с Linux, внутри которой вы будете работать всю программу и на которой можно ломать что угодно.

Что такое виртуальная машина

Программа, которая изображает компьютер внутри вашего компьютера. У неё свой процессор (кусочек вашего), своя память, свой диск — файл на вашем диске. Внутри работает настоящая операционная система, которая не знает, что она не на железе.

Зачем это нужно именно нам:

• Ломать не страшно. Вы делаете снапшот — снимок состояния — и в любой момент возвращаетесь к нему. Испортили систему? Откатились за минуту.
• Ваш ноутбук не пострадает. Что бы ни случилось внутри, снаружи ничего не меняется.
• Это настоящий Linux. Не эмуляция, не «почти». Всё, что вы научитесь делать здесь, работает на боевых серверах ровно так же.

Работать вы будете прямо в окне виртуальной машины. Внутри — обычный рабочий стол: браузер, файловый менеджер, терминал. Никаких дополнительных подключений настраивать не надо.

Требования к ноутбуку

Виртуальной машине мы отдадим 4 ГБ памяти — графическому рабочему столу нужно больше, чем системе без графики. Остальное остаётся вашему ноутбуку.

Как посмотреть, сколько у вас памяти:

• Windows: Ctrl+Shift+Esc → «Производительность» → «Память»
• macOS: меню Apple → «Об этом Mac»
• Linux: в терминале free -h

Если памяти 4 ГБ — скажите об этом заранее, до старта.

Выберите свой путь

Читайте только свой файл. Чужой не нужен и только запутает.

Как узнать, какой у вас Mac: меню Apple → «Об этом Mac». Написано «Чип Apple M…» — это Apple Silicon. «Процессор Intel» — Intel.

На Apple Silicon VirtualBox не работает — там другая архитектура процессора. Для M-чипов берём UTM, он делает то же самое.

После установки — общая часть для всех

Когда рабочий стол внутри виртуалки загрузился, всем без исключения нужно проделать одно и то же: разобраться с паролями, завести своего пользователя, поставить тренажёр и сделать снапшот.

Это вынесено в отдельный файл: after-install.md

Не пропускайте. Там же объясняется, почему нельзя оставлять пароли, с которыми приехал скачанный образ.

Go и редактор

Когда тренажёр установлен, поставьте Go и инструменты — одной командой из поставки курса:

sudo bash /opt/course/docs/setup/prepare.sh

Скрипт ставит Go, языковой сервер, отладчик и линтер ровно тех версий, на которые рассчитаны проверки. Работает несколько минут, в конце печатает версии и строку Готово.

Затем настройте редактор: ide.md.

Как понять, что всё готово

Внутри виртуальной машины откройте терминал и выполните:

uname -a

В ответ приходит строка, начинающаяся со слова Linux:

Linux lab 6.8.0-45-generic #45-Ubuntu SMP x86_64 GNU/Linux

Затем:

course status

Показался список учебных дней. И последнее:

course doctor

Все строки с ✔, в том числе Go: go1.27.1, gopls, dlv, golangci-lint, — день 0 пройден, можно начинать.

Если не получилось

1. Загляните в troubleshooting.md — типовые проблемы установки, отсортированные по частоте. Ошибки вроде VT-x is not available разбираются в первых строках.
2. Скопируйте точный текст ошибки — не пересказывайте. Половина проблем узнаётся по одной строке, а по пересказу не узнаётся никогда.
3. Если не помогло — опишите проблему по форме из конца troubleshooting и попросите помощи.

Установка — единственная часть программы, где можно и нужно сразу просить помощи. Дальше будет правило двадцати минут, но сегодня оно не действует.