centos:ansible:basics

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Letzte ÜberarbeitungBeide Seiten der Revision
centos:ansible:basics [28.06.2020 12:10. ] – [Variablen] djangocentos:ansible:basics [29.03.2022 18:17. ] – [Ansible] django
Zeile 1: Zeile 1:
 ====== Ansible ====== ====== Ansible ======
 {{:centos:ansible:ansible_logo.png?nolink&125 |Bild: Ansible Logo}}  {{:centos:ansible:ansible_logo.png?nolink&125 |Bild: Ansible Logo}} 
-Einzelne Serversysteme mag man durchaus noch manuell einzeln installieren, konfigurieren und pflegen mögen und auch durchaus können. Komplexere Installationen, oder gleichartige Installationen lassen sich so aber nicht mehr ressourcenschonend und transparent nachvollziehbar betreiben. In solchen Umgebungen bedient man sich der Automatisierung bzw. Orchestrierung. +Einzelne Serversysteme mag man durchaus noch manuell einzeln installieren, konfigurieren und pflegen mögen und auch durchaus können. Komplexere Installationen, oder gleichartige Installationen lassen sich so aber nicht mehr ressourcenschonend und transparent nachvollziehbar betreiben. Daher wird man aus folgenden Gründen bestrebt sein, für diese Aufgaben ein Konfigurationsmanagement zu verwenden: 
 +  * Wiederkehrende und auch regelmässige Konfigurationsaufgaben und Tätigkeiten sollen automatisiert werden, um somit, 
 +  * Fehler bei manuellen Tätigkeiten bei copy & Paste, z.B. aus Dokumentationen wie z.B. aus diesem WIKI hier zu vermeiden, um auch dadurch 
 +  * wertvolle Ressourcen im speziellen hier die Arbeits- und Lebenszeit einzusparen. Darüber hinaus möchten wir auch sicherstellen, dass 
 +  * Aufgaben reproduzierbar nachvollzogen und auch bei Bedarf versioniert werden können. Zu guter Letzt wollen wir auch aus Sicherheitsaspekten \\ heraus die Administration und Konfiguration von einer zentralen Stelle aus bewerkstelligen und absichern. 
 + 
 +Genau in solchen Umgebungen bedient man sich daher der Automatisierung bzw. Orchestrierung. 
  
 Doch was versteht man nun unter diesem Begriff Orchestrierung? Orchestrierung beschreibt das flexible Kombinieren mehrerer Services bzw. Dienste wie auch unterschiedlicher Serverinstanzen zu einer sinnvollen (Gesamt-)Konzeption oder auch Komposition. So wird man den Webserver erst starten, wenn zuvor der Datenbank und z.B. das NAS zur Verfügung steht und nicht umgekehrt.  Doch was versteht man nun unter diesem Begriff Orchestrierung? Orchestrierung beschreibt das flexible Kombinieren mehrerer Services bzw. Dienste wie auch unterschiedlicher Serverinstanzen zu einer sinnvollen (Gesamt-)Konzeption oder auch Komposition. So wird man den Webserver erst starten, wenn zuvor der Datenbank und z.B. das NAS zur Verfügung steht und nicht umgekehrt. 
