Andrew Kumanyaev

Gitlab repository management book - review

Tags: gitlab, book, and review

В декабре прошлого года ознакомился с творением Jonathan M. Hethey, а именно с книгой Gitlab repository management. Вот об этой самой книге и пойдет речь.

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

Gitlab repository management

Поехали

Когда я узна о возможности написать обзор книги - сразу отозвался. Могу сразу заявить - я могу компетентно судить о том, что там написанно, так как с 2012 года плотно работаю с Gitlab'ом. Правда сейчас не столь активно участвую в жизни коммьнити, но все также продолжаю дорабатывать его. Итак, сомнений о моей компетенции не осталось, поэтому приступим к обзору.

Сразу обращу внимание на стоимость книги:

Book prices

  • £10.19 - и вы получите электронную копию
  • £19.99 - печатный вариант + небольшие плюшки

Вроде бы не много... Какой там не много... Я все понимаю, но 550 - 1100 рублей???? Серьезно? За что? За 71 страницу текста с картинками? Хм. Ну давайте разберемся за что...

О чем эта книга

В книге 8 глав (на 70+ страниц то):

  • Kickstarting with GitLab
  • Installation
  • Configuring GitLab
  • Roles and Permissions
  • Issues and Wikis
  • Workflows
  • Updating GitLab
  • Help and Community

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

Подробнее о чем эта книга:

  • Глава 1, Быстрое знакомство с GitLab, охватывает краткое представление GitLab, его основные черты и происхождение проекта.
  • Глава 2, Установка, охватывает подготовку окружающей среды, установки зависимостей и самого GitLab на машинке с Linux.
  • Глава 3, Настройка GitLab, объясняет основы конфигурации в соответствии с вашим потребностям с точки зрения безопасности в GitLab.
  • Глава 4, Роли и разрешения, охватывает изучение веб-интерфейса. Вы также узнаете, как использовать роли внутри GitLab, как предоставляются права на основе ролей, про ограничения доступа, а также как создать команды, которые работают хорошо.
  • Глава 5, Issue и Wiki, охватывает документацию программного обеспечения и его развития на основе встроенных вики. Использование трекера ошибок внутри GitLab и как задать вопросы разработчикам, также будут освещаться в этой главе.
  • Глава 6, Рабочие процессы, исследует различные стили работы с Git и GitLab. Вы также узнаете, как найти правильный рабочий процесс и посмотреть, как GitLab поддерживает эту идею.
  • Глава 7, Обновление GitLab, охватывает создание резервных копий, остановку служб, и обновления для последней версии. Вы также будем запускать тесты.
  • Глава 8, Помощь и сообщества, охватывает связь с сообществом и разработчиками. Вы также узнаете, различные каналы и где Вы можете оставить пожелания или внести взносы в проект.

Ох. Честно говоря - мне было лень перепечатывать оглавление (его опсиание), и список выше - результат работы гуглтранслейта.

А теперь пробежимся поподробнее...

Быстрый старт с Gitlab

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

Gitlab has many features

Все понятно сразу стало :+1:

Также расскажут о том, что веб интерфейс похож на интерфейс Github.

Давайте сразу зададим вопрос:

Вы бы купили эту книгу если бы не были знакомы с Gitlab за такие деньги?

Я бы нет. Это просто не разумно.

Значит вполне вероятно что вы знакомы с интерфейсом Gitlab...

И к тому же, кстати, вы можете легко посмотреть на скриншоты на официальном сайте и даже опробовать демку!

И я еще раз задам этот вопрос: На кой.... зачем мне читать про то, на что похож интерфейс?

Еще вам расскажут о том, что есть "облако" у Gitlab. И даже дадут ссылку на него... Несмотря на то, что я знаю о его существовании, все-таки перешел по ссылке:

Gitlab cloud

Может быть вам больше повезет... Не знаю.

В общем это была рекламная глава и... Честно, для тех кто хоть немного знаком с Gitlab - она на 90% бесполезна.

Установка Gitlab

Я молча оставлю тут несколько ссылок:

Да этих гайдов - до кучи. Уже написано куча рецептов для автоматической установки. Либо запускай рецепт, либо копируй - вставляй из оффициального гайда. Что-то я сомневаючь что эта глава хоть как-то актуальна. В книге написано о 5-м Gitlab - скоро выйдет 7-й. Так что ее можно смело пропускать.

Конфигурирование Gitlab

Вот если бы в этой главе было описано о том, что каждая опция значит и почему. Что зависит от того, что вы выставите в конфигурации - цены этой главе не было бы. А так - там написано про:

Скопируйте файл и поменяйте там то, что посчитаете нужным.

Супер! Я прыгаю в восторге от того, что это написано в книге. Вы только посмотрите насколько качественно задокументированы конфигуровочные файлы:

Что вам там не понятно? А теперь пробегите по диагонали то, что написано в официальном гайде по установке. Или перейдите по ссылкам:

В книге вы увидете то же самое, только морально устаревшее.

Roles and Permissions

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

Но... Информация актуальна только частично.

Issues and Wikis

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

Workflows

Несколько раз перечитывал эту главу и задавался вопосом, почему Workflows, а не Workflow. Мне лично эта глава была бесполезна. Не понятно, зачем там притянули за уши некоторые вещи... Попытка не плохая, но... нет. Плохая. Ибо не было выполнено то, что было заявлено.

Updating GitLab

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

Help and Community

Реально полезная глава! Вы не поверите, но после прочтения книги, куча ваших вопросов не пропадет, и вы теперь будете знать, куда с ними податься. За эту главу спасибо :) :+1:

Подведу итог

Вспомним цифры:

  • £10.19 - и вы получите электронную копию
  • £19.99 - печатный вариант + небольшие плюшки

Это за 88 страниц в электронном виде. Вы увидете много листингов кода и картинок, мало ответов на свои вопросы. Нет, за эти деньги я не стал бы покупать эту книгу. Совершенно бесполезная трата денег.

За, скажем, $5-$7 - можно. При этом часть информации в книге жутко не актуальна. Я об этом знаю - а вы нет. Так что не удивлюсь если что-то сделаете не так и не будете понимать, почему что-то не работает.

Мой совет:

  • Следите за коммюнити
  • Читайте документацию (Дима заложил прекрасную основу и выдержал требования по поддержки актуальности). Лучше читайте офф. документацию.
  • На вопросы часто быстро отвечают в IRC
  • Не бойтесь создавать Issue.

Всем добра!