LLTR Часть 1: Первые шаги в OMNeT++ и INET16.08.2018 08:34

OMNeT++ (Objective Modular Network Testbed in C++) Discrete Event Simulator — это модульная, компонентно‑ориентированная C++ библиотека и фреймворк для дискретно‑событийного моделирования, используемая прежде всего для создания симуляторов сетей. Попросту говоря это «симулятор дискретных событий», включающий: IDE для создания моделей, и сам симулятор (GUI).

INET Framework — «библиотека» сетевых моделей для OMNeT++.

Полная версия GIF (15.7 MiB)

В предыдущих частях…

0. Автоматическое определение топологии сети и неуправляемые коммутаторы. Миссия невыполнима? (+ classic Habrahabr UserCSS)

В этой части:

• создадим «свой первый» протокол (на примере LLTR Basic);
• выберем подходящий симулятор сити для отладки протокола (и создания его модели);
• познаем тонкости настройки окружения для симулятора и его IDE (конфигурирование, компиляция, линковка, тюнинг, патчинг, игнорирование устаревшей документации; и другие англицизмы в большом количестве);
• столкнемся со всем, с чем можно столкнуться, при создании своей первой модели своего первого протокола в не своем незнакомом симуляторе сети;
• пройдем весь путь вместе:
  • от счастья, принесенного успешной (наконец!) компиляции первого проекта с пустой сетью,
  • до полного погружения в эксперименты с функционирующей моделью протокола;
• tutorial, все описано в виде tutorial — мы будем учиться на ошибках — будем совершать их, и будем понимать их (природу), дабы элегантно/эффективно с ними справится;
• репозиторий (git ), в коммитах и тегах которого сохранены все шаги («Add…», «Fix…», «Fix…», «Modify…», «Correct…», …), от начала и до конца.

Note: дополнительная информация для читателей хаба «Mesh-сети».

{ объем изображений: 2.2+(2.1) MiB; текста: 484 KiB; смайликов: 22 шт. }

Note: [про используемую структуру разделов] структура разделов tutorial/how‑to обычно отличается от структуры разделов в справочнике: в справочнике — структура разделов позволяет за минимальное количество шагов дойти до искомой информации (сбалансированное дерево); в tutorial/how‑to, где разделы сильно связаны логически, а отдельный раздел, по сути, является одним из шагов в последовательности шагов, структура представляет собой иерархию закладок (якорей), которая позволяет в любом месте tutorial/how‑to напомнить (сослаться) о фрагменте описанном ранее.

# Первые шаги: «перед моделированием» / «мозговой штурм»

НЛОприлетелоиоставилоэтотпробелздесь? Обратная сторона листочка из предыдущей статьи.

# Детализация протокола

В начале определим, что нам нужно включить в протокол. На примере LLTR Basic.

Основа LLTR — это итерации сбора статистики на множестве хостов во время сканирования сети. Итераций в LLTR много (>1), поэтому первое, что нужно включить в протокол — управление запуском и остановкой каждой итерации. Если учесть, что хостов тоже много (>1), то управление будет заключаться в том, чтобы определенным способом сообщать всем хостам время начала итерации и время окончания итерации. То есть синхронизировать все хосты.

В каждой итерации есть свой unicast src хост и unicast dst хост, поэтому следующее, что нужно включить — способ назначения для каждой итерации unicast src и dst. То есть в каждой итерации один из хостов должен «осознавать» себя unicast src хостом, цель которого посылать трафик на unicast dst хост.

И последнее. По завершению всех итераций, всю собранную статистику со всех хостов нужно отправить на один хост для обработки. Этот хост проанализирует собранную статистику, и построит топологию сети.

Также, на этом шаге, можно подумать про некоторые детали реализации (ограничения) протокола. Например, мы хотим, чтобы программа, использующая LLTR, смогла работать без root прав, и из пространства пользователя (т.е. без установки в систему специального драйвера), значит, LLTR должен работать, например, поверх TCP и UDP.

Все остальные делали реализации, определятся сами, в процессе создания модели. То есть, конечно, можно сразу же продумать все до мелочей, но при этом есть риск «скатится в локальный оптимум», и не заметить «более лучший» вариант реализации. Хорошо, когда моделей будет несколько — если для каждого варианта реализации будет своя модель, то появится возможность комбинировать модели, и шаг за шагом приходить к лучшей реализации. Вспоминая генетический алгоритм ；）. Например, в одной реализации/модели может быть централизованное управление, в другой — децентрализованное, в третей — комбинация лучших частей из предыдущих двух вариантов.

