You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

3
+
This role will add the Elastic repositories to the package manager (dnf/yum. apt or zypper). It will not install packages (these can be done with the role `elasticsearch`).
5
4
6
-
The role adds Elastic repositories to the package manager. It's main use is in connection with other roles that provide installation and configuration of the Elastic Stack.
7
-
8
-
Requirements
9
-
------------
5
+
## Requirements
10
6
11
7
GPG needs to be installed on the systems to verify the package signature. This will be installed as part of the role. Below you can find a list of packages that will be installed.
12
8
* Debian family: `apt-transport-https`, `gpg` and `gpg-agent`
@@ -15,25 +11,28 @@ GPG needs to be installed on the systems to verify the package signature. This w
15
11
16
12
For SuSE hosts you will need the Ansible collection `community.general` on your Ansible controller.
17
13
18
-
Role Variables
19
-
--------------
14
+
## Variables
15
+
16
+
There are variables that are needed in more than one role of the collection. These are defined inside the "meta" role `elasticstack`. The role `elasticstack` is imported in this role.
20
17
21
-
**elasticstack_release*: Major release version of Elastic stack to configure. (default: `7`). `7` and `8` are supported.
22
-
**elasticstack_variant*: Variant of the stack to install. Valid values: `elastic` or `oss`. (default: `elastic`).
23
-
**elasticstack_enable_repos*: Enable repositories after creating them. (default: `true`) Only works on RPM based distributions!
18
+
**List of variables from `elasticsearch` used inside `repos`:**
19
+
*`elasticstack_release`: Major release version of Elastic stack to configure. (default: `7`). `7` and `8` are supported.
20
+
*`elasticstack_variant`: Variant of the stack to install. Valid values: `elastic` or `oss`. (default: `elastic`).
24
21
25
22
Please note that no `oss` versions are available for Elastic Stack later than `7`. This role will fail if you try to install them.
26
23
27
-
Usage
28
-
--------
24
+
**Variables that are explicity defined inside `repos`:**
25
+
*`repos_enable_repos`: Enable repositories after creating them. Only works on RPM based distributions (default: `true`)
26
+
27
+
## Usage
29
28
30
-
Upgrades
31
-
========
29
+
### Upgrades
32
30
33
-
If you want to be able to update your operating system without worrying about accidentally upgrading Elastic Stack, set `elasticstack_enable_repos` to `false`. The roles in this collection will enable the repository in case they need it. Keep in mind that this will only work on rpm based distributions.
31
+
If you want to be able to update your operating system without worrying about accidentally upgrading Elastic Stack, set `repos_enable_repos` to `false`. The roles in this collection will enable the repository in case they need it. Keep in mind that this will only work on rpm based distributions.
34
32
35
-
Example playbook
36
-
================
33
+
### Example playbook
34
+
35
+
The following playbook will add the Elastic repository to the package manager.
0 commit comments