Аутентификация в Azure DevOps

Если вы используете Studio IDE или dbt CLI для совместной работы с dbt-репозиторием вашей команды в Azure DevOps, вам необходимо связать свой профиль dbt с Azure DevOps. Это обеспечивает дополнительный уровень аутентификации.

Связывание профиля dbt с Azure DevOps

Подключите свой профиль dbt к Azure DevOps с помощью OAuth:

1. Нажмите на имя своей учётной записи в нижней части левого меню и выберите Account settings.

2. Прокрутите страницу до раздела Your profile и выберите Personal profile.

3. Перейдите в раздел Linked accounts в середине страницы.

   Экран авторизации Azure DevOps

4. После перенаправления в Azure DevOps войдите в свою учётную запись.

5. Когда появится экран запроса разрешений от приложения Azure DevOps, нажмите Accept.

   Экран авторизации Azure DevOps

Вы будете перенаправлены обратно в dbt, и ваш профиль должен быть связан с Azure DevOps. Теперь вы готовы к разработке в dbt!

Устранение неполадок

Используйте эти инструкции для устранения распространённых проблем при аутентификации в Azure DevOps.

 Ошибка Missing Azure user при запуске Studio

Если Studio IDE не запускается и отображает следующую ошибку, ваша личная учётная запись Azure DevOps не связана с dbt:

Missing Azure user; link your Azure DevOps account in your personal profile

Чтобы устранить проблему, свяжите свой профиль dbt с Azure DevOps.

 Ошибка Azure Service User not found при запуске Studio

Если Studio IDE не запускается и отображает следующую ошибку, служебный пользователь на уровне учётной записи не подключён:

Failed to start server. The project is not fully set up: Azure Service User not found

Это относится к учётным записям, использующим устаревший способ аутентификации через служебного пользователя. Администратору учётной записи необходимо повторно подключить служебного пользователя. Это также требуется, если в учётной записи более 90 дней не было запусков по расписанию, через API или в рамках CI. Подробнее см. в разделе Подключение служебного пользователя.

Часто задаваемые вопросы

Как исправить мой файл .gitignore?

Файл .gitignore определяет, какие файлы git должен намеренно игнорировать или «не отслеживать». dbt обозначает неотслеживаемые файлы на панели файлов проекта, выделяя имя файла или папки курсивом.

Если в Studio IDE возникают проблемы с отменой изменений, переключением на другую ветку или созданием новой либо после коммита не появляется предложение открыть пул-реквест — это обычно указывает на проблему с файлом .gitignore. Этот файл может отсутствовать или не содержать записей, необходимых для корректной работы dbt.

В следующих разделах описано, как исправить файл .gitignore в:

 Исправление в Studio IDE

Чтобы решить проблемы с вашим файлом gitignore, добавление правильных записей не удалит автоматически (или "не будет отслеживать") файлы или папки, которые уже отслеживаются git. Обновленный gitignore будет только предотвращать отслеживание новых файлов или папок. Поэтому вам нужно сначала исправить файл gitignore, а затем выполнить некоторые дополнительные операции git, чтобы перестать отслеживать любые неправильные файлы или папки.

1. Откройте Studio IDE в проекте, в котором устраняете проблему, выбрав Develop в строке меню.
2. В File Explorer проверьте, существует ли файл .gitignore в корне папки вашего проекта dbt. Если его нет, создайте новый файл.
3. Откройте новый или существующий файл gitignore и добавьте следующее:

# ✅ Правильно 
target/
dbt_packages/
logs/
# устаревшее -- переименовано в dbt_packages в dbt v1
dbt_modules/

Сообщить об ошибке в коде

