====== CloudMapper ======

----

===== Installation=====

==== Prérequis ====

<code bash>
sudo apt-get install python3-pip python3.10-venv
sudo apt-get install autoconf automake libtool python3.7-dev python3-tk jq awscli
sudo apt-get install graphviz
</code>

==== Installation ====

=== Téléchargement ===

<code bash>
git clone https://github.com/duo-labs/cloudmapper.git
cd cloudmapper
</code>

=== Modification ===

Supprimer du fichier requirement.txt la ligne concernant pyjq

=== Installation dans un environnement virtuel ===

<code bash>
python3 -m venv ./venv && source venv/bin/activate
pip install pyjq
pip install -r requirements.txt
</code>

==== Configuration ====

  * Copier le fichier config.json.demo en config.json et renseigner les informations.
  * Configurer les credentials AWS 

<code bash>
aws configure
</code>

----

===== Utilisation =====

==== Collecte des données ====

=== Commande ===

<code bash>
python cloudmapper.py collect --account <nom_du_compte>
</code>

=== Résultat ===

Sous le répertoire <color #00a2e8>account-data/<nom_du_compte></color> création d'un sous répertoire par région contenant des fichiers json.

==== Générer un rapport ====

<code bash>
python cloudmapper.py report --account <nom_du_compte>
</code>

==== Générer un diagramme web interactif ====

=== Génération ===

<code bash>
python cloudmapper.py prepare --account <nom_du_compte>
</code>

=== lancement serveur web ===

<code bash>
python cloudmapper.py webserver
</code>

=== visualisation résultat ===

Lancer un navigateur à l'adresse [[http://127.0.0.1:8000]] 

----