# Контрольный список настройки платформы dbt

Платформа dbt

Итак, вы создали новый облачный аккаунт dbt platform и готовы начать знакомство с его быстрыми и интуитивно понятными возможностями. Добро пожаловать! Прежде чем приступить к работе, давайте убедимся, что ваш аккаунт настроен корректно — это позволит без проблем подключать новых пользователей и использовать все интеграции, которые предлагает dbt.

Для большинства организаций на этом этапе потребуется взаимодействие с IT‑специалистами и/или командой безопасности. В зависимости от используемых возможностей, вам может понадобиться помощь следующих административных ролей:

* Хранилище данных (Snowflake, BigQuery, Databricks и т.д.)
* Управление доступом (Okta, Entra ID, Google, SAML 2.0)
* Git (GitHub, GitLab, Azure DevOps и т.д.)

Этот чек-лист поможет убедиться, что всё настроено правильно, чтобы вы могли быстро начать работу и избежать узких мест.

## Хранилище данных

Платформа dbt поддерживает [глобальные подключения](https://docs.getdbt.tech/docs/platform/connect-data-platform/about-connections.md#connection-management) к вашим хранилищам данных. Это означает, что одно настроенное подключение можно использовать в нескольких проектах и средах. Платформа dbt поддерживает подключения к различным хранилищам данных, включая BigQuery, Databricks, Redshift и Snowflake, но не ограничиваясь ими. Один из первых шагов при настройке аккаунта — убедиться, что у вас есть работающее подключение:

* [ ] Используйте [документацию по настройке подключений](https://docs.getdbt.tech/docs/platform/connect-data-platform/about-connections.md), чтобы настроить подключение к выбранному хранилищу данных.
* [ ] Убедитесь, что разработчикам dbt назначены необходимые роли и предоставлен доступ к вашим хранилищам данных.
* [ ] Убедитесь, что в хранилище есть реальные данные, к которым можно обращаться. Это могут быть данные из производственной среды или среды разработки. При желании вы можете использовать наш учебный проект электронной коммерции [The Jaffle Shop](https://github.com/dbt-labs/jaffle-shop). The Jaffle Shop включает тестовые данные и готовые к запуску модели!
* [ ] Независимо от того, создаёте ли вы новый проект или импортируете существующий проект dbt v1, убедитесь, что у него [правильно настроена структура](https://docs.getdbt.tech/docs/build/projects.md).
  * [ ] Если вы переходите с dbt v1, вам необходимо учесть несколько важных моментов, поэтому ознакомьтесь с нашим [руководством по миграции](https://docs.getdbt.tech/guides/dbt-migration-2.md?step=1).
* [ ] Вашим пользователям потребуется [настроить свои учётные данные](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md#get-started-with-the-studio-ide) для подключения к среде разработки в dbt Studio IDE.
  * [ ] Убедитесь, что всем пользователям, которым нужен доступ для работы в IDE, в вашем аккаунте назначена [лицензия разработчика](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md).
* [ ] Модели dbt в основном пишутся в виде [инструкций SELECT](https://docs.getdbt.tech/docs/build/sql-models.md), поэтому один из первых шагов для проверки успешности настройки — попросить разработчика выполнить простую инструкцию SELECT в IDE и проверить результаты.
  * [ ] Вы также можете проверить подключение, выполнив простые SQL-запросы с помощью [dbt Insights](https://docs.getdbt.tech/docs/explore/access-dbt-insights.md).
* [ ] Создайте одну модель и убедитесь, что можете успешно [запустить её](https://docs.getdbt.tech/reference/dbt-commands.md).
* [ ] Создайте служебную учётную запись с необходимыми правами доступа для ваших [заданий в производственной среде](https://docs.getdbt.tech/docs/deploy/jobs.md).

## Настройка Git

Git является основой большинства dbt‑окружений. Именно в Git‑репозиториях хранятся файлы dbt‑проекта, и именно там разработчики совместно работают над кодом и управляют версиями.

* [ ] Настройте [Git-репозиторий](https://docs.getdbt.tech/docs/platform/git/configure-git.md) для вашей учетной записи. dbt поддерживает интеграции с:

  * [GitHub](https://docs.getdbt.tech/docs/platform/git/connect-github.md)
  * [GitLab](https://docs.getdbt.tech/docs/platform/git/connect-gitlab.md)
  * [Azure DevOps](https://docs.getdbt.tech/docs/platform/git/connect-azure-devops.md)
  * Другими провайдерами через [Git clone](https://docs.getdbt.tech/docs/platform/git/import-a-project-by-git-url.md)
  * Если вы пока не готовы интегрироваться с существующим Git-решением, dbt может предоставить вам [управляемый Git-репозиторий](https://docs.getdbt.tech/docs/platform/git/managed-repository.md).

* [ ] Убедитесь, что разработчики могут [создать новую ветку и переключиться на нее](https://docs.getdbt.tech/docs/platform/git/version-control-basics.md#git-overview) в вашем репозитории.

* [ ] Убедитесь, что разработчики могут [фиксировать изменения](https://docs.getdbt.tech/docs/platform/studio-ide/ide-user-interface.md#basic-layout) в IDE.

## Окружения и job-ы

[Environments](https://docs.getdbt.tech/docs/environments-in-dbt.md) позволяют разделять данные разработки и продакшена. dbt поддерживает два типа окружений: Development и Deployment. Существует три типа Deployment‑окружений:

* Production — одно на проект
* Staging — одно на проект
* General — несколько на проект

Кроме того, в каждом проекте может быть только одно `Development`‑окружение, но у каждого разработчика будет собственный изолированный доступ к IDE, независимый от работы других разработчиков.

[Jobs](https://docs.getdbt.tech/docs/deploy/jobs.md) определяют, какие команды выполняются в окружениях. Они могут запускаться вручную, по расписанию, другими job‑ами, через API или при создании либо слиянии pull request.

После подключения хранилища данных и завершения интеграции с Git можно переходить к настройке окружений и job‑ов:

* [ ] Начните с создания новой [среды разработки](https://docs.getdbt.tech/docs/dbt-platform-environments.md#create-a-development-environment) для вашего проекта.
* [ ] Создайте [среду развертывания Production](https://docs.getdbt.tech/docs/deploy/deploy-environments.md).
  * [ ] (Необязательно) Создайте дополнительную среду Staging или General.
* [ ] [Создайте задание развертывания и настройте его расписание](https://docs.getdbt.tech/docs/deploy/deploy-jobs.md#create-and-schedule-jobs).
  * [ ] Проверьте работу задания, сначала запустив его вручную.
* [ ] При необходимости настройте разные базы данных для ваших сред.

## Пользовательский доступ

dbt platform предоставляет широкий набор инструментов управления доступом, которые позволяют предоставлять и отзывать доступ пользователей, настраивать RBAC, а также назначать лицензии и разрешения.

* [ ] Вручную [пригласите пользователей](https://docs.getdbt.tech/docs/platform/manage-access/invite-users.md) на платформу dbt, где они смогут проходить аутентификацию с помощью [MFA (SMS или приложения-аутентификатора)](https://docs.getdbt.tech/docs/platform/manage-access/mfa.md).
* [ ] Настройте [единый вход (SSO) или OAuth](https://docs.getdbt.tech/docs/platform/manage-access/sso-overview.md) для расширенного управления доступом. Только для аккаунтов [Enterprise](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")[Enterprise +](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе").
  * [ ] Создайте [сопоставления SSO](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#sso-mappings-) для групп
* Настройте [System for Cross-Domain Identity Management (SCIM)](https://docs.getdbt.tech/docs/platform/manage-access/scim.md), если ваш поставщик удостоверений (IdP) поддерживает этот протокол.
* [ ] Убедитесь, что приглашённые пользователи могут подключаться к хранилищу данных из своего личного профиля.
* [ ] [Создайте группы](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#create-new-groups-) и назначьте им наборы разрешений с детальной настройкой.
* [ ] Создайте [правила RBAC](https://docs.getdbt.com/docs/platform/manage-access/about-user-access#role-based-access-control-), чтобы при входе пользователей в систему назначать им группы и наборы разрешений. Только для аккаунтов [Enterprise](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")[Enterprise +](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе").
* [ ] Сделайте SSO обязательным для всех пользователей без прав администратора и обеспечьте обязательное использование MFA при каждом входе по паролю.

## Продолжайте

После завершения этого чек-листа вы будете готовы начать работу с dbt platform, но на этом путь только начинается. Ознакомьтесь с дополнительными ресурсами, которые помогут вам дальше:

* [ ] Изучите [guides](https://docs.getdbt.tech/guides.md) — это быстрые руководства по началу работы с проектами и возможностями.
* [ ] Пройдите практический курс [dbt Learn](https://learn.getdbt.com/catalog).
* [ ] Ознакомьтесь с нашими [best practices](https://docs.getdbt.tech/best-practices.md), где собраны практические рекомендации по структуре и деплою dbt‑проектов.
* [ ] Разберитесь с [references](https://docs.getdbt.tech/reference/references-overview.md) — это своего рода словарь продукта с подробными примерами реализации.
