Репозитории

Общая информация

Репозиторий это каталог, в котором хранятся файлы проекта, история их изменения и служебная информация. Репозиторий может располагаться на удаленном компьютере, который доступен по таким протоколам как file, git, ssh, http, https, ftp, sftp.

Репозиторий похож на набор снимков миниатюрной файловой системы. Каждый раз, когда вы фиксируете свои изменения в репозитории, Git запоминает, как выглядит каждый из файлов и сохраняет ссылку на этот снимок. Такая ссылка называется коммитом.

Групповая разработка выглядит следующим образом. Каждый разработчик имеет локальную копию этого исходного репозитория, в которую он вносит свои изменения.

Когда изменения закончены и проверены, он может поделиться ими с другими разработчиками. Для этого он отправляет их из локального репозитория в исходный. Также разработчик может получить из исходного репозитория изменения других разработчиков, которые они туда отправили.

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

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

Рабочая область 1C:EDT и каталог git-репозитория

Когда вы создаете локальный репозиторий, создавайте его таким образом, чтобы каталог репозитория и рабочая область 1C:EDT не находились в иерархии друг друга.

Репозиторий по сути представляет собой каталог на жестком диске, который является рабочим каталогом — в нем вы будете модифицировать файлы, извлеченные из репозитория. А еще в этом же каталоге находится вложенный каталог с именем .git — который и есть, фактически, репозиторий. Именно в нем хранятся коммиты, ссылки, журналы и т.д.).

Рабочая область 1C:EDT это тоже каталог на жестком диске, в котором находятся все файлы, с которыми вы работаете средствами 1C:EDT. Например, на следующем рисунке показана рабочая область 1C:EDT, которая находится в каталоге coldev. В ней есть служебный каталог .metadata и три каталога для каждого из проектов: проект конфигурации coldev, проекты расширений ВесТоваров и Колонтитулы.

Не следует размещать репозиторий в корневом каталоге проекта. Например, на следующем рисунке репозиторий размещен в корневом каталоге проекта конфигурации coldev (синий). Рабочая область 1C:EDT показана красным.

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

Конечно, вы все равно можете добавлять проекты в виде вложенных каталогов, но известно, что такое вложение проектов вызывает множество проблем. Чтобы добавить еще один проект, вам придется переместить проект в подкаталог в репозитории и добавить второй проект в качестве еще одного подкаталога, прежде чем вы сможете зафиксировать это изменение.

Также не следует размещать репозиторий в корневом каталоге рабочей области. Например, на следующем рисунке репозиторий размещен в корневом каталоге рабочей области coldev (синий). Рабочая область 1C:EDT показана красным.

Есть несколько причин, почему так делать не нужно:

• Новый репозиторий будет рассматривать всю структуру каталогов рабочей области 1C:EDT как потенциальное содержимое. Это может привести к проблемам с производительностью, например, при вычислении изменений перед фиксацией, при которой будет сканироваться весь каталог .metadata. Часто рабочая область может содержать мертвые каталоги (например, удаленные проекты), которые семантически не имеют отношения к Git, но их нельзя легко исключить;
• Каталог метаданных репозитория .git будет дочерним по отношению к рабочей области 1C:EDT. Не исключено, что это может вызвать нежелательный обход папок в Eclipse;
• Вы можете случайно легко уничтожить свой репозиторий, удалив рабочую область пространство 1C:EDT.

По всем перечисленным причинам мы рекомендуем создавать локальный репозиторий таким образом, чтобы каталог репозитория и рабочая область 1C:EDT не находились в иерархии друг друга. Например, они могут быть расположены на разных жестких дисках. На следующем рисунке рабочая область 1C:EDT показана красным, а репозиторий — синим цветом.

При подключении проекта к репозиторию или при клонировании удаленного репозитория 1C:EDT всегда дает вам возможность выбрать произвольный каталог для локального репозитория и сразу же переместить в него те проекты, которые должны находиться под версионным контролем. Например, вы можете поместить в репозиторий проект конфигурации и проект одного из расширений, а проект другого расширения не версионировать и оставить в рабочей области 1C:EDT.

Клонировать репозиторий (clone)

ssh://user@example.com:6888/dir/gitproject.git — на удаленном сервере example.com
http://example.com/dir/gitproject.git — на удаленном сервере example.com
file://\\example\gitproject — на сетевом компьютере example
file://D:\dir\gitproject — в локальном каталоге

Поместить проект в локальный репозиторий

Например, вы хотите версионировать свой проект. Для этого вы можете поместить его в локальный репозиторий и фиксировать в этом репозитории свои изменения.

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

Чтобы поместить проект в локальный репозиторий нажмите Групповая разработка > Общий проект... в контекстном меню проекта.

