Anwendungen mit Ansible installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:
== Vorbereitungen ==
== Vorbereitungen ==


=== Vorbereitung im Paket Admin ===
=== Vorbereitung des Zugriffs für den Paket Admin ===
Wichtig ist, dass man den <code>xyz00</code> Benutzer entsprechend vorbereitet: Es muss eine Datei mit dem Namen <code>.hsadmin.properties</code> im HOME Verzeichnes des Paket Admins <code>xyz00</code> angelegt werden. Man muss den Paketnamen und das Passwort des Paket Admins in dieser Datei hinterlegen.
Wichtig ist, dass man den <code>xyz00</code> Benutzer entsprechend vorbereitet: Es muss eine Datei mit dem Namen und Paf <code>inventories/group_vars/xyz00.yml</code> angelegt werden. Man muss den Paketnamen und das Passwort des Paket Admins in dieser Datei hinterlegen.


Beispiel:
Die Datei sieht so aus:


  xyz00@h99:~$ cat .hsadmin.properties
  ---
  xyz00.passWord=insertpkgadminpasswordhere
pac: xyz00
  pac_pass: topsecret


Diese Datei sollte geschützt werden, weil sie sonst von allen gelesen werden könnte:
Diese Datei kann auch als Vault erstellt werden:


  xyz00@h99:~$ chmod 600 .hsadmin.properties
  ansible-vault create inventories/group_vars/all/vault


=== Ansible lokal installieren ===
mit diesem Inhalt:


z.B. auf Debian:
  ---
  vault_hsadmin_user: xy
  vault_hsadmin_pass: "topsecret"
  ansible_become_password: "topsecret"


hans@localhost:~$ apt-get install ansible
Dann muss bei Aufrufen von <code>ansible-playbook</code> immer der Parameter <code>--ask-vault-pass</code> hinzugefügt werden.


=== Aktuelles Ansible bei Hostsharing installieren ===
Mit diesen Befehlen kann das Vault bearbeitet und betrachtet werden:
Das aktuelle Ansible kann auch direkt bei Hostsharing installiert werden. Dazu sollte ein Python ab 3.9 installiert werden, siehe [[Eigenes Python installieren]].


Dann kann mit pipenv das aktuelle Ansible installiert werden:
ansible-vault edit inventories/group_vars/all/vault
ansible-vault view inventories/group_vars/all/vault


  pipenv install ansible
=== Aktuelles Ansible installieren ===
Das aktuelle Ansible kann mit pipenv entweder lokal oder direkt in einem Hostsharing Benutzer installiert werden:
 
  pipenv install ansible hs.admin.api


Um z.B. ein playbook auszuführen, muss dann folgendes ausgeführt werden:
Um z.B. ein playbook auszuführen, muss dann folgendes ausgeführt werden:
Zeile 39: Zeile 46:


=== ssh config anpassen ===
=== ssh config anpassen ===
Für jeden Schritt wird per Voreinstellung eine eigene SSH Verbindung aufgebaut. Damit der Server nicht denkt, er wird angegriffen, müssen in der eigenen SSH Client Konfiguration auf dem lokalen Rechner die folgenden Einstellungen vorgenommen werden.
Beim Aufruf von Ansible auf dem lokalen Gerät wird für jeden Schritt per Voreinstellung eine eigene SSH Verbindung aufgebaut. Damit der Server nicht denkt, er wird angegriffen, müssen in der eigenen SSH Client Konfiguration auf dem lokalen Rechner die folgenden Einstellungen vorgenommen werden.


In der Datei <code>$HOME/.ssh/config</code>:
In der Datei <code>$HOME/.ssh/config</code>:

Aktuelle Version vom 25. März 2024, 07:35 Uhr

Übersicht

Siehe die Kategorie:Ansible_Playbook für eine Liste von Anwendungen, für die wir bereits ein Ansible Skript haben.

Vorbereitungen

Vorbereitung des Zugriffs für den Paket Admin

Wichtig ist, dass man den xyz00 Benutzer entsprechend vorbereitet: Es muss eine Datei mit dem Namen und Paf inventories/group_vars/xyz00.yml angelegt werden. Man muss den Paketnamen und das Passwort des Paket Admins in dieser Datei hinterlegen.

Die Datei sieht so aus:

---
pac: xyz00
pac_pass: topsecret

Diese Datei kann auch als Vault erstellt werden:

ansible-vault create inventories/group_vars/all/vault

mit diesem Inhalt:

 ---
 vault_hsadmin_user: xy
 vault_hsadmin_pass: "topsecret"
 ansible_become_password: "topsecret"

Dann muss bei Aufrufen von ansible-playbook immer der Parameter --ask-vault-pass hinzugefügt werden.

Mit diesen Befehlen kann das Vault bearbeitet und betrachtet werden:

ansible-vault edit inventories/group_vars/all/vault
ansible-vault view inventories/group_vars/all/vault

Aktuelles Ansible installieren

Das aktuelle Ansible kann mit pipenv entweder lokal oder direkt in einem Hostsharing Benutzer installiert werden:

pipenv install ansible hs.admin.api

Um z.B. ein playbook auszuführen, muss dann folgendes ausgeführt werden:

pipenv shell
ansible-playbook ...

bzw.

pipenv run ansible-playbook ...

ssh config anpassen

Beim Aufruf von Ansible auf dem lokalen Gerät wird für jeden Schritt per Voreinstellung eine eigene SSH Verbindung aufgebaut. Damit der Server nicht denkt, er wird angegriffen, müssen in der eigenen SSH Client Konfiguration auf dem lokalen Rechner die folgenden Einstellungen vorgenommen werden.

In der Datei $HOME/.ssh/config:

Host *.hostsharing.net
   ControlPath ~/.ssh/cm-%r@%h:%p
   ControlMaster auto
   ControlPersist 10m

Ein Playbook ausführen

In der README des Playbook Repositories wird beschrieben, wie man das Playbook bei Hostsharing benutzt.

Man muss dann das Repo des Ansible Playbooks auf dem eigenen lokalen Rechner clonen, mit git clone, siehe README.

hans@localhost:~$ git clone https://github.com/<URL REPO>/Hostsharing-Ansible-<IRGENDWAS>.git

Dann am besten die Datei inventory-sample.yml zu inventory.yml kopieren, und die eigenen Daten entsprechend dort eintragen.

Wir gehen davon aus, dass wir den Zugang zu xyz00.hostsharing.net als Benutzer xyz00 über SSH Key eingerichtet haben.

Dann das Playbook aufrufen, auf dem lokalen Rechner (dort muss Ansible installiert sein):

hans@localhost:~$ cd Hostsharing-Ansible-<IRGENDWAS>
hans@localhost:~$ ansible-playbook -i inventory.yml playbook-install.yml

Zum Debuggen will man nicht nochmal alle Aufgaben durchführen, die bereits erledigt sind. Dann gibt es den Parameter start-at-task, wo man den Namen der Task angibt, bei der gestartet werden soll:

hans@localhost:~$ ansible-playbook -i inventory.yml playbook-install.yml \
    -start-at-task="install the certificates"