Урок 1. Начало работы: вход на сайт

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

Консоль — это программа, в которую вводят текстовые команды, чтобы указать компьютеру, что нужно сделать. В разных операционных системах она может называться по-разному: командная строка в Windows или терминал в macOS и Linux.

Как открыть консоль:

• Windows Откройте поиск или меню Пуск, введите cmd, нажмите на приложение правой кнопкой мыши и выберите Запуск от имени администратора.
• macOS Нажмите Command + Пробел, введите Терминал и нажмите Enter.
• Linux Нажмите Ctrl + Alt + T.

Команды для консоли будут оформлены отдельными блоками. Например:

   # перейдите в папку сайта
   cd /opt/www/
   

Строки, которые начинаются с #, — пояснения. Их не нужно вводить в консоль.

Остальные строки — команды. Когда дойдете до них, скопируйте команду, вставьте ее в консоль и нажмите Enter. Дождитесь, пока выполнится одна команда, и только потом переходите к следующей.

1. Установите Docker для демосайта

Установка зависит от операционной системы. Для Windows и macOS нужно приложение Docker Desktop. В Linux Docker устанавливается через консоль.

Если у вас Windows или macOS

Перейдите на официальный сайт Docker Desktop, скачайте установщик для своей операционной системы и запустите его.

Если у вас Windows, установщик спросит, делать ли Docker доступным для всех учетных записей на компьютере или только для текущего пользователя. Для учебной установки подходит вариант All-users.

Сразу после открытия Docker попросит согласиться с правилами использования — нажмите Accept. Без этого программа закроется.

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

Затем Docker предложит зарегистрироваться. Нажмите Skip. Для установки демосайта аккаунт не нужен.

Для работы Docker Desktop на Windows обычно используется WSL — встроенная подсистема Linux. Если Docker попросит обновить WSL, откройте консоль, выполните команду wsl --update, дождитесь завершения и перезапустите Docker Desktop.

Если у вас Linux

Откройте консоль и по очереди выполните две команды. Система может один раз попросить ваш пароль от компьютера.

   # скачайте и установите Docker
   curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh
   # разрешите запуск последующих команд без постоянного ввода sudo
   sudo usermod -aG docker $USER && newgrp docker
   

После выполнения команд Docker будет готов к работе.

2. Скачайте файлы демосайта

1. Откройте репозиторий с файлами на GitHub.
2. Найдите зеленую кнопку Code. Она находится в правой верхней части списка файлов.
3. В выпадающем меню нажмите самую нижнюю строчку Download ZIP.

4. Распакуйте скачанный архив. В нем вы увидите папку env-docker-main.
5. Создайте на рабочем столе папку my-bitrix-site и переместите в нее скачанную папку env-docker-main.

3. Настройте пароли базы данных демосайта

Сайту нужно хранить информацию — для этого используется база данных.

Внутри папки env-docker-main есть два файла: .env_sql и .env_push.

Имена этих файлов начинаются с точки, поэтому в macOS и Linux они могут быть скрыты.

Чтобы их отобразить:

• в macOS нажмите Command + Shift + точка
• в Linux нажмите Ctrl + H

Если все на месте, переходите к настройке паролей.

1. Откройте файл .env_sql в блокноте. Внутри будут строки:

   
      MYSQL_ROOT_PASSWORD="CHANGE_MYSQL_ROOT_PASSWORD_HERE"
      POSTGRES_PASSWORD="CHANGE_POSTGRESQL_POSTGRES_PASSWORD_HERE"
      

   Замените текст внутри кавычек на свои пароли. Кавычки оставьте:

   
      MYSQL_ROOT_PASSWORD="MyPassword123"
      POSTGRES_PASSWORD="AnotherPassword456"
      

   Пароль для базы данных MySQL понадобится при установке демоверсии.

2. Откройте файл .env_push и придумайте секретный ключ.

   
      PUSH_SECURITY_KEY=CHANGE_SECURITY_KEY_HERE
      

   Ключ нужен для безопасного обмена данными между сайтом и сервером, где он работает. Используйте только латинские буквы и цифры.

4. Откройте папку демосайта в консоли

Если консоль закрыта, откройте ее снова и перейдите в папку env-docker-main. Для этого введите cd, пробел и путь к папке.

Чтобы узнать путь, откройте папку env-docker-main и посмотрите на адресную строку в верхней части окна. В Windows и Linux кликните по пустому месту в адресной строке: появится полный путь, который можно выделить и скопировать. В macOS нажмите на папку правой кнопкой мыши, зажмите Option и выберите Скопировать путь до....

В Windows команда будет выглядеть так:

   cd C:\Users\Username\Desktop\my-bitrix-site\env-docker-main
   

5. Запустите контейнеры демосайта

Когда окажетесь в папке env-docker-main, выполните команду:

   docker compose up -d
   

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

Если команда завершилась с ошибкой, закройте и снова откройте консоль. Перейдите в папку env-docker-main и еще раз выполните команду запуска контейнеров.

6. Скачайте установщик bitrixsetup.php

Теперь нужно загрузить файл bitrixsetup.php, который запустит установку.

В консоли выполните команды:

   # войдите внутрь контейнера под пользователем bitrix
   docker compose exec --user=bitrix php sh
   # перейдите в папку сайта
   cd /opt/www/
   # скачайте файл для установки продукта
   wget https://www.1c-bitrix.ru/download/scripts/bitrixsetup.php
   

7. Запустите установку демоверсии

Откройте браузер и перейдите по адресу:

   http://localhost:8588/bitrixsetup.php
   

Если все сделано правильно, откроется мастер установки. Выберите демонстрационную версию продукта 1С-Битрикс: Управление сайтом редакции Бизнес. После этого начнется загрузка и распаковка необходимых файлов и программ.

8. Завершите установку демоверсии

После распаковки откроется мастер установки.

• На первом шаге ничего выбирать не нужно. Нажмите Далее.
• На следующем экране примите лицензионное соглашение.
• На странице регистрации продукта снимите галочку в поле Я хочу зарегистрировать свою копию продукта и нажмите Далее.
• В окне предварительной проверки посмотрите результаты и нажмите Далее.

• На шаге настройки базы данных укажите параметры.

  Параметры базы данных

  • Сервер: mysql
  • Пользователь базы данных: новый
  • Имя пользователя: произвольное имя, например user
  • Пароль: произвольный пароль пользователя для доступа к базе данных
  • База данных: новая
  • Новая база данных: имя создаваемой базы данных, например sitemanager

  Параметры администратора базы данных

  • Логин: root
  • Пароль: тот, который вы придумали и записали в .env_sql
  
• Дождитесь установки продукта.
• Создайте администратора сайта: укажите произвольные логин, пароль, почту, имя и фамилию. Затем нажмите Далее.
  
• В окне выбора решения выберите Интернет-магазин.
• Затем мастер предложит выбрать шаблон, цвет темы, название сайта, логотип, типы плательщиков, способы оплаты и доставки. Для учебного сайта можно оставить значения по умолчанию и нажимать Далее.
• Дождитесь завершения установки решения. Когда появится кнопка Перейти на сайт, нажмите ее.

Демосайт готов

Установка демосайта завершена.