Metadata-Version: 2.1
Name: allo-client.beta
Version: 0.0.1.post156567
Summary: Libriciel upgrade package
Home-page: https://gitlab.libriciel.fr/libriciel/projets-internes/allo/allo-client
Author: Lukas Hameury
Author-email: lukas.hameury@libriciel.coop
License: UNKNOWN
Description: # Allo client
        
        Paquet Python3 permettant la télémaintenance et la mise à jour automatique des logiciels Libriciel-SCOP.
        - Demande identifiant client
        - Demande code produit
        - Association avec code PIN via le serveur Allo
        - Demande de token de télémaintenance
        - Clone du repo gitlab
        
        Une fois activé, il est possible de :
        - Lancer la télémaintenance via le système "Teleport"
        - mettre à jour automatiquement
        - annuler une mise à jour automatiquement
        
        ## Communications réseau
        
        Allo-client doit pouvoir communiquer avec :
        - `allo.dev.libriciel.fr:443`
        
        ## Installation
        
        Toutes les commandes suivantes sont à lancer en tant qu'utilisateur `root`.
        
        OS supportés :
        - RHEL 7
        - RHEL 8
        - CentOS 7
        - CentOS 8
        - Ubuntu 18.04 LTS
        - Ubuntu 20.04 LTS
        - Debian 8
        - Debian 9
        
        S'assurer que la locale par défaut est en UTF-8 et non-ASCII ou POSIX.
        
        Ceci est configuré par défaut sur une installation classique, mais pas sur une image Docker par exemple.
        
        ### Les histoires de locales
        
        Pour un environnement docker, il faut définir la locale par défaut du terminal en UTF8, 
        voici les commandes nécessaires par OS (les versions d'OS non répertoriés n'ont pas besoin de commande supplémentaires) :
        
        - RHEL / CentOS 7 : `localedef -i fr_FR -f UTF-8 C.UTF-8`
        - Ubuntu 18 : `apt install locales`
        
        Enfin, lancer dans tous les cas les commandes suivantes :
        - `export LC_ALL=C.UTF-8`
        - `export LANG=C.UTF-8`
        
        ### Pré-requis RHEL / CentOS
        
        Pour RHEL / CentOS 7 :
        ```bash
        yum install epel-release
        yum install python36
        export PATH=$PATH:/usr/local/bin
        localedef -i fr_FR -f UTF-8 C.UTF-8
        ```
        
        Pour RHEL / CentOS 8 :
        ```bash
        yum install python36
        export PATH=$PATH:/usr/local/bin
        ```
        
        ### Pré-requis Debian / Ubuntu
        
        ```bash
        apt update && apt install python3-pip
        ```
        
        ### Installation
        
        ```bash
        pip3 install allo-client.beta -i https://pypi.org/simple/
        ```
        
        ### Usage
        
        Il suffit de lancer la commande `allo` et de se laisser guider.
        Pour relancer l'installation des dépendances systèmes, utiliser la commande `allo install`
        Pour une utilisation sans invite de commande, utiliser `allo cli` <-- Travaux en cours
        
        ## Reste à faire
        
        - Mise à jour via teleport avec ansible
        - Detection et récupération des versions actuelles de logiciel
        - Mise à jour automatique de allo avec ansible
        - Meilleure gestion d'erreurs
        - Gestion de cas "spéciaux" (modification de fichiers)
        - Gestion de process d'upgrade / downgrade spécifique à une version
        
        
        
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
