wazuh-documentation
wazuh-documentation copied to clipboard
APT repositories: Debian 11.x (Bullseye) / Ubuntu 20.04 (Focal Fossa)
Description
Coming from #5297
Currently (Wazuh version 4.3/4.4 docs), the APT
tabs for adding the various repositories to the package manager contain outdated information when it comes to Debian 11 (Bullseye). I modified these parts by moving each deb/add_repository.rst
into their respective versions: deb/add_repository/10.rst
and deb/add_repository/11.rst
:
RST file | Debian releases | Ubuntu releases |
---|---|---|
10.rst |
10.x (Buster) and earlier | 18.04 (Bionic Beaver) and earlier |
11.rst |
11.x (Bullseye) and later | 20.04 (Focal Fossa) and later |
The difference being the fact that apt-key
has been deprecated since Debian 11 (Ubuntu 20.04 marks the first release based on Debian 11). The instructions are basically copied from the Docker installation instructions for Debian.
I have tested the instructions themselves on a Debian 11 machine and made sure the documentation builds (make html
).
Some exemplary screenshots to visualize my change:
Installing Elasticsearch: Debian 10
Installing Elasticsearch: Debian 11
Deploying Wazuh agents on Linux systems: Debian 10
Deploying Wazuh agents on Linux systems: Debian 11
Checks
- [x] It compiles without warnings.
- [x] Spelling and grammar.
- [x] Used impersonal speech.
- [x] Used uppercase only on nouns.
- [ ] Updated the
redirect.js
script if necessary (check this guide).
Note to the reviewer
-
redirect.js
didn't need an updated if I understood the instructions correctly. - I don't know if the tab names are correct / pleasant to read. Please propose a change if necessary.
Updated the description with a link to https://github.com/wazuh/wazuh-packages/issues/1623.
After further investigation, I think I didn't hit all the spots ("Installing Ansible", for example). I'll comment again ASAP.
Hello @thetredev,
I have reviewed your PR. It looks good, but I will need the review of @wazuh/content. This matter will need a decision of @snaow and @santiago-bassett about the approach to solving the issue in older systems like Ubuntu 14 or Debian 8 and older. It's not trivial because Debian and Ubuntu security strategies collide. In addition, we will need to review Ansible and Puppet deployments to match these guidelines.
We will reply with a decision as soon as possible. Again thanks!
Thank you! I think I missed the Ansible and Puppet documentation. Just tell me what to change if needed.
Hi. Thank you for your help to solve the related issue. Although this PR looks fine we've opted to implement the solution with a slightly different approach as you can see in PR 5574. Thank you.