# Выбор симулятора сети

Теперь настало время определится с симулятором сети, в котором будем создавать модели и ставить эксперименты.

В основном, от симулятора сети нам нужна возможность реализации «своего» протокола. Не все симуляторы позволяют легко это сделать.

А вот присутствие эмуляторов ОС реального сетевого оборудования «мировых брендов», наоборот — не нужно. Скорее всего, эмуляторы создадут множество ограничений, которые будут только мешать в ходе экспериментов.

С выбором симулятора мне помогла статья Evaluating Network Simulation Tools (наши требования к симулятору во многом совпадали) и OMNeT++ General 'Network' Simulation.

# Установка OMNeT++ и INET

Загружаем OMNeT++ 5.0.

И так как OMNeT++ — это всего лишь «симулятор дискретных событий», то понадобится еще и INET — библиотека сетевых моделей (протоколы и устройства). Качаем INET 3.4.0. На самом деле его можно было установить из IDE, но я рекомендую поставить вручную (позже будет ясно почему).

Установка в *nix и в Windows мало чем отличается. Продолжу на примере Windows.

Распаковываем OMNeT++ в %ProgramData% (C:\ProgramData\), и открываем файл INSTALL.txt (C:\ProgramData\omnetpp-5.0\INSTALL.txt). В нем сказано, что подробная инструкция находится в «doc/InstallGuide.pdf», дальше написано, что если не хотите ее читать, то просто выполните:

$. setenv
$ ./configure
$ make

Но не спешите это делать!

Во‑первых, обратите внимание на первую команду ». setenv». В директории «omnetpp-5.0» нет файла »setenv» (в версии 5.0b1 он был). Он и не нужен (для Windows), поэтому просто запускаем «mingwenv.bat» (советую перед запуском посмотреть, что он делает… во избежание внезапного rm). По окончании отколется терминал (mintty).

Во‑вторых, советую немного подправить файл «configure.user» (если упомянутый параметр закомментирован в файле, то его нужно раскомментировать):

• Если хотите использовать Clang (по умолчанию), то оставьте
  PREFER_CLANG=yes
  и настройте:
  • CFLAGS_RELEASE (опции компилятора):
    CFLAGS_RELEASE='-O2 -march=native -DNDEBUG=1'
• Если хотите использовать GCC вместо Clang (а вы, скорее всего, захотите использовать именно GCC, увидев, что написано в 398 строчке файла «configure.in»), то установите
  PREFER_CLANG=no
  и настройте:
  • CFLAGS_RELEASE (опции компилятора). Можно выбрать или
    CFLAGS_RELEASE='-O2 -mfpmath=sse,387 -ffast-math -fpredictive-commoning -ftree-vectorize -march=native -freorder-blocks-and-partition -pipe -DNDEBUG=1'
    или
    CFLAGS_RELEASE='-O2 -fpredictive-commoning -march=native -freorder-blocks-and-partition -pipe -DNDEBUG=1'
    или
    CFLAGS_RELEASE='-O2 -march=native -freorder-blocks-and-partition -pipe -DNDEBUG=1'
    (расположено в порядке уменьшения вероятности возникновения глюков).
  • Также стоит добавить CXXFLAGS в виде '-std=c++11 '+CFLAGS_RELEASE. Например:
    CXXFLAGS='-std=c++11 -O2 -fpredictive-commoning -march=native -freorder-blocks-and-partition -pipe -DNDEBUG=1'
  • JAVA_CFLAGS (просто раскомментируем):
    JAVA_CFLAGS=-fno-strict-aliasing
• PREFER_QTENV=yes
• Отключаем 3D визуализацию:
  WITH_OSG=no
  Она конечно красивая, но нам не понадобится.
• Параллельное (на множестве CPU) выполнение симуляции (WITH_PARSIM), к сожалению, тоже стоит отключить, однако без него компоновка (linker) завершается неудачей, поэтому оставим включенным:
  WITH_PARSIM=yes

Теперь в терминале (mintty) можно выполнить:

./configure && make clean MODE=release
make MODE=release –j17

Note: »17» следует заменить на количество ядер CPU + 1, либо на 1.5×ядер.

OMNeT++ использует Eclipse в качестве IDE. Для удобства можно создать ярлык на IDE »%ProgramData%\omnetpp-5.0\ide\omnetpp.exe», и расположить его в легкодоступном месте. В директории «ide/jre/» находится JRE v1.8.0_66-b18. Если в системе уже установлен совместимый JRE/JDK, то директорию «ide/jre/» можно спокойно удалить, заменив символьной ссылкой на местоположение системного JRE.

