Перейти к содержанию

Установка и настройка

Подготовка

Доменное имя

Для завершения установки Вам потребуется доменное имя с установленной Wildcard DNS записью, указывающей на IP адрес сервера. Установить данную запись, как правило, можно прямо у регистратора домена. В качестве альтернативы можно воспользоваться сторонними сервисами, вроде Cloudflare, Amazon Route 53 и пр.

Предполагается, что с момента указания DNS записи прошло по крайней мере 24 часа.

Сервер

CPU: В качестве сервера для CapRover подойдёт любая машина на базе CPU AMD64 (X86), ARM64, и ARMV7.

Оперативная память: Стоит учесть внимание, что для полноценной работы Docker может не хватить 512 МБ RAM (см. следующий топик). Минимальный объём RAM памяти для установки CapRover - 1 ГБ. Рекомендованный объём - 4 ГБ и выше. Чем больше Вы планируете устанавливать приложений, тем выше должно быть это значение.

Система и Docker: Работоспособность CapRover тестировалась на Ubuntu 18.04 с использованием Docker 19.03. Если Вы планируете использовать CapRover на другой OC рекомендуется обратиться к Документации Docker.

Ubuntu 20.04

На данной версии OC существует сразу несколько проблем, связанных с Docker (см. этот пример) или этот. В связи с этим рекомендуется использовать Ubuntu 18.04.

Избегайте snap версии Docker

Данный способ установки известен большим количеством багов. Ни в коем случае не используйте snap версию Docker, если хотите избежать проблем в работе CapRover!

Фаервол

Перед установкой CapRover убедитесь, что Ваш фаервол не блокирует необходимые порты. Для этого можно воспользоваться командой

sudo ufw allow 80,443,3000,996,7946,4789,2377/tcp
sudo ufw allow 7946,4789,2377/udp

Шаг 1: Установка CapRover

Быстрая установка

CapRover доступен в маркетплейсе DigitalOcean в качестве "One-click app". Данный способ установки является рекомендованным, так как полностью исключает подготовку и непосредственно саму установку CapRover на сервер.

Для установки CapRover просто запустите следующую команду:

docker run -p 80:80 -p 443:443 -p 3000:3000 -v /var/run/docker.sock:/var/run/docker.sock -v /captain:/captain caprover/caprover

После того, как CapRover будет установлен и автоматически запущен, Вы можете посетить Панель управления по адресу http://[IP_ВАШЕГО_СЕРВЕРА]:3000. По умолчанию пароль для доступа captain42, но Вы можете изменить его позднее.

caprover-dashboard.png

Преждевременная настройка

Не изменяйте настройки в Панели управления сразу. Мы будем использовать терминал для первичной настройки сервера.

Шаг 2: Соединение с доменом

Предположим, что у Вас есть домен example.ru. Вы можете установить *.example.ru в качестве DNS записи, указывающей на публичный IP адрес сервера. Учтите, что обновление DNS записей происходит в течение 24 часов. Если Вы попытаетесь произвести первичную настройку, описанную в Шаге 3, раньше этого срока, скорее всего у Вас ничего не выйдет.

Чтобы подтвердить DNS запись можно воспользоваться следующим сервисом и указать что-то вроде caprover.example.ru. Если в выводе отобразится IP адрес сервера, Вы всё сделали правильно.

Шаг 3: Установка CapRover CLI

Для следующего шага понадобится локальный компьютер (ноутбук, домашний ПК). Если Вы используете OC на базе Linux, то у Вас уже есть все необходимые зависимости. Необходимо только запустить команду:

sudo npm install -g caprover

А затем следующую команду:

caprover serversetup

Программа установки задаст Вам несколько вопросов. Стандартный вывод будет выглядеть следующим образом:

Setup CapRover machine on your server...

? have you already started CapRover container on your server? Yes
? IP address of your server: [Ваш IP адрес]
? CapRover server root domain: [example.ru]
? new CapRover password (min 8 characters): [пароль]
? enter new CapRover password again: [пароль]
? "valid" email address to get certificate and enable HTTPS: [ваш_email@email.com]
? CapRover machine name, with whom the login credentials are stored locally: [ЛюбоеИмяДляВашегоСервера]

CapRover server setup completed: it is available as [ЛюбоеИмяДляВашегоСервера] at https://captain.[yourDomainName].com

For more details and docs see CapRover.com

Преждевременная настройка

Если Вы ужн форсировали https соединение для CapRover, команда caprover setup не сможет завершить настройку. В таком случае Вы можете воспользоваться командой caprover login и изменить пароль в панели управления.

Шаг 4 (Необязательный): Настройка Swap

В ряде случаев Вы можете столкнуться с проблемами, возникшими из-за нехватки оперативной памяти. Например, может прерываться сборка Docker образа. Чтобы избежать данной ситуации (без покупки дополнительной RAM) можно установить Swap файл. Вы можете воспользоваться следующим гайдом для этого.

Шаг 5: Развертывание тестового приложения

Зайдите в Панель управления CapRover, меню Apps. Создайте Ваше первое приложение, назвав его caprover-test. Далее скачайте одно из тестовых приложений в формате tar архива отсюда.

В Панели управления CapRover зайдите в приложение, далее перейдите на вкладку Deployment. Найдите на странице второй метод и прикрепите скачанный ранее архив. Нажмите на кнопку Upload & Deploy.

test-app-deploy.png

После окончания сборки, Вы можете проверить работоспособность приложения, перейдя на страницу в формате caprover-test.example.ru, где example.ru - указанный ранее Ваш домен.

Поздравляем! Вы успешно установили CapRover, проверили его работу и готовы приступить к установке полноценных приложений.