Libelektra: убрать входные барьеры

Созданный на 1 нояб. 2020  ·  3Комментарии  ·  Источник: ElektraInitiative/libelektra

  • [ ] переработать основной README.md
  • [ ] объясняет, почему для записи в систему требуется root
  • [ ] руководство по первому шагу (получение/установка) с TOML
  • [ ] переписать doc/COMPILE.md в проблемно-ориентированное руководство (например, установка без рута)
  • [ ] doc/TESTING.md: опишите, как запустить kdb run_all без рута
  • [ ] реклама/обзор туториал #2742
  • [ ] + видео этого урока
  • [ ] Руководство по METADATA.ini
  • [ ] Учебник для начинающих по Java с maven
  • [ ] запускать тесты без рута
  • [ ] Главная страница документа API

@robaerd @dev2718, не могли бы вы рассказать, какие входные барьеры вы

Все 3 Комментарий

Для меня это была установка Электры без рута.
Установка без рута требует установки нескольких флагов cmake (KDB_DB_SYSTEM, CMAKE_INSTALL_PREFIX,...) и переменных env (LD_LIBRARY_PATH, ..). Хотя CMAKE_INSTALL_PREFIX описан в doc/COMPILE , для меня не было очевидным, какие флаги cmake и envs нужно установить для этого.
В doc/Testing.md в разделе «У вас есть некоторые варианты, чтобы избежать запуска их от имени пользователя root:» упоминается следующий пример вызова cmake: scripts/configure-home (кстати, на самом деле должно быть scripts/dev/configure-home ). В этом примере рассматривается только компиляция, а не установка (флаг CMAKE_INSTALL_PREFIX отсутствует). Поскольку kdb run_all также описан в doc/TESTING.md , по крайней мере, на мой взгляд, следует также упомянуть, как заставить это работать без рута.

Шаги в doc/tutorials/run_all_tests_with_docker.md , которые фактически упоминаются в doc/TESTING.md , описывают, как установить его от имени пользователя без полномочий root, но не упоминается, что образы докеров запускаются без полномочий root. Так что вначале мне было немного непонятно, почему эти вещи нужно было устанавливать только здесь.

Я бы предложил:

  • добавьте описание того, что образы докеров запускаются без полномочий root (и, возможно, также причина этого).
  • добавьте точку в doc/INSTALL.md и/или doc/TESTING.md о том, как установить elektra без привилегий root.

Большое спасибо за этот очень полезный вклад!

Хотя CMAKE_INSTALL_PREFIX описан в doc/COMPILE

Да, я полностью согласен, этот документ должен быть переписан в стиле, где решаются конкретные проблемы (например, установка без рута). Единственное описание того, что делают флаги, лучше сделать в документе CMake-cache-variable-docu.

но не упоминается, что образы докеров запускаются без полномочий root

Я надеюсь, что вы сможете улучшить руководства по образам Docker :sparkling_heart:, вам все равно придется адаптировать их с внесенными вами изменениями (например, устранить необходимость в пользователе Jenkins).

образы докеров запускаются без полномочий root (и, возможно, также причина в этом).

Вы имеете в виду причину, по которой они работают без полномочий root? Лучше всего запускать что-то с минимальным количеством привилегий.

В целом: хорошо, если мы не будем предполагать слишком много знаний о Docker или Jenkins в нашем документе, так как у многих людей их нет. Так что я согласен, что такое обоснование должно быть дано.

Я надеюсь, что вы сможете улучшить руководства по образам Docker 💖, вам все равно придется адаптировать их с внесенными вами изменениями (например, устранить необходимость в пользователе Jenkins).

Да, конечно, я буду улучшать туториалы по образам Docker.

Была ли эта страница полезной?
0 / 5 - 0 рейтинги