При первом запуске Eclipse предлагает поместить workspace в директорию «samples», однако лучше расположить ее в любой другой удобной вам директории вне »%ProgramData%». Главное, чтобы в пути к новой директории использовались только латинские буквы (+ символы), и не было пробелов.

После закрытия Welcome, IDE предложит установить INET (как было написано выше), и импортировать примеры — откажитесь от обоих пунктов.

Настало время установить INET. Директорию «inet» из скаченного ранее архива (inet-3.4.0-src.tgz) нужно перенести в workspace. В директории есть файл «INSTALL» с пошаговым описанием установки. Можно воспользоваться им (раздел «If you are using the IDE»), но только не собирайте (Build) проект!

Импортируем INET:

1. В Eclipse открыть: File > Import.
2. Выбрать: General / Existing Projects to the Workspace.
3. В качестве «root directory» выбрать местоположение workspace.
4. Удостоверьтесь, что опция «Copy projects into workspace» выключена.
5. После нажатия на кнопку «Finish», дождитесь окончания индексации проекта (% выполнения см. внизу, в строке статуса — «C/C++ Indexer»).

Настроим проект:

• A. отключим ненужные для LLTR компоненты;
• B. переключим сборку на релиз;
• C. избавимся от глюков «OMNeT++ Make Builder» (opp_makemake) — раньше, при его выборе, часто происходила перегенерирация Makefile, даже когда этого не требовалось;
• D. включим параллельную компиляцию;
• E. включим оптимизации;
• F. включим подсветку синтаксиса для c++11, в нескольких местах;
• G. подправить баг связанный с »#include» (случается, если несколько раз менять «Current builder»; может случиться и в других случаях).

Перед настройкой {A} надо подправить один из файлов проекта. В файле «inet/.oppfeatures» есть строка »inet.examples.visualization» нужно добавить после нее пустую строку, в которой написать »inet.tutorials.visualization», желательно сохранив отступ слева (по аналогии с другими параметрами »nedPackages» в файле). Если это не сделать, то ничего страшного не случится, просто после настройки в «Problems» (Alt+Shift+Q, X) будут всегда висеть ошибки, связанные с »inet.tutorials.visualization». Можно вначале сделать {A}, и посмотреть на ошибки, а затем подправить файл «inet/.oppfeatures» — при этом Eclipse предупредит о нарушении целостности в настройках, и предложит профиксить их (соглашаемся на это).

Приступим (панель «Project Explorer» >проект «inet» >контекстное меню >Properties):

1. Раздел «OMNeT++» > подраздел «Project Features»
   1. {A} убираем все, кроме:
      • TCP Common
      • TCP (INET)
      • IPv4 protocol
      • UDP protocol
      • Ethernet
   2. кнопка «Apply».
2. Раздел «С/С++ Build»:
   1. кнопка «Manage Configurations…» > сделать активным «gcc-release» {B};
   2. выбрать конфигурацию «gcc-release [ Active ]» {B}.
   3. Подраздел «Tool Chain Editor»:
      1. в качестве «Current builder» выбрать «GNU Make Builder» для обеих конфигураций: «gcc-debug» и «gcc-release» {C}, внимание: если в будущем изменить «Current builder», то все придется перенастраивать заново!
      2. кнопка «Apply».
   4. Вкладка «Behavior» (вернутся в корень раздела «С/С++ Build»):
      1. установить «Use parallel jobs» равным N (в качестве N можно выбрать либо число ядер CPU + 1, либо 1.5×ядер) — это позволит использовать все ядра CPU для компиляции {D} (настраиваем для «gcc-debug» и «gcc-release»).
   5. Вкладка «Build Settings»:
      1. отключить «Use default build command»;
      2. строку «Build command» заменить на »make MODE=release CONFIGNAME=${ConfigName} -j17» (»17» заменить на предыдущее значение в строке, т.е. на выбранный N) {E}, то же самое можно сделать и для конфигурации «gcc-debug», заменив в строке »MODE=release» на »MODE=debug», после этого не забудь переключиться обратно на «gcc-release [ Active ]».
   6. кнопка «Apply».
