diff --git a/docs/Home.md b/docs/Readme.md similarity index 99% rename from docs/Home.md rename to docs/Readme.md index 3723924..7980ed8 100644 --- a/docs/Home.md +++ b/docs/Readme.md @@ -10,7 +10,7 @@ * Параллелизировать загрузку истории хранилища из копий хранилища * Управление нагрузкой на сервер с помощью очередей * Возможно "сращивать" историю в Git, если хранилище конфигураций "1С:Предприятия" обрезалось или начиналось заново. -* Создание корректной истории переименования объектов метаданных (см. [Как это работает](Как-это-работает#Коммит-в-git)) +* Создание корректной истории переименования объектов метаданных (см. [Как это работает](Как-это-работает.md#Коммит-в-git)) * Выгружать только изменения конфигурации. Доступно для Платформы 8.3.10 и выше, для версий ниже 8.3.15 требуется использовать "очереди" * Создание сквозной истории изменений для "хранилищ исправительных версий" если вы используете [Технологию разветвленной разработки конфигураций](https://its.1c.ru/db/v8std#content:709:hdoc) или аналогичный процесс - хранилище версии можно загружать в "ветку" Git, получив сквозную историю в ветке. * Возможность автоматически указывать Git теги при изменении версии конфигурации. diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md index 03ce1d1..c0a8b96 100644 --- a/docs/_Sidebar.md +++ b/docs/_Sidebar.md @@ -1,32 +1,32 @@ -[Начало](home) +[Начало](Readme.md) -* [Как это работает?](Как-это-работает) -* [Начальная настройка](Начальная-настройка) - * [Настройка Windows](Настройка-Windows) - * [Настройка Linux](Настройка-Linux) - * [Настройка сервера 1С](Настройка-сервера-1С) - * [Настройка базы ГитКонвертера](Настройка-базы-ГитКонвертера) +* [Как это работает?](Как-это-работает.md) +* [Начальная настройка](Начальная-настройка.md) + * [Настройка Windows](Настройка-Windows.md) + * [Настройка Linux](Настройка-Linux.md) + * [Настройка сервера 1С](Настройка-сервера-1С.md) + * [Настройка базы ГитКонвертера](Настройка-базы-ГитКонвертера.md) -* [Настройка конвертации хранилища 1С](Настройка-конвертации-хранилища-1С) - * [Параметры конвертации](Параметры-конвертации) - * [Авторизация в сервере Git](Авторизация-в-сервере-Git) - * [Дополнительная настройка репозитория Git](Дополнительная-настройка-репозитория-Git) - * [Символы окончания строк](Символы-окончания-строк) - * [Git LFS](Git-LFS) - * [Информация пользователей](Информация-пользователей) +* [Настройка конвертации хранилища 1С](Настройка-конвертации-хранилища-1С.md) + * [Параметры конвертации](Параметры-конвертации.md) + * [Авторизация в сервере Git](Авторизация-в-сервере-Git.md) + * [Дополнительная настройка репозитория Git](Дополнительная-настройка-репозитория-Git.md) + * [Символы окончания строк](Символы-окончания-строк.md) + * [Git LFS](Git-LFS.md) + * [Информация пользователей](Информация-пользователей.md) * Дополнительные возможности - * [Копии хранилища](Копии-хранилища) - * [Очереди выполнения](Очереди-выполнения) - * [Расширения](Расширения) + * [Копии хранилища](Копии-хранилища.md) + * [Очереди выполнения](Очереди-выполнения.md) + * [Расширения](Расширения.md) -* [Сценарии применения](Сценарии-применения) +* [Сценарии применения](Сценарии-применения.md) * [Начать работу в EDT, не конвертируя все предыдущие версии хранилища](Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища) - * [Максимум скорости на историю](Максимум-скорости-на-историю) - * [Оперативное слежение за разработкой](Оперативное-слежение-за-разработкой) - * [Сращивание истории из нескольких хранилищ](Сращивание-истории-из-нескольких-хранилищ) - * [Сквозная история в ветках](Сквозная-история-в-ветках) + * [Максимум скорости на историю](Максимум-скорости-на-историю.md) + * [Оперативное слежение за разработкой](Оперативное-слежение-за-разработкой.md) + * [Сращивание истории из нескольких хранилищ](Сращивание-истории-из-нескольких-хранилищ.md) + * [Сквозная история в ветках](Сквозная-история-в-ветках.md) -* [Обновление с версии 1.0.4](Обновление-с-версии-1.0.4) - * [Конвертация выгрузки 1С:Предприятия в формат 1C:Enterprise Development Tools](Конвертация-выгрузки-1С-Предприятия-в-формат-1C-Enterprise-Development-Tools) +* [Обновление с версии 1.0.4](Обновление-с-версии-1.0.4.md) + * [Конвертация выгрузки 1С:Предприятия в формат 1C:Enterprise Development Tools](Конвертация-выгрузки-1С-Предприятия-в-формат-1C-Enterprise-Development-Tools.md) -* [Если что-то пошло не так (FAQ)](Если-что-то-пошло-не-так-FAQ) \ No newline at end of file +* [Если что-то пошло не так (FAQ)](Если-что-то-пошло-не-так-FAQ.md) \ No newline at end of file diff --git a/docs/Максимум-скорости-на-историю.md b/docs/Максимум-скорости-на-историю.md index f2329db..b5bd3c5 100644 --- a/docs/Максимум-скорости-на-историю.md +++ b/docs/Максимум-скорости-на-историю.md @@ -9,7 +9,7 @@ * Подключаем на том же сервере (или на отдельном сервере в той же сети) - отдельный SSD-диск * Поднимаем 3 сервиса хранилищ конфигураций 1С на разных портах - настроенных на разные каталоги диска -* Настраиваем [кэширование сервера хранилищ](Настройка-конвертации-хранилища-1С) в зависимости от количества потоков получения из хранилища +* Настраиваем [кэширование сервера хранилищ](Настройка-конвертации-хранилища-1С.md) в зависимости от количества потоков получения из хранилища * Копируем текущее состояние хранилища в 3 разных каталога - т.о. на одном SSD-диске 3 независимых копии хранилища. Следите за очередью к диску - может быть 3 шт. - это много, но крутые диски могут и больше! * Сервер хранилищ - многопоточный - но у него есть ограничение по памяти. @@ -27,14 +27,14 @@ ## Настройка получения версий -* Устанавливаем ограничения **"Количества подготавливаемых версий"** в настройках из расчета *Объем диска* / **Размер выгрузки** [см тут](Параметры-конвертации). +* Устанавливаем ограничения **"Количества подготавливаемых версий"** в настройках из расчета *Объем диска* / **Размер выгрузки** [см тут](Параметры-конвертации.md). * Создаем пользователей в каждой копии хранилища 1С с именами "Выгрузка1", "Выгрузка2"... "Выгрузка-N" - из расчета того сколько сможет выдержать параллельных потоков. Для простоты посчитать можно так: `4Гб / Размер cf версии`, например версия конфигурации 500Мб - значит можно начать с 8 потоков на один сервис хранилища, а дальше - следить за памятью сервиса. -* Для каждого пользователя, для каждого сервиса хранилища 1С создаем настройку ["Копии хранилища"](Копии-хранилища) - в нашем примере 24 копии - для каждого настраиваем расписание запуска **"каждый день, каждые 60 секунд"** +* Для каждого пользователя, для каждого сервиса хранилища 1С создаем настройку ["Копии хранилища"](Копии-хранилища.md) - в нашем примере 24 копии - для каждого настраиваем расписание запуска **"каждый день, каждые 60 секунд"** * Укажите расписание запуска "Каждый день, каждые 60 секунд" ## Настройка выгрузки в xml -Суть: важно определиться - используем ли [выгрузку изменений](Параметры-конвертации) или нет. +Суть: важно определиться - используем ли [выгрузку изменений](Параметры-конвертации.md) или нет. * Для **Выгрузки изменений** настраиваем для каждой очереди выгрузки рабочие диапазоны версий. * Первая очередь - от 1 версии до 50 diff --git a/docs/Настройка-базы-ГитКонвертера.md b/docs/Настройка-базы-ГитКонвертера.md index e3944e0..54b873a 100644 --- a/docs/Настройка-базы-ГитКонвертера.md +++ b/docs/Настройка-базы-ГитКонвертера.md @@ -1,4 +1,4 @@ 1. Разместите базу ГитКонвертера на сервере 1С. Работа в файловом режиме может быть использована только в демонстрационных целях. 2. Заполните константу __"Путь к версиям платформы на сервере"__, где располагаются файлы Конфигуратора 1cv8(.exe) в формате: `C:\Program files (x86)\1cv8\%ВерсияПлатформы%\bin` где в параметр `%ВерсияПлатформы%` - будет подставлена текущая версия хранилища из настроек. -4. Для ограничения производительности можно включить константу __"Использовать очереди выполнения"__ - количеством очередей можно балансировать нагрузку на сервер. (см. [Очереди выполнения](Очереди-выполнения)) \ No newline at end of file +4. Для ограничения производительности можно включить константу __"Использовать очереди выполнения"__ - количеством очередей можно балансировать нагрузку на сервер. (см. [Очереди выполнения](Очереди-выполнения.md)) \ No newline at end of file diff --git a/docs/Настройка-конвертации-хранилища-1С.md b/docs/Настройка-конвертации-хранилища-1С.md index 106d2b1..402e83e 100644 --- a/docs/Настройка-конвертации-хранилища-1С.md +++ b/docs/Настройка-конвертации-хранилища-1С.md @@ -2,4 +2,4 @@ Для оптимальной работы сервера хранилищ настройте __Размер глобального кэша__ в "Администрировании" в 1,5-2 раза больше __количества__ параллельных потоков (если используются "копии хранилища") __получения версий * размер одной версии, Мб__. -2. Создайте настройку конвертации хранилища и [настройте параметры](Параметры-конвертации). \ No newline at end of file +2. Создайте настройку конвертации хранилища и [настройте параметры](Параметры-конвертации.md). \ No newline at end of file diff --git a/docs/Начальная-настройка.md b/docs/Начальная-настройка.md index f27374a..629d655 100644 --- a/docs/Начальная-настройка.md +++ b/docs/Начальная-настройка.md @@ -34,8 +34,8 @@ 3. Установите на сервер Git версии 2.16 и выше. Например, отсюда: https://git-scm.com/downloads -4. Установите на сервер Git LFS, если планируете использовать в вашем проекте. [См. раздел Git LFS](Git-LFS) +4. Установите на сервер Git LFS, если планируете использовать в вашем проекте. [См. раздел Git LFS](Git-LFS.md) -5. Разместите на сервере 1С:Предприятия базу 1С:ГитКонверетера и [выполните начальную настройку базы](Настройка-базы-ГитКонвертера). +5. Разместите на сервере 1С:Предприятия базу 1С:ГитКонверетера и [выполните начальную настройку базы](Настройка-базы-ГитКонвертера.md). 6. Установите клиенты 1С:Предприятия (Конфигуратор) тех версий, на которых запущено хранилище конфигураций 1С. Конфигуратор будет выполнять большую часть работ по конвертации. \ No newline at end of file diff --git a/docs/Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища.md b/docs/Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища.md index 5c4e82f..41538e9 100644 --- a/docs/Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища.md +++ b/docs/Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища.md @@ -4,7 +4,7 @@ ## Настройка синхронизации, начиная с версии N -1. Создаем настройку синхронизации в ГитКонверетре, [заполнив необходимые параметры](Параметры-конвертации) +1. Создаем настройку синхронизации в ГитКонверетре, [заполнив необходимые параметры](Параметры-конвертации.md) 2. В поле **Начальная версия** укажите предыдущую версию хранилища, от той, которой необходимо начать `N-1`. @@ -12,7 +12,7 @@ 4. Инициализируйте новый пустой репозиторий Git командой на форме настройки синхронизации хранилища. - 4.1. Выполните [дополнительную настройку Git](Git-LFS) по необходимости. + 4.1. Выполните [дополнительную настройку Git](Git-LFS.md) по необходимости. 5. В поле **Версия в Git** в настройке - укажите предыдущую версию, как в поле **Начальная версия** `N-1`. diff --git a/docs/Оптимизация-выгрузки-на-8.3.15.md b/docs/Оптимизация-выгрузки-на-8.3.15.md index 315f84e..d2d1bd0 100644 --- a/docs/Оптимизация-выгрузки-на-8.3.15.md +++ b/docs/Оптимизация-выгрузки-на-8.3.15.md @@ -1,4 +1,4 @@ -Расширение позволяет для конвертации хранилищ 1С:Предприятия на версии **ниже 8.3.15** использовать оптимизированный алгоритм частичной выгрузки. При это не требуется настраивать [очереди выполнения](Очереди-выполнения) для частичной выгрузки. +Расширение позволяет для конвертации хранилищ 1С:Предприятия на версии **ниже 8.3.15** использовать оптимизированный алгоритм частичной выгрузки. При это не требуется настраивать [очереди выполнения](Очереди-выполнения.md) для частичной выгрузки. ### Настройка diff --git a/docs/Параметры-конвертации.md b/docs/Параметры-конвертации.md index c5464d7..fa4479c 100644 --- a/docs/Параметры-конвертации.md +++ b/docs/Параметры-конвертации.md @@ -13,7 +13,7 @@ ## Использование Git сервера -Если репозиторий планируется размещать на сервере Git - выполните [настройки авторизации в Git](Авторизация-в-сервере-Git) +Если репозиторий планируется размещать на сервере Git - выполните [настройки авторизации в Git](Авторизация-в-сервере-Git.md) ## Дополнительно @@ -22,7 +22,7 @@ * Если указана версия окончания - не будет выполняться запрос новых версий. Это может быть полезно, если требуется конвертировать сначала всю историю разработки. * Желательно ограничить количество подготавливаемых (выгружаемых) версий - рекомендуется установить значение исходя из __Размер базы с версией + Размер выгрузки в xml__ и размера жесткого диска. * Укажите __Минимальное количество метаданных__ - число файлов и каталогов выгрузки в xml - необходимо для контроля, что все файлы выгружены. Рекомендуется устанавливать количество, примерно 90-95% от количества файлов в текущей версии, чтобы учесть возможность удаления метаданных (т.е. сокращения количества файлов) -* Разрешить помещать анонимно, если пользователь не найден в регистре [Информация пользователей](Информация-пользователей) - это может понадобиться, если автор хранилища версий единственный или авторство неуказанных пользователей не нужно. +* Разрешить помещать анонимно, если пользователь не найден в регистре [Информация пользователей](Информация-пользователей.md) - это может понадобиться, если автор хранилища версий единственный или авторство неуказанных пользователей не нужно. * Не рекомендуется устанавливать __Удаление конфигураций поставщиков__, если планируется загружать конфигурацию из файлов и обновлять конфигурации поставщиков. Опция позволяет оптимизировать размер хранилища Git и не хранить объемные файлы *.cf. * Установите __Удалять временные данные версии после коммита__ - рекомендуется на реальных проектах. * __Выгружать изменения__ - позволяет на Платформе 8.3.10 и выше выгружать только изменения. Доступно при использовании __"Очередей"__ diff --git a/docs/Расширения.md b/docs/Расширения.md index 8d6361e..220273e 100644 --- a/docs/Расширения.md +++ b/docs/Расширения.md @@ -1,3 +1,3 @@ Расширения для кастомизации работы 1С:ГитКонвертера -* [Версия Платформы Хранилища](Версия-Платформы-Хранилища) позволяет подклчаться к Хранилищу на версии, отличной от версии выгрузки. \ No newline at end of file +* [Версия Платформы Хранилища](Версия-Платформы-Хранилища.md) позволяет подклчаться к Хранилищу на версии, отличной от версии выгрузки. \ No newline at end of file diff --git a/docs/Сценарии-применения.md b/docs/Сценарии-применения.md index 91d9bb5..183207b 100644 --- a/docs/Сценарии-применения.md +++ b/docs/Сценарии-применения.md @@ -1,5 +1,5 @@ * [Начать работу в EDT, не конвертируя все предыдущие версии хранилища](Начать-работу-в-EDT,-не-конвертируя-все-предыдущие-версии-хранилища) -* [Максимум скорости на историю](Максимум-скорости-на-историю) -* [Оперативное слежение за разработкой](Оперативное-слежение-за-разработкой) -* [Сращивание истории из нескольких хранилищ](Сращивание-истории-из-нескольких-хранилищ) -* [Сквозная история в ветках](Сквозная-история-в-ветках) \ No newline at end of file +* [Максимум скорости на историю](Максимум-скорости-на-историю.md) +* [Оперативное слежение за разработкой](Оперативное-слежение-за-разработкой.md) +* [Сращивание истории из нескольких хранилищ](Сращивание-истории-из-нескольких-хранилищ.md) +* [Сквозная история в ветках](Сквозная-история-в-ветках.md) \ No newline at end of file