Основы · 1
Docker — единственная программа, которая нужна HERON. На этой странице мы поставим его на macOS, Windows или Linux, проверим двумя командами и разберём проблемы, которые встречаются чаще всего.
Выберите свою систему ниже и пройдите только её часть. Это десять–двадцать минут, и большую часть времени вы ждёте загрузку.
Docker запускает программы в контейнере — закрытой коробке, где лежит программа и всё, что ей нужно. HERON поставляется такой коробкой, она называется образ. Вы не устанавливаете сам HERON, вы просите Docker запустить образ HERON, и он работает одинаково на MacBook, ноутбуке с Windows и сервере на Linux.
Бытовое сравнение: образ — это запечатанный ланч-бокс. Docker — микроволновка, которая греет любой ланч-бокс одинаково. Как готовили еду, знать не нужно.
Когда нужна эта страница: перед первым сайтом. Когда можно пропустить: если docker --version в терминале уже печатает версию.
Терминал — это приложение «Терминал». Оно уже есть на вашем Mac.
терминал или terminal, нажмите Enter.% или $. Здесь набирают команды.В Windows HERON работает внутри WSL — терминала Linux, встроенного в Windows. Он ставится вместе с Docker ниже.
powershell, для установки выберите «Запуск от имени администратора».Где ваш терминал, вы уже знаете: обычно Ctrl, Alt и T.
sudo: они спрашивают пароль и выполняются от администратора. Пароль при вводе не виден — так и должно быть.wsl --install и перезагрузите компьютер. После перезагрузки окно Ubuntu попросит имя пользователя и пароль: придумайте любые, они только для этого Linux.Установка Docker Engine официальным скриптом:
curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh
Чтобы ваш пользователь запускал Docker без sudo:
sudo groupadd -f docker && sudo usermod -aG docker $USER && newgrp docker
Группа docker даёт те же права, что у администратора. На своём компьютере и на сервере, которым пользуетесь только вы, это нормально.
Две команды. Скопируйте их в терминал по одной.
docker --version
Вы увидите Docker version и номер. Номер не важен, важно, что ответ есть.
docker run --rm hello-world
Docker скачает крошечный тестовый образ и напечатает «Hello from Docker!» с несколькими строками пояснений. --rm удаляет тестовую коробку после запуска, так что ничего не остаётся. Видите приветствие — всё готово.
Точно так же Docker запускает HERON. Эта команда скачивает стабильный образ HERON и печатает его версию:
docker run --rm ghcr.io/fmstm/heron:prod --version
В первый раз образ скачивается около минуты. Дальше запуск мгновенный. Чтобы создать первый сайт и настроить короткую команду heron, переходите к странице С чего начать.
Docker установлен, но не запущен.
sudo systemctl start docker, а чтобы он стартовал вместе с компьютером — sudo systemctl enable docker.Только Linux: ваш пользователь ещё не в группе docker.
groups должна показать docker.Windows иногда пишет, что WSL 2 или виртуализация недоступны.
wsl --install.Docker Desktop резервирует память под свою коробку с Linux.
Другие проблемы, включая ошибки сборки, — на странице Если что-то пошло не так.
Docker Desktop бесплатен для личного использования, обучения, открытых проектов и небольших компаний. Крупным компаниям нужна платная подписка Docker. Docker Engine на Linux бесплатен для всех.
Да, с Python 3.12 или новее: pip install git+https://github.com/FMSTM/HERON.git@prod. См. другие способы запуска HERON.
Он ставит одну программу и хранит образы в своём хранилище. HERON видит только папку, в которой его запустили. Удаление Docker убирает всё, что он скачал.
Выберите текстовый редактор, затем создайте первый сайт на странице С чего начать.