В поле Репозиторий выберите локальный репозиторий, в котором будет располагаться проект. Если вы хотите создать для проекта новый репозиторий, то нажмите Создать, чтобы выбрать каталог нового репозитория.

Назначение полей:

• Создать репозиторий в родительском каталоге проекта (или использовать существующий) — не используется при разработке прикладных решений «1С:Предприятия», флажок должен быть снят;
• Репозиторий — существующий репозиторий, выбранный из выпадающего списка, или путь к новому репозиторию, выбранный с помощью кнопки Создать;
• Рабочее дерево — путь к рабочему каталогу репозитория, заполняется автоматически из данных поля Репозиторий;
• Путь внутри репозитория — если проект должен располагаться не в корне репозитория, а внутри более сложной структуры каталогов, здесь вы можете задать относительный путь к проекту в репозитории;

Таблица Проект — Текущее расположение — Целевое расположение показывает путь, по которому файлы проекта будут перемещены в рабочую область репозитория.

Начать разработку проекта из локального репозитория

Например, вы создаете новый проект 1C:EDT Start и хотите использовать с ним имеющийся локальный репозиторий, в котором находится разрабатываемый проект.

1. Нажмите Файл > Импорт... > Git > Проекты из Git > Существующий локальный репозиторий в главном меню;
2. Нажмите Добавить и выберите каталог существующего локального репозитория;
3. Выделите этот репозиторий в списке и нажмите Добавить;
4. Выделите добавленный репозиторий в списке и нажмите Далее;
5. Выберите Импорт из существующего проекта Eclipse и нажмите Далее;
6. Установите флажок у нужного проекта и нажмите Готово.

Импортированный проект появится в панели Навигатор.

Добавить в репозиторий сразу несколько проектов

Создать локальный репозиторий (init)

• Откройте панель Репозитории Git;
• Нажмите (Создать новый репозиторий Git) в командной панели.

В поле Каталог репозитория укажите путь к репозиторию или выберите его, нажав на Обзор....

• Каталог репозитория — путь к локальному репозиторию;
• Default branch name — имя стандартной ветки. Обычно это master;
• Create as bare repository — создать голый репозиторий.
  Голый репозиторий это репозиторий, который не имеет рабочего каталога. То есть он хранит изменения, но не подразумевает, что в нем будет вестись непосредственное изменение данных путем извлечения веток и фиксации изменений.
  Обычно голые репозитории используют в качестве удаленных репозиториев. В них отправляют свои изменения и получают из них изменения, сделанные другими разработчиками.
  Если вы предполагаете использовать создаваемый репозиторий в качестве удаленного, установите этот флажок.

Нажмите Создать.

Если вы планируете разрабатывать в этом репозитории большие проекты, настройте поддержку Git LFS.

Добавить существующий локальный репозиторий в панель

Добавить существующий локальный репозиторий по его пути

1. Скопируйте путь к репозиторию в буфер обмена. Путь к репозиторию это полный путь к его каталогу .git;
2. Добавить репозиторий можно несколькими способами в панели Репозитории Git:
   • В командной панели нажмите (Показать меню) Вставить путь к репозиторию или URI;
   • В контекстном меню группы репозиториев нажмите Вставить путь к репозиторию или URI.

Исключить репозиторий из списка

Чтобы исключить репозиторий из списка в панели Репозитории Git, нажмите Удалить репозиторий из панели в контекстном меню репозитория. Запись исчезнет из панели, но сам репозиторий останется в файловой системе.

Удалить репозиторий

Чтобы удалить репозиторий, выполните следующие действия:

1. Откройте панель Репозитории Git;
2. Нажмите Удалить репозиторий... в контекстном меню репозитория;
3. Выберите один из вариантов удаления:
   • Delete Git repositiry data and history — удаляет репозиторий Git, но оставляет рабочий каталог репозитория и все проекты, находящиеся в нем. Вы можете продолжать работать с проектами, которые были в этом репозитории, но уже без версионирования;
   • Remove the project in the reporitory from the workspace — дополнительно к предыдущему удаляет проект из рабочей области 1C:EDT. Проект исчезает из панели Навигатор, но его файлы остаются на диске. Вы можете импортировать этот проект в другую рабочую область 1C:EDT;
   • Also delete working tree — дополнительно к предыдущему, удаляет и рабочий каталог репозитория;
     Предупреждение: Это действие, естественно, удаляет все проекты, которые находятся в рабочем каталоге репозитория. После этого работа с файлами, хранившимися в репозитории, будет невозможна.
4. Нажмите Удалить.

Группа параметров «Оформление меток»

Группа параметров Оформление меток позволяет настраивать то, каким образом будет отображаться состояние ресурсов, находящихся под версионным контролем. Для этого используются два элемента оформления: текстовое оформление и оформление иконками.