wazuh-documentation icon indicating copy to clipboard operation
wazuh-documentation copied to clipboard

APT repositories: Debian 11.x (Bullseye) / Ubuntu 20.04 (Focal Fossa)

Open thetredev opened this issue 2 years ago • 4 comments

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 wazuh_elastic_deb10

Installing Elasticsearch: Debian 11 wazuh_elastic_deb11

Deploying Wazuh agents on Linux systems: Debian 10 wazuh_agent_deb10

Deploying Wazuh agents on Linux systems: Debian 11 wazuh_agent_deb11

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.

thetredev avatar Jun 11 '22 15:06 thetredev

Updated the description with a link to https://github.com/wazuh/wazuh-packages/issues/1623.

thetredev avatar Jul 25 '22 19:07 thetredev

After further investigation, I think I didn't hit all the spots ("Installing Ansible", for example). I'll comment again ASAP.

thetredev avatar Jul 25 '22 19:07 thetredev

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!

okynos avatar Sep 05 '22 09:09 okynos

Thank you! I think I missed the Ansible and Puppet documentation. Just tell me what to change if needed.

thetredev avatar Sep 05 '22 09:09 thetredev

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.

javimed avatar Oct 11 '22 12:10 javimed