3. Раздел «С/С++ General»:
   1. Подраздел «Paths and Symbols»:
      1. Вкладка «Includes»:
         1. кнопка Add: добавить директорию »../src» с выбранными «Add to all configurations» и «Add to all languages» {G} — изначально »../src» есть в языке «GNU C++», но, в неопределенный момент, он может стереться из списка;
         2. кнопка «Apply», и проверь, что »../src» появилось во всех языках и конфигурациях.
      2. Вкладка «Symbols»:
         1. кнопка Add: добавить символ »__cplusplus» со значением »201103L» и выбранными «Add to all configurations» и «Add to all languages» — {F} подробнее;
         2. кнопка «Apply», и проверь, что в конфигурации «gcc-debug» у »__cplusplus» значение »201103L».
      3. Вкладка «Source Location»:
         1. Проверь, что в списке один пункт, и он указывает на »/inet/src» {G}, если там что‑то другое (например, просто »/inet»), то удаляй то, что есть и добавь («Add Folder…») »/inet/src». Затем кнопка «Apply», и возвращение к {A}, т.к. все фильтры при удалении были стерты. Кстати,»/inet» на самом деле можно оставить — с ним тоже все нормально собирается, но лучше сузить до оригинального »/inet/src».
   2. Подраздел «Preprocessor Include Paths, Marcos etc.» > вкладка «Providers»:
      1. Выбрать «CDT GCC Build-in Compiler Settings»:
         1. В группе «Language Settings Provider Options» нажать на ссылку «Workspace Settings»:
            1. вкладка «Discovery»: опять выбрать «CDT GCC Build-in Compiler Settings», и добавить »-std=c++11 » перед »${FLAGS}» в «Command to get compiler specs», должно получится примерно так `${COMMAND} -std=c++11 ${FLAGS} -E -P -v -dD "${INPUTS}"` {F}, подробнее здесь и здесь;
            2. кнопка «Apply», «Ok» (закрываем окно).
         2. переместить «CDT GCC Build-in Compiler Settings» выше «CDT Managed Build System Entries» (для обеих конфигураций: «gcc-release» и «gcc-debug») {F}, подробнее — после этого мы потеряем возможность переопределять символы «CDT GCC Build-in Compiler Settings» через «CDT Managed Build System Entries» («С/С++ General» >«Paths and Symbols» > «Symbols»), переопределить можно будет только через добавление значений в «CDT User Settings Entries» во вкладке «Entries» для каждого языка по отдельности (альтернатива: не меняем порядок, т.к. в «CDT Managed Build System Entries» уже исправили значение »__cplusplus»; не меняем порядок, удаляем все упоминания »__cplusplus» из «CDT Managed Build System Entries», и следим, чтобы он там не появлялся в будущем);
         3. кнопка «Apply», и проверить, что во вкладке «Entries» у языка «GNU C++» в «CDT GCC Build-in Compiler Settings» (чекбокс [в нижней части окна] «Show build-in values» должен быть включен) есть запись »__cplusplus=201103L» (она будет ближе к концу).
   3. Подраздел «Indexer»:
      1. в качестве «Build configuration for indexer» выбрать «gcc-release» {B};
      2. кнопка «Apply».

Некоторые проблемы могут возникнуть с {E}. Поясню. Если все нормально, то Eclipse должен подхватить те настройки, которые были заданы в «configure.user» перед конфигурированием OMNeT++ (./configure). В таком случае Eclipse передаст нужные параметры в g++ через make. Однако не всегда все идет, как планировалось, и лучше проверить, что происходит в реальности. Проверить можно, дописав в «Build command» {E} »--just-print» или »--trace», и, запустив сборку (панель «Project Explorer» >проект «inet» >контекстное меню >«Clean Project» и «Build Project»), открыть «Console» (Alt+Shift+Q, C), в нем должно выводится что‑то похожее на »g++ -c -std=c++11 -O2 -fpredictive-commoning -march=native -freorder-blocks-and-partition -pipe -DNDEBUG=1 …». Если этого нет, то можно последовать совету из уже упомянутой статьи.

Кстати, при некоторой сноровке, параметры запуска g++ можно было посмотреть, не используя флаги »--just-print» и »--trace», а используя Process Explorer. В Process Explorer также можно посмотреть, во что раскрывается »-march=native» при передаче в «cc1plus.exe».

Теперь, наконец, можно собрать INET! Проверьте, что сейчас активна конфигурация «gcc-release» {B}, и если добавляли ранее флаги »--just-print» или »--trace» для проверки {E}, то их нужно убрать. Собираем (панель «Project Explorer» >проект «inet» >контекстное меню >«Clean Project» и «Build Project»), за процессом можно наблюдать в «Console» (Alt+Shift+Q, C).

