Быстрый старт приложения

Быстрый старт приложения

По этому руководству вы развернёте приложение на Lizard (lizard.build) за несколько минут. Установите Lizard CLI, войдите в систему, начните 7-дневный пробный период Pro, затем выполните lizard add -r owner/repo для репозитория GitHub или lizard up для локальной папки. Lizard собирает приложение на своих серверах, без локального Docker, и выдает HTTPS-адрес на onlizard.com. Аккаунт создается при первом запуске lizard login.

1. Установите CLI

На macOS или Linux запустите скрипт установки:

curl -fsSL https://lizard.build/install.sh | bash

Скрипт кладет бинарный файл lizard в ~/.lizard/bin, добавляет эту папку в PATH через ~/.zshrc или ~/.bashrc и создает ссылку на lizard в папке, которая уже есть в PATH, поэтому команда сразу работает в этом терминале. Дальше бинарный файл обновляется сам, кроме CI. Если скрипт пишет, что lizard может быть не найден, откройте новый терминал. Проверьте версию:

lizard --version

На Windows выполните в PowerShell:

irm https://lizard.build/api/cli/install.ps1 | iex

Или установите из npm (нужен Node.js 18+):

npm install -g @lizard-build/cli

Не используйте npx. Всегда используйте глобально установленный бинарный файл lizard. Запуск npx @lizard-build/cli загружает временную копию, версия которой может отличаться от платформы. Чтобы позже обновить установку из npm, выполните npm install -g @lizard-build/cli@latest.

Ошибки прав доступа (EACCES)? Не используйте sudo. Используйте скрипт установки выше, ему не нужны права администратора, или укажите npm пользовательский префикс:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm install -g @lizard-build/cli

2. Войдите в систему

lizard login

Откроется браузер для аутентификации, затем вы вернетесь в терминал после подтверждения. В CI или других неинтерактивных средах аутентифицируйтесь с токеном:

export LIZARD_TOKEN=liz_xxx
# or
lizard login --token liz_xxx

API-ключи начинаются с liz_. Создайте ключ командой lizard keys create <name>. LIZARD_API_KEY работает вместо LIZARD_TOKEN.

Проверьте, под кем вы вошли, в любой момент:

lizard whoami

3. Начните пробный период Pro

У нового аккаунта нет тарифа, поэтому при создании чего-либо возвращается HTTP 402 со ссылкой на Checkout. Сначала начните 7-дневный пробный период Pro:

lizard billing start

Откроется Stripe Checkout, где вы добавляете карту. Пробный период включает использование ресурсов на $5. До его окончания Lizard ничего не списывает. См. Оплата и lizard billing.

4. Разверните

Выберите способ в зависимости от того, где находится ваш код.

Вариант А — Развертывание репозитория GitHub (рекомендуется)

Если ваш код на GitHub, создайте сервис прямо из репозитория. Lizard клонирует его, автоматически определит стек, соберет и вернет рабочий URL:

lizard add -r your-org/your-app

Пуши в отслеживаемую ветку будут автоматически переразвертывать приложение. Для приватных репозиториев сначала подключите GitHub App через lizard git:

lizard git connect

Вариант Б — Развертывание локального кода

Изнутри директории проекта загрузите и разверните текущую папку (с учетом .gitignore):

lizard up

Если директория еще не привязана к проекту, up создаст или выберет его интерактивно. В CI сначала привяжите явно с помощью lizard init --name my-project.

В любом случае, когда сборка завершится, вы получите сгенерированный URL вроде https://your-app-x1y2z.onlizard.com.

Lizard сам определяет большинство стеков. Команды сборки и запуска, а также порт для вашего фреймворка см. в руководстве по Next.js, React, Vue, Astro, SvelteKit, Node.js, Django, FastAPI, Rails или Go. Приложение со своим Dockerfile разворачивайте по руководству Развертывание с Dockerfile.

5. Следите за сборкой и работой

lizard ps          # services in the project, with status + URL
lizard logs        # last runtime log lines
lizard logs --build  # the most recent build's logs
lizard open        # open the project in the dashboard

lizard open показывает тот же проект в дашборде. Метрики, стоимость и историю деплоев см. в разделе Наблюдаемость.

6. Добавьте базу данных (по желанию)

Создайте Managed Postgres и подключите его к сервису:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service your-app
lizard redeploy --service your-app

Ссылка ${{postgres.DATABASE_PRIVATE_URL}} разрешается во время развертывания и подключается через приватную сеть проекта. Она соответствует текущему имени аддона, поэтому обновите ссылку, если переименуете аддон. Учетные данные сами не ротируются; сервис получает новые значения при следующем развертывании. См. Управляемые аддоны.

Дальнейшие шаги

Стоимость хостинга

Pro стоит $19 в месяц, и в него входят $19 месячных кредитов. Расход сверх этого оплачивается по модели pay as you go по опубликованным ставкам. Pro начинается с 7-дневного пробного периода и $5 пробных кредитов; чтобы начать его, вы добавляете карту. См. Оплата и цены, а перед развёртыванием проверьте свои лимиты.

ВведениеУстановить Lizard Studio

Обновлено