• Примечание — Вы можете разместить эти строки в любом месте файла, главное, чтобы они были на отдельных строках. Показанные строки являются шаблонами, которые включат все вложенные файлы и папки. Избегайте добавления завершающего '*' к строкам, например, target/*.

Для получения дополнительной информации о синтаксисе gitignore обратитесь к документации Git.

4. Сохраните изменения, но не коммитьте.
5. Перезапустите IDE, нажав на три точки рядом с кнопкой IDE Status в нижнем правом углу экрана IDE и выберите Restart IDE.

Перезапустите IDE, нажав на три точки в правом нижнем углу или на строку состояния

6. После перезапуска Studio IDE перейдите в File Catalog, чтобы удалить следующие файлы или папки (если они существуют). Данные при этом не будут потеряны:

   • target, dbt_modules, dbt_packages, logs

7. Нажмите Save, а затем Commit and sync, чтобы сохранить изменения, создать коммит и синхронизировать их.

8. Снова перезапустите Studio IDE, выполнив те же действия, что и на шаге 5.

9. После перезапуска Studio IDE нажмите кнопку Create a pull request (PR) в меню Version Control, чтобы начать процесс интеграции изменений.

10. Когда на сайте Git-провайдера откроется страница с новым PR, выполните необходимые действия, чтобы завершить оформление PR и слить его в основную ветку этого репозитория.

    • Примечание — Основная ветка может также называться 'master', 'dev', 'qa', 'prod' или как-то иначе в зависимости от организационных соглашений о наименовании. Цель состоит в том, чтобы слить эти изменения в корневую ветку, от которой создаются все другие ветки разработки.

11. Вернитесь в Studio IDE и с помощью кнопки Change Branch переключитесь на основную ветку проекта.

12. После переключения ветки нажмите кнопку Pull from remote, чтобы получить все изменения.

13. Проверьте изменения: убедитесь, что файлы и папки, указанные в файле .gitignore, отображаются курсивом.

Проект dbt в основной ветке с правильно настроенными исключениями для папок в gitignore (выделены курсивом).

 Исправить в Git‑провайдере

Иногда необходимо использовать веб-интерфейс git-провайдера, чтобы исправить поврежденный файл .gitignore. Хотя конкретные шаги могут различаться у разных провайдеров, общий процесс остается тем же.

Существует два варианта для этого подхода: редактирование основной ветки напрямую, если это разрешено, или создание pull request для внесения изменений, если это требуется:

Редактировать в основной ветке

Если разрешения позволяют, можно редактировать .gitignore напрямую в основной ветке вашего репозитория. Вот следующие шаги:

1. Перейдите в веб-интерфейс вашего репозитория.
2. Переключитесь на основную ветку и корневую директорию вашего проекта dbt.
3. Найдите файл .gitignore. Создайте пустой, если он не существует.
4. Отредактируйте файл в веб-интерфейсе, добавив следующие записи:

target/
dbt_packages/
logs/
# устаревшее -- переименовано в dbt_packages в dbt v1
dbt_modules/

Сообщить об ошибке в коде

5. Коммитьте (сохраните) файл.
6. Удалите следующие папки из корня проекта dbt, если они существуют. Данные или код не будут потеряны:
   • target, dbt_modules, dbt_packages, logs
7. Зафиксируйте (сохраните) удаления в основной ветке.
8. Перейдите в Studio IDE и откройте проект, который вы исправляете.
9. Восстановите репозиторий из удалённого репозитория в IDE: нажмите на три точки рядом с кнопкой IDE Status в правом нижнем углу экрана IDE, затем выберите Rollback to remote.
   • Примечание — Действие Rollback to remote возвращает ваш репозиторий к состоянию ранее созданного клона удалённого репозитория. Все сохранённые, но не зафиксированные изменения будут потеряны, поэтому обязательно скопируйте изменённый код, который хотите сохранить, во временное расположение за пределами dbt.
10. После восстановления из удалённого репозитория откройте файл .gitignore в ветке, в которой вы работаете. Если новых изменений в нём нет, вам потребуется влить последние коммиты из основной ветки в вашу рабочую ветку.
11. Перейдите в File Explorer, чтобы проверить, что файл .gitignore содержит правильные записи, и убедитесь, что неотслеживаемые файлы и папки, указанные в .gitignore, выделены курсивом.
12. Отличная работа 🎉! Вы правильно настроили .gitignore и можете продолжать разработку!

Невозможно редактировать основную ветку

Если вы не можете редактировать .gitignore напрямую в основной ветке вашего репозитория, выполните следующие шаги:

1. Перейдите в веб-интерфейс вашего репозитория.
2. Переключитесь на существующую ветку разработки или создайте новую ветку только для этих изменений (это часто быстрее и чище).
3. Найдите файл .gitignore. Создайте пустой, если он не существует.
4. Отредактируйте файл в веб-интерфейсе, добавив следующие записи:

target/
dbt_packages/
logs/
# устаревшее -- переименовано в dbt_packages в dbt v1
dbt_modules/

Сообщить об ошибке в коде

5. Коммитьте (сохраните) файл.
6. Удалите следующие папки из корня проекта dbt, если они существуют. Данные или код не будут потеряны:
   • target, dbt_modules, dbt_packages, logs
7. Зафиксируйте (сохраните в коммите) удаление папок.
8. Откройте запрос на слияние через веб-интерфейс вашего Git-провайдера. Запрос должен быть направлен на слияние изменений с веткой 'main', от которой создаются все ветки разработки.
9. Выполните необходимые процедуры, чтобы получить одобрение и слить ветку с веткой 'main'. После завершения слияния вы можете удалить ветку.
10. После завершения слияния вернитесь в Studio IDE и откройте проект, который вы исправляете.
11. Выполните откат репозитория к состоянию удалённого репозитория в Studio IDE: нажмите на три точки рядом с кнопкой Studio IDE Status в правом нижнем углу экрана Studio IDE, затем выберите Rollback to remote.
    • Примечание — Действие Rollback to remote возвращает репозиторий к состоянию ранее созданной копии удалённого репозитория. Все сохранённые, но не зафиксированные в коммите изменения будут потеряны, поэтому обязательно скопируйте изменённый код, который хотите сохранить, во временное расположение за пределами dbt.
12. После отката к состоянию удалённого репозитория откройте файл .gitignore в ветке, над которой вы работаете. Если новые изменения отсутствуют, вам потребуется слить последние коммиты из ветки main с вашей рабочей веткой.
13. Перейдите в File Explorer, чтобы убедиться, что файл .gitignore содержит правильные записи, а неотслеживаемые файлы и папки, указанные в .gitignore, отображаются курсивом.
14. Отличная работа 🎉! Вы правильно настроили .gitignore и можете продолжать разработку!

Для получения дополнительной информации см. это подробное видео с дополнительными пояснениями.

Как мигрировать между git-провайдерами

Чтобы мигрировать от одного git-провайдера к другому, следуйте следующим шагам, чтобы избежать минимальных перебоев:

1. За пределами dbt вам потребуется импортировать существующий репозиторий в новый сервис хостинга репозиториев. По умолчанию подключение репозитория в одной учетной записи не приводит к его автоматическому отключению от другой учетной записи.

   Например, если вы мигрируете с GitHub на Azure DevOps, вам нужно импортировать существующий репозиторий (GitHub) в нового провайдера Git (Azure DevOps). Подробные инструкции по выполнению этой операции смотрите в документации вашего провайдера Git (например, GitHub, GitLab, Azure DevOps).

2. Вернитесь в dbt и при необходимости настройте интеграцию с новым провайдером Git.

3. Отключите старый репозиторий в dbt, перейдя в Account Settings, а затем в Projects.

4. Нажмите ссылку Repository, затем нажмите Edit и Disconnect.

   Отключение и повторное подключение Git-репозитория на странице настроек аккаунта dbt.

5. Нажмите Confirm Disconnect.

6. На той же странице подключите репозиторий нового провайдера Git, нажав Configure Repository.

   • Если вы используете нативную интеграцию, может потребоваться пройти OAuth-авторизацию.

7. Готово! Теперь вы подключены к новому провайдеру Git! 🎉

Примечание — Рекомендуем обновить страницу и Studio IDE перед выполнением любых действий.

Нашли ошибку?

Создать GitHub Issue