Если все прошло хорошо, то рекомендую закрыть Eclipse, и сделать бекап файла ».cproject» и директории ».settings» с настройками проекта {B-G}, а также файлов:».oppfeatures»,».oppfeaturestate»,».nedexclusions» — {A}.

Наконец, настройка завершена, и можно перейти к самому интересному.

# Создание первого проекта

Note: Первое, что я сделал после настройки окружения — стал изучать содержимое директории «doc» у OMNeT++ и INET. Это были Simulation Manual и User Guide, позже к ним присоединился Stack Overflow (в виде stackoverflow.com, и в виде состояния мозга). Ниже я покажу, как можно сделать первые шаги, не читая всю документацию, и расскажу, с какими «особенностями» можно столкнуться.

Note: Для тех, кто еще не успел установить себе OMNeT++ и INET, но уже хочет посмотреть на код, текст ниже содержит ссылки на исходники INET в GitHub. Все ссылки ведут на исходники версии 3.4.0 (эти ссылки будут доступны всегда, даже если в будущих версиях расположение файлов в INET изменится).

Перед созданием своего проекта хорошо бы посмотреть на уже готовые модели в INET, посмотреть, как они устроены. Может в нем уже реализовано то, что нам нужно?

После непродолжительного блуждания по дереву INET в «Project Explorer», можно наткнуться на директорию «inet/src/inet/applications», и обнаружить в ней «udpapp» (UDP Application). UDP пригодится нам для broadcast рассылки. Внутри директории лежат несколько моделей, и, судя по названию и размеру исходников, самый простой из них, это «UDPEchoApp». Там есть еще и «UDPBasicApp», но он оказался не таким уж и «Basic». Каждая модель состоит из ».cc»,».h» и ».ned» файлов. Пока не ясно, зачем нужны ».ned» файлы, но судя по их содержанию (наличию строчки "parameters:») в них могут описываться параметры модели.

Продолжим поиски интересных моделей. Посмотрим, какие примеры (inet/examples) есть в INET. И нам повезло, в нем есть пример с названием «broadcast» (inet/examples/inet/broadcast)! Этот пример помимо файлов ».cc»,».h» и ».ned», содержит еще ».ini» и ».xml» файлы. Пора разобраться, зачем эти файлы нужны:

• .ned — файл/язык, описывающий либо модель сети (Network), либо простейшие блоки (Simple modules) «кирпичики», из которых можно собирать модули (Compound module). В целом это выглядит так (картинка), т.е. можно собрать модель сети, и провести несколько экспериментов не написав ни одной строчки на C++.
• omnetpp.ini — файл, в котором можно задать/переопределить параметры модели. Если нужно провести несколько экспериментов с разными параметрами, то всех их можно перечислить (Named Configurations) в этом же файле.
• .xml — просто файл с настройками, которые считывает один из используемых модулей (IPv4NetworkConfigurator).

К сожалению, этот пример («broadcast») нам не подойдет, т.к. в его сеть включены маршрутизаторы. Однако, по аналогии с ним, можно создать свой проект.

Note: Далее я продолжу ссылаться на разные разделы Simulation Manual. Как видите, он достаточно большой, браузеру требуется время (и RAM) для его открытия. Для решения этой проблемы я сделал небольшой JS‑bookmarklet. После его запуска все ссылки, ведущие на разделы Simulation Manual, перестанут плодить вкладки (пожирая ресурсы), и начнут переключать разделы в одной единственной дополнительной вкладке (на самом деле он просто прописывает target для каждой ссылки на Simulation Manual). Bookmarklet расположен в первом комментарии к этой статье. И, для того, чтобы отличить ссылки на Simulation Manual от остальных ссылок, bookmarklet изменяет их цвет.

# Создаем проект

Пустой проект «LLTR», с директориями «src» и «simulations», и единственной конфигурацией «gcc-release» (File → New → OMNeT++ Project…):

Осталось настроить проект также как и «inet», и можно будет двигаться дальше. В основном, настройка будет отличаться отсутствием необходимости настраивать «gcc-debug» (т.к. он отсутствует в «LLTR»), и добавлением в зависимости «inet». Более конкретно: вместо {A, B, G} надо открыть раздел «Project References», и включить зависимость от «inet».

# Структура проекта

Если посмотрите на файлы, которые создал Wizard, то увидите, что файл «package.ned» встречается дважды: в директории «src», и в «simulations». Содержимое тоже отличается — »package lltr;» и »package lltr.simulations;» соответственно. Один из этих файлов нам не понадобится.

Если провести аналогию со структурой проекта INET, то директория «inet/src» — это «LLTR/src», а «inet/examples» — это «LLTR/simulations». То есть в «LLTR/simulations» лучше размещать файлы ».ned» c Network, а в «LLTR/src» — составные части сети (модули).

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

В свете вышеописанного,».ned» в директории «LLTR/src» нам не нужен (все будет в «inet/src»), также как и не нужен дополнительный подпакет »package lltr.simulations;» в «LLTR/simulations». Поэтому переносим «package.ned» из «LLTR/src» в «LLTR/simulations».

# Пробный запуск

Попробуйте запустить LLTR. Для этого достаточно открыть файл «LLTR/simulations/omnetpp.ini», и нажать (Run >Run As > 1 OMNeT++ Simulation):

При этом Eclipse предложит создать новую конфигурацию «simulations» для запуска симулятора. Соглашаемся, и сразу же сталкиваемся с проблемой: «LLTR/src/LLTR.exe» не был найден. Все верно, ведь «LLTR.exe» никто не собирал, поэтому вначале собираем проект (меню Project → Build Project), а затем опять запускаем симулятор (тем же самым способом).

После запуска симулятора появилось предупреждение «No network specified in the configuration.», его можно исправить, добавив строку »network = lltr.Network» в секцию »[General]» файла «omnetpp.ini», и добавив строку »network Network {}» в конец файла «package.ned». Этим мы создали пустую сеть (в ».ned» файле), и настроили (в ».ini» файле) симулятор на загрузку этой сети (Network — имя сети) при запуске.

Теперь можно попробовать опять запустить симулятор (Run >Run As > 1 OMNeT++ Simulation), и вместо ошибки должно открыться серое поле (прямоугольник) сети Network на зеленом фоне.

Note: Есть различие между запуском через (Run >Run As > 1 OMNeT++ Simulation), и через (Run > 1 simulations): в первом случае запуск проходит быстрее, т.к. во втором случае, перед запуском симулятора, Eclipse начинает собирать проект.

Note: (или можно форкнуть — тег a1_v0.1.0 («a» — article) »git checkout -b ‹my_branch› tags/a1_v0.1.0»)

# Рекомендации по использованию репозитория

Репозиторий я создавал таким образом, чтобы:

• каждый шажок из tutorial совпадал с коммитом в git;
• можно было легко сослаться из tutorial на конкретный коммит — для этого каждый значимый коммит имеет свой тег;
• можно было клонировать (скачать) к себе только коммиты, относящиеся к текущей части (article) — для этого каждая часть имеет свою ветку (формат имени: «article_#»), указывающую на последний коммит/тэг части;
• любой смог легко создавать свою версию исходного кода из репозитория, «шагая» по tutorial.

Note: без веток «article_#» можно было бы обойтись, и указывать, при клонировании, название последнего тега части (которое еще надо найти), но с веткой проще/быстрее.

Как забрать репозиторий «к себе»? Лучше всего, вначале его форкнуть на GitHub, а затем свой форк:

Далее, для создания личной ветки на основе конкретного тега, можно использовать »git checkout -b ‹my_branch› tags/‹tag_name›».

Как создавать свою версию кода, т.е. изменять код? Если в будущем не возникнет желания сделать Pull Request, то ничего вам не мешает делать с форком что хотите >:-), однако я советую, при появлении изменений, которые хочется сохранить, делать так):

Одинаковая схема наименования тегов поможет в будущем избежать коллизий, даже не смотря на то, что теги при Pull Request не переносятся.

Note: Если я в будущем буду вносить изменения в репозиторий, то я поступлю также: оригинальный код сохранится, а измененный будет идти параллельно оригинальному (с »накатанными» всеми изменениями из остальных (будущих) тегов, и с новыми именами тегов). Только вместо добавления »-u» к именам новых тегов тегам, я буду увеличивать номер. Например, теги оригинального кода «a1_v0.1.0», «a1_v0.2.0», … — теги измененного кода «a1_v0.1.1», «a1_v0.2.1», … При следующем изменении, номер еще раз увеличится: «a1_v0.1.2», «a1_v0.2.2», …

Note: в tutorial все места, завершающие очередной «шажок», помечены значком git , и рядом с ним будет ссылка на соответствующий git tag.

Note: git diff использовался стандартный, патчи генерировались автоматически, и они редко будут показывать логической связи в произошедших изменениях (в частн

© Habrahabr.ru