Libelektra: remover barreiras de entrada

Criado em 1 nov. 2020  ·  3Comentários  ·  Fonte: ElektraInitiative/libelektra

  • [ ] retrabalho principal README.md
  • [ ] cobre por que escrever no sistema precisa de root
  • [ ] tutorial do primeiro passo (get/set) com TOML
  • [ ] reescrever doc/COMPILE.md para um tutorial orientado a problemas (como instalar sem root)
  • [ ] doc/TESTING.md: descreve como executar kdb run_all sem root
  • [ ] tutorial de anúncio/visão geral #2742
  • [ ] + vídeo deste tutorial
  • [ ] Tutorial METADATA.ini
  • [ ] Tutorial para iniciantes em Java com maven
  • [ ] executa testes sem root
  • [ ] Página principal do documento da API

@robaerd @dev2718 você pode fornecer mais informações sobre quais barreiras de entrada você atingiu?

Todos 3 comentários

Para mim foi a instalação do elektra sem root.
A instalação sem root requer alguns sinalizadores cmake (KDB_DB_SYSTEM, CMAKE_INSTALL_PREFIX, ...) e variáveis ​​de ambiente (LD_LIBRARY_PATH, ..) a serem definidas. Embora CMAKE_INSTALL_PREFIX seja descrito em doc/COMPILE , não era óbvio para mim quais sinalizadores e envs de cmake precisam ser definidos para isso.
Em doc/Testing.md na seção "Você tem algumas opções para evitar executá-los como root:" , a invocação de cmake a seguir é referenciada: scripts/configure-home (o btw deve ser scripts/dev/configure-home ). Este exemplo cobre apenas a compilação e não a instalação (falta o sinalizador CMAKE_INSTALL_PREFIX). Como kdb run_all também é descrito em doc/TESTING.md , deve, pelo menos na minha opinião, ser mencionado também como fazer isso funcionar sem root.

As etapas em doc/tutorials/run_all_tests_with_docker.md - que na verdade são referenciadas em doc/TESTING.md - descrevem como instalá-lo como usuário não raiz, mas não é mencionado que as imagens do docker são executadas como não raiz. Então, no começo, estava um pouco claro para mim por que essas coisas precisavam ser definidas apenas aqui.

Eu proporia:

  • adicione uma descrição de que as imagens do docker são executadas como não raiz (e talvez também o motivo disso).
  • adicione um ponto a doc/INSTALL.md e/ou doc/TESTING.md sobre como instalar o elektra sem privilégios de root.

Muito obrigado por esta contribuição muito útil!

Embora CMAKE_INSTALL_PREFIX seja descrito em doc/COMPILE

Sim, concordo plenamente, este documento deve ser reescrito para um estilo onde os problemas concretos sejam resolvidos (como instalar sem root). A única descrição do que os sinalizadores fazem é melhor feita no arquivo CMake-cache-variable-docu.

mas não é mencionado que as imagens do docker são executadas como não raiz

Espero que você possa melhorar os tutoriais sobre imagens do Docker :sparkling_heart:, você precisa adaptá-los de qualquer maneira com as alterações que fizer (como remover a necessidade do usuário Jenkins).

as imagens do docker são executadas como não-raiz (e talvez também a razão para isso).

Você quer dizer a razão pela qual eles são executados como não-root? É uma prática recomendada executar algo com a quantidade mínima de privilégios possível.

Em geral: é bom não assumirmos muito conhecimento sobre Docker ou Jenkins em nosso docu, pois muitas pessoas não o possuem. Então eu concordo, que tal justificativa deve ser dada.

Espero que você possa melhorar os tutoriais sobre imagens do Docker 💖, você precisa adaptá-los de qualquer maneira com as alterações que fizer (como remover a necessidade do usuário Jenkins).

Sim, claro que vou melhorar os tutoriais sobre as imagens do Docker.

Esta página foi útil?
0 / 5 - 0 avaliações

Questões relacionadas

sanssecours picture sanssecours  ·  4Comentários

markus2330 picture markus2330  ·  3Comentários

sanssecours picture sanssecours  ·  4Comentários

markus2330 picture markus2330  ·  4Comentários

mpranj picture mpranj  ·  4Comentários