Zeile 11: Zeile 17:
   - Ansible kann in der Community Edition kostenlos genutzt werden. Darüber hinaus bietet aber Red Hat aber auch kostenpflichtige Editionen mit grafischer Oberfläche und Support an.   - Ansible kann in der Community Edition kostenlos genutzt werden. Darüber hinaus bietet aber Red Hat aber auch kostenpflichtige Editionen mit grafischer Oberfläche und Support an.
   - Eine der grössten Vorteile von Ansible, sind die vorgefertigten "Playbooks", die z.B. auf GitHub von vielen fleissigen Helfern der Community zur Verfügung gestellt werden. Bei diesen Playbooks handelt es sich um vorgefertigte Scripte, mit denen Server automatisiert bereitgestellt und konfiguriert werden können. Somit muss nicht für jede Anwendung erneut eine neue Konfigurationsvorgehensweise geschrieben werden um eine Anwendung zu orchestrieren. Dank dieser vorgefertigten Playbooks ist die Automatisierung also wesentlich einfacher. Alle Konfigurationsinformationen werden in diesen Ansible Playbooks gesammelt und auf die im Host Inventory gespeicherten Hosts ausgerollt.   - Eine der grössten Vorteile von Ansible, sind die vorgefertigten "Playbooks", die z.B. auf GitHub von vielen fleissigen Helfern der Community zur Verfügung gestellt werden. Bei diesen Playbooks handelt es sich um vorgefertigte Scripte, mit denen Server automatisiert bereitgestellt und konfiguriert werden können. Somit muss nicht für jede Anwendung erneut eine neue Konfigurationsvorgehensweise geschrieben werden um eine Anwendung zu orchestrieren. Dank dieser vorgefertigten Playbooks ist die Automatisierung also wesentlich einfacher. Alle Konfigurationsinformationen werden in diesen Ansible Playbooks gesammelt und auf die im Host Inventory gespeicherten Hosts ausgerollt.
