Astro Studio
Веб-портал Astro Studio позволяет вам подключаться и управлять вашими удаленными базами данных Astro DB через веб-интерфейс или с использованием CLI-команд.
Из вашей панели управления Studio у вас есть доступ к управлению учетной записью, справочным статьям и консоли сообщений поддержки.
Посетите Astro Studio, чтобы зарегистрироваться или войти в систему.
Создание нового проекта Studio
Заголовок раздела Создание нового проекта StudioСуществует два способа создания проекта в Astro Studio:
-
Использовать веб-интерфейс Astro Studio для создания из нового или существующего репозитория GitHub.
Чтобы начать, нажмите кнопку “create project” в заголовке и следуйте инструкциям. Astro Studio подключится к вашему репозиторию GitHub и создаст новую хостинговую базу данных для вашего проекта.
-
Использовать Astro Studio CLI для создания из любого локального проекта Astro. Для начала можно выполнить следующие команды:
После того как вы вошли в систему и успешно подключились, вы можете выполнять все команды Astro DB для управления удаленной базой данных.
О всех доступных командах см. в справочнике Astro DB CLI.
Развёртывание с подключением к Studio
Заголовок раздела Развёртывание с подключением к StudioВы можете развернуть свой проект Astro DB с живым подключением к вашей базе данных Studio. Это возможно на любой платформе развёртывания с использованием статических сборок или адаптера SSR.
Сначала настройте свою команду сборки для подключения к Studio с использованием флага --remote
. В этом примере флаг применяется к скрипту "build"
в файле package.json
вашего проекта. Если ваша платформа развёртывания принимает команду сборки, убедитесь, что она установлена на npm run build
.
Создание токена приложения Studio
Заголовок раздела Создание токена приложения StudioДля доступа к вашей базе данных Studio из продакшн-развёртывания вам нужно создать токен приложения. Вы можете создать токен приложения на панели управления вашего проекта Studio, перейдя на вкладку Settings и выбрав Tokens.
Скопируйте сгенерированный токен и примените его в качестве переменной окружения / секрета окружения на вашей платформе развёртывания, используя имя ASTRO_STUDIO_APP_TOKEN
.
Настройте действие GitHub CI
Заголовок раздела Настройте действие GitHub CIВы можете автоматически отправлять изменения схемы в вашу базу данных Studio с использованием действия Studio CI. Это позволит убедиться, что изменения могут быть внесены безопасно, и поддерживать конфигурацию в актуальном состоянии при каждом слиянии с main
.
Следуйте документации GitHub, чтобы настроить новый секрет в вашем репозитории с именем ASTRO_STUDIO_APP_TOKEN
и вашим токеном приложения Studio в качестве значения секрета.
После того как секрет настроен, создайте новый файл рабочего процесса GitHub Actions в директории проекта .github/workflows
для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие withastro/action-studio
для синхронизации изменений схемы.
После настройки секрета создайте новый файл рабочего процесса GitHub Actions в директории проекта .github/workflows
для проверки репозитория и установки Node.js в качестве шагов, а также используйте действие withastro/action-studio
для синхронизации изменений схемы.
Действие запустит astro db verify
на всех событиях-триггерах, чтобы убедиться, что изменения схемы могут быть применены безопасно. Если вы специально добавите триггер push, действие перенесет эти изменения в базу данных Studio.
Приведенный пример GitHub Action _studio.yml
отправляет изменения при каждом обновлении ветки main
: