EC2 API Tools (Java)

Installieren und konfigurieren Sie die AWS ec2-api-tools auf einem Zielknoten. Dies verwendet nicht das neuere (empfohlene) Python-Paket awscli, da es speziell für Anwendungsfälle entwickelt wurde, die immer noch die Java-Tools verwenden (z.B.: Bamboo Elastic Agent).

Anforderungen

Die Verwendung dieses Rollens erfordert keine besonderen Voraussetzungen, außer Ansible selbst.

Rollenvariablen

Die folgenden Variablen können eingestellt werden, um das Ausführungsverhalten zu ändern.

1. ec2_api_tools_url: Setzen Sie dies, wenn Sie eine benutzerdefinierte Installationsquelle verwenden möchten.
2. ec2_api_tools_dir: Setzen Sie dies, um das Installationsverzeichnis zu ändern.
3. ec2_api_tools_refresh: Setzen Sie dies auf yes, wenn Sie eine Wiederinstallation erzwingen möchten, falls bereits eine Installation vorhanden ist. Dies wird überprüft, indem getestet wird, ob ec2_api_tools_dir existiert. Wenn dies gesetzt ist, werden alle Installationen des Tools entfernt, bevor es erneut installiert wird.

Abhängigkeiten

Diese Rolle hat keine externen Abhängigkeiten. Wenn Sie jedoch Tests durchführen, muss die Galaxy-Rolle abn.managed-node-bootstrap installiert sein.

Beispiel-Playbook

Ein Beispiel-Playbook, das vorhandene Installationen aktualisiert.

- hosts: all
  roles:
     - { role: abn.ec2-api-tools-java, ec2_api_tools_refresh: yes }

Testen

Bevor Sie testen, müssen Sie sicherstellen, dass die benötigten Submodule geklont wurden.

git submodule update --init --recursive

Lokale Umgebung

Diese Rolle verwendet Molecule und Docker-Instanzen, um Tests zu ermöglichen. Sie können dies lokal in Ihrer Entwicklungsumgebung ausführen, vorausgesetzt, Sie haben Python installiert und der Docker-Daemon läuft.

# installiere Molecule und Docker-Python-Anforderungen
pip install -r test-requirements.txt
molecule test

Dies wird, wie im Standard-Molecule-Szenario konfiguriert, Container der unterstützten Distributionen hochfahren und ein Beispiel-Playbook ausführen.

Tox

Dieses Projekt hat auch tox konfiguriert, um gegen mehrere Ansible-Versionen mit Molecule zu testen. Dies kann einfach mit tox ausgeführt werden.

tox

Beziehen Sie sich auf die Molecule-Dokumentation und die tox-Dokumentation für erweiterte Anweisungen zur Verwendung.

Lizenz

Apache Lizenz 2.0