# Контрольный список миграции в многосекционную архитектуру

Платформа dbt

dbt Labs находится в процессе внедрения новой ячеечной (cell-based) архитектуры для dbt. Эта архитектура закладывает основу развития dbt на годы вперёд и обеспечивает повышенную надёжность, производительность и согласованность для пользователей dbt.

Мы планируем миграции по аккаунтам. Когда мы будем готовы мигрировать ваш аккаунт, вы получите уведомление в виде баннера или электронного письма с датой миграции. Если вы не получили это уведомление, то на данный момент вам не нужно предпринимать никаких действий. dbt Labs предоставит вам информацию о вашей миграции с соответствующим предварительным уведомлением, если это будет применимо к вашему аккаунту.

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

## Рекомендуемые действия

Перенос вашей миграции

Если вы используете тариф dbt Enterprise, вы можете отложить миграцию аккаунта на срок до 45 дней. Чтобы перенести дату миграции, перейдите в **Account Settings** → **Migration guide**.

Для получения помощи свяжитесь с командой поддержки dbt по адресу <support@getdbt.com>.

Мы настоятельно рекомендуем вам выполнить следующие действия:

* Убедитесь, что все ожидающие приглашения пользователей приняты, либо зафиксируйте список непринятых приглашений. Ожидающие приглашения пользователей могут быть аннулированы в процессе миграции. После завершения миграции вы сможете повторно отправить приглашения пользователям.
* Создайте коммит с несохранёнными изменениями в [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md). Иначе при миграции эти изменения могут потеряться.
* Экспортируйте и скачайте [журналы аудита](https://docs.getdbt.tech/docs/platform/manage-access/audit-log.md) старше 90 дней. После миграции они будут недоступны в dbt. Журналы старше 90 дней, срок хранения которых ещё не истёк, можно восстановить через службу поддержки dbt Labs.

## Обязательные действия

Эти действия необходимы, чтобы предотвратить потерю пользователями доступа к dbt:

* Если вы ещё не выполнили [миграцию Auth0 для SSO](https://docs.getdbt.tech/docs/platform/manage-access/auth0-migration.md), сделайте это до запланированной даты, чтобы избежать перебоев. Если вы уже её выполнили, настройки SSO аккаунта перенесутся автоматически.

* Обновите списки разрешённых IP-адресов. После миграции dbt будет использовать новые IP-адреса для доступа к вашему хранилищу данных. Разрешите входящий трафик со всех следующих новых IP-адресов в вашем файрволе и включите их во все необходимые права доступа в базе данных:

  * `52.3.77.232`
  * `3.214.191.130`
  * `34.233.79.135`

  Сохраняйте старые IP-адреса dbt в списке до завершения миграции.

## Хранение данных, связанных с запусками

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

[Discovery API](https://docs.getdbt.tech/docs/dbt-apis/discovery-api.md) будет содержать подмножество данных после миграции вашей учетной записи. Метаданные, созданные за последние 7 дней, будут перенесены вместе с учетной записью. При запросе [объекта job](https://docs.getdbt.tech/docs/dbt-apis/discovery-schema-job.md) после миграции будет доступно не более 20 запусков.

## После миграции

Выполните все эти действия, чтобы ваши ресурсы и задания dbt продолжили работать без перебоев.

Для входа используйте один из следующих адресов:

* <https://login.dbt.com>: единая страница входа показывает аккаунты, к которым у вас есть доступ в разных инстансах. Администратор может включить или отключить этот способ через **Enable global account discovery** в разделе [Account settings](https://docs.getdbt.tech/docs/platform/account-settings.md#enable-global-account-discovery).
* `us1.dbt.com`: если раньше вы входили на `login.dbt.com` с именем пользователя и паролем, переходите на `us1.dbt.com`. Исходный адрес продолжит работать, но после входа потребуется дополнительный переход. Если настроен SSO, используйте уникальный адрес из настроек аккаунта SSO, например `ACCOUNT_PREFIX.us1.dbt.com`.
* `ACCOUNT_PREFIX.us1.dbt.com`: Уникальный URL, предназначенный именно для вашего аккаунта. Если вы состоите в нескольких аккаунтах, у каждого из них будет свой уникальный URL, при условии что они были перенесены в многоячеечную (multi-cell) архитектуру. Подробнее см. в разделе [Доступ, регионы и IP-адреса](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md).

Удалите следующие старые IP-адреса из вашего файрвола и предоставлений доступа к базе данных:

* `52.45.144.63`
* `54.81.134.249`
* `52.22.161.231`