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

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

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

Исправление в dbt Cloud IDE

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

1. Запустите Cloud IDE в проекте, который нужно исправить, выбрав Develop в строке меню.
2. В вашем Проводнике файлов проверьте, существует ли файл .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. После перезапуска IDE перейдите в Проводник файлов, чтобы удалить следующие файлы или папки (если они существуют). Данные не будут потеряны:

   • target, dbt_modules, dbt_packages, logs

7. Сохраните, затем Коммитьте и синхронизируйте изменения.

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

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

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

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

11. Вернитесь в dbt Cloud 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. Переключитесь на dbt Cloud IDE и откройте проект, который вы исправляете.
9. Откатите ваш репозиторий к удаленному в IDE, нажав на три точки рядом с кнопкой IDE Status в нижнем правом углу экрана IDE, затем выберите Rollback to remote.
   • Примечание — Откат к удаленному сбрасывает ваш репозиторий к более ранней копии с вашего удаленного. Любые сохраненные, но не закоммиченные изменения будут потеряны, поэтому убедитесь, что вы скопировали любой измененный код, который хотите сохранить, во временное место за пределами dbt Cloud.
10. После отката к удаленному откройте файл .gitignore в ветке, в которой вы работаете. Если новые изменения не включены, вам нужно будет слить последние коммиты из основной ветки в вашу рабочую ветку.
11. Перейдите в Проводник файлов, чтобы убедиться, что файл .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-провайдера. Запрос на слияние должен попытаться слить изменения в 'основную' ветку, от которой создаются все ветки разработки.
9. Следуйте необходимым процедурам, чтобы получить одобрение ветки и слить ее в 'основную' ветку. Вы можете удалить ветку после завершения слияния.
10. После завершения слияния вернитесь в dbt Cloud IDE и откройте проект, который вы исправляете.
11. Откатите ваш репозиторий к удаленному в IDE, нажав на три точки рядом с кнопкой IDE Status в нижнем правом углу экрана IDE, затем выберите Rollback to remote.
    • Примечание — Откат к удаленному сбрасывает ваш репозиторий к более ранней копии с вашего удаленного. Любые сохраненные, но не закоммиченные изменения будут потеряны, поэтому убедитесь, что вы скопировали любой измененный код, который хотите сохранить, во временное место за пределами dbt Cloud.
12. После отката к удаленному откройте файл .gitignore в ветке, в которой вы работаете. Если новые изменения не включены, вам нужно будет слить последние коммиты из основной ветки в вашу рабочую ветку.
13. Перейдите в Проводник файлов, чтобы убедиться, что файл .gitignore содержит правильные записи, и убедитесь, что неотслеживаемые файлы/папки в файле .gitignore выделены курсивом.
14. Отличная работа 🎉! Вы правильно настроили .gitignore и можете продолжать разработку!

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