Revision 5cb6779a
Von Jan Büren vor mehr als 1 Jahr hinzugefügt
| doc/html/ch02s03.html | ||
|---|---|---|
| 1 | 1 |
<html><head> |
| 2 | 2 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| 3 |
<title>2.3. Installation mittels Ansible</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Benötigte Software und Pakete"><link rel="next" href="ch02s04.html" title="2.4. Manuelle Installation des Programmpaketes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. Installation mittels Ansible</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Installation mittels Ansible"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Installation mittels Ansible"></a>2.3. Installation mittels Ansible</h2></div></div></div><p> |
|
| 4 |
Kivitendo lässt sich auch mithilfe von Ansible installieren. |
|
| 5 |
</p><p> |
|
| 3 |
<title>2.3. Installation mittels Ansible auf Ubuntu 22.04</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Benötigte Software und Pakete"><link rel="next" href="ch02s04.html" title="2.4. Manuelle Installation des Programmpaketes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. Installation mittels Ansible auf Ubuntu 22.04</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Installation mittels Ansible auf Ubuntu 22.04"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Installation mittels Ansible"></a>2.3. Installation mittels Ansible auf Ubuntu 22.04</h2></div></div></div><p> |
|
| 6 | 4 |
Ansible ist ein Open-Source-Automatisierungstool, das verwendet |
| 7 | 5 |
wird, um die Bereitstellung, Konfiguration und Verwaltung von |
| 8 | 6 |
IT-Systemen zu automatisieren. Dabei führt es Aufgaben über SSH auf |
| 9 | 7 |
entfernten Rechnern (Hosts) aus. Die Aufgaben werden dabei |
| 10 |
deklarativ als YAML Dateien, den sogenannten Playbooks , übergeben. |
|
| 11 |
</p><p> |
|
| 12 |
Um die installation von Kivitendo einfacher zu gestalten liegt ein |
|
| 13 |
Playbook im scripts Ordner, welches die Installation von Kivitendo |
|
| 14 |
auf einer Ubuntu Umgebung automatisiert. |
|
| 8 |
deklarativ als YAML Dateien, den sogenannten Playbooks, übergeben. |
|
| 9 |
Benötigt wird lediglich python und ansible ab Version 2.10. |
|
| 15 | 10 |
</p><p> |
| 16 |
Zur Installation mit Ansible liegt auf dem Git Repository im ansible |
|
| 17 |
Ordner mit dem benötigtem Playbook und Konfigurationsdateien. |
|
| 11 |
Alle benötigten Konfigurationsdateien und das Playbook sind auf dem kivitendo github Account |
|
| 12 |
unter dem Repository namens <a class="ulink" href="https://github.com/kivitendo/kivitendo-ansible" target="_top">kivitendo-ansible</a> verfügbar. |
|
| 13 |
Das Repo kann lokal mit folgendem git-Befehl "geklont" werden: |
|
| 14 |
</p><pre class="programlisting">git clone https://github.com/kivitendo/kivitendo-ansible</pre><p> |
|
| 15 |
In diesem Repository befindet sich auch eine Readme.md, die aktuelle Installationshinweise auf englisch enthält. |
|
| 18 | 16 |
</p><p> |
| 19 |
Um die installation zu starten wechseln sie zunächst in den Order |
|
| 20 |
<code class="literal">scripts/ansible</code> und führen dann folgenden Befehl |
|
| 21 |
aus. |
|
| 22 |
</p><pre class="programlisting"> |
|
| 23 |
ansible-playbook --ask-become-pass main.yaml --extra-vars"target=ZIEL_RECHNER" |
|
| 24 |
</pre><p> |
|
| 25 |
Der/die Hosts auf denen Kivitendo installiert werden soll wird in |
|
| 26 |
der Variable target übergeben. Als nächstes werden sie von Ansible |
|
| 17 |
Um die Installation zu starten, wechseln Sie dann zunächst in den erstellten Ordner 'kivitendo-ansible' und |
|
| 18 |
editieren die Datei inventory. |
|
| 19 |
|
|
| 20 |
</p><pre class="programlisting">cd kivitendo-ansible |
|
| 21 |
vim inventory</pre><p> |
|
| 22 |
|
|
| 23 |
Der/die Hosts auf denen Kivitendo installiert werden soll wird dann in |
|
| 24 |
dieser Datei ('inventory') eingefügt, bspw. die
|
|
| 25 |
|
|
| 26 |
</p><pre class="programlisting">192.168.1.121</pre><p> |
|
| 27 |
oder als Namen: |
|
| 28 |
</p><pre class="programlisting">kivi.meine-lokale-domaene.de</pre><p> |
|
| 29 |
Zusätzliche Parameter könnten erforderlich sein, bspw. der Benutzer für den SSH-Login: |
|
| 30 |
</p><pre class="programlisting">kivi.meine-lokale-domaene.de ansible_user=myuser</pre><p> |
|
| 31 |
|
|
| 32 |
</p><p> |
|
| 33 |
Danach kann das Playbook mittels: |
|
| 34 |
</p><pre class="programlisting">ansible-playbook --ask-become main.yml</pre><p> |
|
| 35 |
ausgeführt werden, je nach Konfiguration wird man noch |
|
| 27 | 36 |
aufgefordert das BECOME password einzutragen, hierbei handelt es |
| 28 |
sich um das Passwort des nutzers, über den die Installation laufen |
|
| 29 |
wird. |
|
| 37 |
sich um das Passwort des Benutzers, über den die Installation dann auf dem Ziel-Rechner ausgeführt wird. |
|
| 30 | 38 |
</p><p> |
| 31 |
Nach ausführen des Playbooks ist Kivitendo über den Browser
|
|
| 39 |
Nach erfolgreichen Ausführen des Playbooks ist Kivitendo dann über den Browser
|
|
| 32 | 40 |
erreichbar unter |
| 33 | 41 |
<code class="literal">http://<IP des rechners>/kivitendo-erp/</code> |
| 34 | 42 |
|
| ... | ... | |
| 37 | 45 |
werden. Dies kann über die Weboberfläche getan werden, indem man |
| 38 | 46 |
sich mit dem Passwort <code class="literal">admin123</code> in der |
| 39 | 47 |
Administrationsoberfläche anmeldet. |
| 48 |
Weitere Details siehe Abschnitt "<a class="xref" href="ch02s09.html" title="2.9. Benutzerauthentifizierung und Administratorpasswort">Abschnitt 2.9, „Benutzerauthentifizierung und Administratorpasswort“</a>" |
|
| 40 | 49 |
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. Benötigte Software und Pakete </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.4. Manuelle Installation des Programmpaketes</td></tr></table></div></body></html> |
Auch abrufbar als: Unified diff
Aktuell generierte Doku