-  - Ein weiterer Vorteil von Ansible, ist der Umstand dass kein separater eigener Server aufgesetzt werden muss, um Ansible und seine Paybooks zu nutzen. Der (Client-)Rechner, auf dem die Playbooks zur Verfügung stehen, müssen nur die Server, die automatisiert verwaltet und konfiguriert werden sollen, mit Hilfe der SSH erreichen werden können. \\ Ansible arbeitet im Push-Verfahren und benötigt neben SSH und Python keine weitere Installation auf den einzelnen Systemen.  +  - Ein weiterer Vorteil von Ansible, ist der Umstand dass kein separater eigener Server aufgesetzt werden muss, um Ansible und seine Paybooks zu nutzen. Der (Client-)Rechner, auf dem die Playbooks zur Verfügung stehen, müssen nur die Server, die automatisiert verwaltet und konfiguriert werden sollen, mit Hilfe der SSH erreichen werden können. \\ Ansible arbeitet im Push-Verfahren und benötigt daher neben SSH und Python __keine__ weitere Installation auf den einzelnen Systemen.  
-  - Gegenüber Chef und Puppet ist die einfachere Verwaltung und Verwendung von Ansible, da z.B. keine zusätzliche Software auf dem zu verwaltenden System benötigt wird. Die Definitionen erfolgen im JSON-Format. Zusätzliche optionale Module können aber auch in jeder beliebigen Programmiersprache geschrieben sein. Hauptsächlich werden [[https://yaml.org/|YAML]]-basierten Skripte, die als "Playbooks" bezeichnet werden, zur Orchestrierung der Systeme verwendet. +  - Gegenüber Chef und Puppet ist die einfachere Verwaltung und Verwendung von Ansible, da z.B. keine zusätzliche Software auf dem zu verwaltenden System benötigt wird. Die Definitionen erfolgen im JSON-Format. Zusätzliche optionale Module können aber auch in jeder beliebigen Programmiersprache geschrieben sein. Hauptsächlich werden [[https://yaml.org/|YAML]]-basierten Skripte, die als "Playbooks" bezeichnet werden, zur Orchestrierung der Systeme verwendet. \\ Gegenüber anderen Konfigurationstools wird bei Ansible mit der Beschreibung des gewünschten Sollzustandes verfolgt und nicht die Abarbeitung granularer Einzelschritte z.B. in einem Script beschrieben. Darüber hinaus werden bei Ansible auch immer nur die Arbeitsschritte ab gearbeitet und erledigt, die aktuell nötig sind und nicht stur eine Abfolge von Einzeltätigkeiten perlenkettenmässig abgearbeitet. Aufgaben lassen sich so beliebig oft ausführen, ohne dass negative Seiteneffekte durch mehrmaliges unnötiges Abarbeiten von Aufgaben auftreten werden, 
 ===== Grundlagen ===== ===== Grundlagen =====
 ==== Dokumentation ==== ==== Dokumentation ====
Zeile 20: Zeile 26:
  
 === Gourav Shah - Ansible Playbook Essentials === === Gourav Shah - Ansible Playbook Essentials ===
-Ein weiteres sehr gutes Fachbuch zu Ansible in englischer Sprache ist das Buch **Ansible Playbook Essentials** von **//Gourav Shah//**, erhältlich als **[[https://www.buecher.de/shop/ebooks/ansible-playbook-essentials-ebook-pdf/shah-gourav/products_products/detail/prod_id/56839184/|(eBook, PDF)]]** oder auch als Gedruckte Version im einschlägigem FaAchbuchhandel zu bestellen: (ISBN: 978-1-784-39829-3).+Ein weiteres sehr gutes Fachbuch zu Ansible in englischer Sprache ist das Buch **Ansible Playbook Essentials** von **//Gourav Shah//**, erhältlich als **[[https://www.buecher.de/shop/ebooks/ansible-playbook-essentials-ebook-pdf/shah-gourav/products_products/detail/prod_id/56839184/|(eBook, PDF)]]** oder auch als gedruckte Version im einschlägigem Fachbuchhandel zu bestellen: (ISBN: 978-1-784-39829-3).
 {{ :centos:ansible:ansible-playbook-essentials.png?nolink&250 |Bild: Buchcover Ansible Playbook Essentials von Gourav Shah}} {{ :centos:ansible:ansible-playbook-essentials.png?nolink&250 |Bild: Buchcover Ansible Playbook Essentials von Gourav Shah}}
 +
 +=== Axel Miesen - Ansible für Administratoren und DevOps-Teams ===
 +Das dritte Buch (aktuelle Auflage von August 2020) im Bunde, welches sehr zu empfehlen ist, ist das Buch **Ansible - Das Praxisbuch für Administratoren und DevOps-Teams** von **//Axel Miesen//**, erschienen im Verlag [[https://www.rheinwerk-verlag.de/|Rheinwerk Computing]]. Erhältlich als **[[https://www.buecher.de/shop/server/ansible/miesen-axel/products_products/detail/prod_id/59485549/|(eBook, PDF)]]** oder als gedruckte Version im einschlägigen Fachbuchhandel zu bestellen: (ISBN: 978-3-8362-7660-3).
 +{{ :centos:ansible:ansible-axel-miesen.png?nolink&250 |Bild: Buchcover Ansible für Administratoren und DevOps-Teams vom Axel Miesen}}
  
 === online-Dokumentation === === online-Dokumentation ===
Zeile 760: Zeile 770:
    # ansible --version    # ansible --version
  
-<code>ansible 2.9.2 +<code>ansible 2.9.13 
-  config file = /etc/ansible/ansible.cfg +  config file = /home/django/.ansible.cfg 
-  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules'+  configured module search path = ['/home/django/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules'
-  ansible python module location = /usr/lib/python3.7/site-packages/ansible+  ansible python module location = /usr/lib/python3.8/site-packages/ansible
   executable location = /usr/bin/ansible   executable location = /usr/bin/ansible
-  python version = 3.7.5 (default, Dec 15 201917:54:26) [GCC 9.2.1 20190827 (Red Hat 9.2.1-1)]</code>+  python version = 3.8.5 (default, Aug 12 202000:00:00) [GCC 10.2.1 20200723 (Red Hat 10.2.1-1)]</code>
  
 Sehen wir uns nun an, wie wir die zuvor gestelle Aufgabe des gleichzeitigen Neustarts von einer Gruppe Server parallelisiert anstoßen können. Im folgenden Beispiel wollen wir in der **Gruppe** **''intranet''** alle Server neu starten und dabei statt der default-mäßigen parallelen Abarbeitung von **5** parallelen Prozessen **15** verwenden. Sehen wir uns nun an, wie wir die zuvor gestelle Aufgabe des gleichzeitigen Neustarts von einer Gruppe Server parallelisiert anstoßen können. Im folgenden Beispiel wollen wir in der **Gruppe** **''intranet''** alle Server neu starten und dabei statt der default-mäßigen parallelen Abarbeitung von **5** parallelen Prozessen **15** verwenden.
Zeile 790: Zeile 800:
    $ ansible intranet -m yum -a "name = chrony state = latest"     $ ansible intranet -m yum -a "name = chrony state = latest" 
  
 +==== Module - Dokumentation ====
 +Ansible bringt bei der Installation eine Vielzahl von Modulen, die sich im Verzeichnis **''../ansible/modules/''** befinden, mit, mit deren Hilfe wir uns die Abrit mit unseren Playbooks wesentlich vereinfachen können. 
 +
 +Wie diese **[[https://docs.ansible.com/ansible/latest/modules/list_of_all_modules.html|Module]]** zu verwenden sind, kann man entweder über die Ansible-Dokuseite im **[[https://docs.ansible.com/ansible/latest/modules/modules_by_category.html|WEB]]** erkunden oder auch mit Hilfe des Befehls **''ansible#doc''** erfragen.
 +
 +Also entweder im Falle des Modules**dnf** die Webseite https://docs.ansible.com/ansible/latest/modules/dnf_module.html besuchen oder auf der Konsole den Befehl **''ansible-doc dnf''** bemühen.
 +   $ ansible-doc dnf
 +<code>> DNF    (/usr/lib/python3.6/site-packages/ansible/modules/packaging/os/dnf.py)
 +
 +        Installs, upgrade, removes, and lists packages and groups with the `dnf' package
 +        manager.
 +
 +  * This module is maintained by The Ansible Core Team
 +OPTIONS (= is mandatory):
 +
 +- allow_downgrade
 +        Specify if the named package and version is allowed to downgrade a maybe already
 +        installed higher version of that package. Note that setting allow_downgrade=True can
 +        make this module behave in a non-idempotent way. The task could end up with a set of
 +        packages that does not match the complete list of specified packages to install
 +        (because dependencies between the downgraded package and others can cause changes to
 +        the packages which were in the earlier transaction).
 +        [Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- autoremove
 +        If `yes', removes all "leaf" packages from the system that were originally installed as
 +        dependencies of user-installed packages but which are no longer required by any such
 +        package. Should be used alone or when state is `absent'
 +        [Default: no]
 +        type: bool
 +        version_added: 2.4
 +
 +- bugfix
 +        If set to `yes', and `state=latest' then only installs updates that have been marked
 +        bugfix related.
 +        [Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- conf_file
 +        The remote dnf configuration file to use for the transaction.
 +        [Default: (null)]
 +
 +- disable_excludes
 +        Disable the excludes defined in DNF config files.
 +        If set to `all', disables all excludes.
 +        If set to `main', disable excludes defined in [main] in dnf.conf.
 +        If set to `repoid', disable excludes defined for given repo id.
 +        [Default: (null)]
 +        version_added: 2.7
 +
 +- disable_gpg_check
 +        Whether to disable the GPG checking of signatures of packages being installed. Has an
 +        effect only if state is `present' or `latest'.
 +        [Default: no]
 +        type: bool
 +
 +- disable_plugin
 +        `Plugin' name to disable for the install/update operation. The disabled plugins will
 +        not persist beyond the transaction.
 +        [Default: (null)]
 +        version_added: 2.7
 +
 +- disablerepo
 +        `Repoid' of repositories to disable for the install/update operation. These repos will
 +        not persist beyond the transaction. When specifying multiple repos, separate them with
 +        a ",".
 +        [Default: (null)]
 +
 +- download_dir
 +        Specifies an alternate directory to store packages.
 +        Has an effect only if `download_only' is specified.
 +        [Default: (null)]
 +        type: str
 +        version_added: 2.8
 +
 +- download_only
 +        Only download the packages, do not install them.
 +        [Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- enable_plugin
 +        `Plugin' name to enable for the install/update operation. The enabled plugin will not
 +        persist beyond the transaction.
 +        [Default: (null)]
 +        version_added: 2.7
 +
 +- enablerepo
 +        `Repoid' of repositories to enable for the install/update operation. These repos will
 +        not persist beyond the transaction. When specifying multiple repos, separate them with
 +        a ",".
 +        [Default: (null)]
 +
 +- exclude
 +        Package name(s) to exclude when state=present, or latest. This can be a list or a comma
 +        separated string.
 +        [Default: (null)]
 +        version_added: 2.7
 +
 +- install_repoquery
 +        This is effectively a no-op in DNF as it is not needed with DNF, but is an accepted
 +        parameter for feature parity/compatibility with the `yum' module.
 +        [Default: yes]
 +        type: bool
 +        version_added: 2.7
 +
 +- install_weak_deps
 +        Will also install all packages linked by a weak dependency relation.
 +        [Default: yes]
 +        type: bool
 +        version_added: 2.8
 +
 +- installroot
 +        Specifies an alternative installroot, relative to which all packages will be installed.
 +        [Default: /]
 +        version_added: 2.3
 +
 +- list
 +        Various (non-idempotent) commands for usage with `/usr/bin/ansible' and `not'
 +        playbooks. See examples.
 +        [Default: (null)]
 +
 +- lock_timeout
 +        Amount of time to wait for the dnf lockfile to be freed.
 +        [Default: 30]
 +        type: int
 +        version_added: 2.8
 +
 += name
 +        A package name or package specifier with version, like `name-1.0'. When using
 +        state=latest, this can be '*' which means run: dnf -y update. You can also pass a url
 +        or a local path to a rpm file. To operate on several packages this can accept a comma
 +        separated string of packages or a list of packages.
 +        (Aliases: pkg)
 +        elements: str
 +        type: list
 +
 +- releasever
 +        Specifies an alternative release from which all packages will be installed.
 +        [Default: (null)]
 +        version_added: 2.6
 +
 +- security
 +        If set to `yes', and `state=latest' then only installs updates that have been marked
 +        security related.
 +        [Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- skip_broken
 +        Skip packages with broken dependencies(devsolve) and are causing problems.
 +        [Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- state
 +        Whether to install (`present', `latest'), or remove (`absent') a package.
 +        Default is `None', however in effect the default action is `present' unless the
 +        `autoremove' option is enabled for this module, then `absent' is inferred.
 +        (Choices: absent, present, installed, removed, latest)[Default: (null)]
 +
 +- update_cache
 +        Force dnf to check if cache is out of date and redownload if needed. Has an effect only
 +        if state is `present' or `latest'.
 +        (Aliases: expire-cache)[Default: no]
 +        type: bool
 +        version_added: 2.7
 +
 +- update_only
 +        When using latest, only update installed packages. Do not install packages.
 +        Has an effect only if state is `latest'
 +        [Default: no]
 +       type: bool
 +        version_added: 2.7
 +
 +- validate_certs
 +        This only applies if using a https url as the source of the rpm. e.g. for localinstall.
 +        If set to `no', the SSL certificates will not be validated.
 +        This should only set to `no' used on personally controlled sites using self-signed
 +        certificates as it avoids verifying the source site.
 +        [Default: yes]
 +        type: bool
 +        version_added: 2.7
 +
 +
 +NOTES:
 +      * When used with a `loop:` each package will be processed individually, it is much
 +        more efficient to pass the list directly to the `name` option.
 +      * Group removal doesn't work if the group was installed with Ansible because
 +        upstream dnf's API doesn't properly mark groups as installed, therefore upon
 +        removal the module is unable to detect that the group is installed
 +        (https://bugzilla.redhat.com/show_bug.cgi?id=1620324)
 +
 +
 +REQUIREMENTS:  python >= 2.6, python-dnf, for the autoremove option you need dnf >= 2.0.1"
 +
 +AUTHOR: Igor Gnatenko (@ignatenkobrain) <i.gnatenko.brain@gmail.com>, Cristian van Ee (@DJMuggs) <cristian at cvee.org>
 +        METADATA:
 +          status:
 +          - stableinterface
 +          supported_by: core
 +        
 +
 +EXAMPLES:
 +
 +- name: install the latest version of Apache
 +  dnf:
 +    name: httpd
 +    state: latest
 +
 +- name: install the latest version of Apache and MariaDB
 +  dnf:
 +    name:
 +      - httpd
 +     - mariadb-server
 +    state: latest
 +
 +- name: remove the Apache package
 +  dnf:
 +    name: httpd
 +    state: absent
 +
 +- name: install the latest version of Apache from the testing repo
 +  dnf:
 +    name: httpd
 +    enablerepo: testing
 +    state: present
 +
 +- name: upgrade all packages
 +  dnf:
 +    name: "*"
 +    state: latest
 +
 +- name: install the nginx rpm from a remote repo
 +  dnf:
 +    name: 'http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm'
 +    state: present
 +
 +- name: install nginx rpm from a local file
 +  dnf:
 +    name: /usr/local/src/nginx-release-centos-6-0.el6.ngx.noarch.rpm
 +    state: present
 +
 +- name: install the 'Development tools' package group
 +  dnf:
 +    name: '@Development tools'
 +    state: present
 +
 +- name: Autoremove unneeded packages installed as dependencies
 +  dnf:
 +    autoremove: yes
 +
 +- name: Uninstall httpd but keep its dependencies
 +  dnf:
 +    name: httpd
 +    state: absent
 +    autoremove: no
 +
 +- name: install a modularity appstream with defined stream and profile
 +  dnf:
 +    name: '@postgresql:9.6/client'
 +    state: present
 +
 +- name: install a modularity appstream with defined stream
 +  dnf:
 +    name: '@postgresql:9.6'
 +    state: present
 +
 +- name: install a modularity appstream with defined profile
 +  dnf:
 +    name: '@postgresql/client'
 +    state: present
 +
 +</code>
  
 ===== Installation ===== ===== Installation =====
Zeile 800: Zeile 1087:
 ==== RPM-Paket ansible ==== ==== RPM-Paket ansible ====
 Einen Überblick über das Paket kann man mit Hilfe des Befehls **''rpm -qi''** sich anzeigen lassen. Einen Überblick über das Paket kann man mit Hilfe des Befehls **''rpm -qi''** sich anzeigen lassen.
-   # rpm -ai ansible+   # rpm -qi ansible
 <code>Name        : ansible <code>Name        : ansible
-Version     : 2.9.2 +Version     : 2.9.13 
-Release     : 1.fc31+Release     : 1.fc32
 Architecture: noarch Architecture: noarch
-Install Date: Sa 21 Dez 2019 20:38:05 CET+Install Date: Sa 03 Okt 2020 10:41:49 CEST
 Group       : Unspecified Group       : Unspecified
-Size        : 102078689+Size        : 102582504
 License     : GPLv3+ License     : GPLv3+
-Signature   : RSA/SHA256, Mo 09 Dez 2019 18:59:12 CET, Key ID 50cb390b3c3359c4 +Signature   : RSA/SHA256, Fr 04 Sep 2020 00:23:43 CEST, Key ID 6c13026d12c944d0 
-Source RPM  : ansible-2.9.2-1.fc31.src.rpm +Source RPM  : ansible-2.9.13-1.fc32.src.rpm 
-Build Date  : So 08 Dez 2019 21:42:23 CET +Build Date  : Do 03 Sep 2020 02:10:52 CEST 
-Build Host  : buildvm-aarch64-24.arm.fedoraproject.org+Build Host  : buildvm-ppc64le-38.iad2.fedoraproject.org
 Packager    : Fedora Project Packager    : Fedora Project
 Vendor      : Fedora Project Vendor      : Fedora Project