Différences

Ci-dessous, les différences entre deux révisions de la page.

--- wiki:linux:ttrss_installation [2023/03/28 14:06] – créée DEROUET Valentin
+++ wiki:linux:ttrss_installation [2023/04/13 19:21] (Version actuelle) – DEROUET Valentin
@@ Ligne 1: / Ligne 1: @@
-====== Wiki libre de StoneSet ======
+====== Mise en service de TTRSS avec Docker======
-[[doku>wiki:dokuwiki|{{wiki:dokuwiki-128.png }}]] Bonjour et bienvenue sur ma banque de documentation.
-Vous retrouverez ici toute mes procédures ou tips que j'ai appris au fur et à mesure des années.
+{{ :wiki:linux:ttrss.png?300 |}}
-**Si vous êtes examinateur pour le BTS voici la page recherchée : [[start_prof|ici]].**
+Dans cette documentation nous installerons le logiciel TTRSS avec Docker.
-===== Ou trouver de la documentation technique ? =====
+Pour mieux s'y retrouver cette documentation disposera de plusieurs screenshots illustrant les consignes.
-La documentation technique en PDF est disponible sur mon autre banque de fichiers : https://docs.stoneset.fr/
+## Préambule
+### Présentation :
-===== Structure du site =====
+Tiny Tiny RSS (souvent abrégé en TTRSS) est un lecteur et agrégateur RSS/ATOM
-Toutes les documentations sont plus ou moins à jour, si des erreurs y sont trouvées merci de me les signaler.
+Accessible ensuite depuis n'importe quel navigateur, il permet de s'abonner aux flux RSS ou ATOM des sites que vous souhaitez suivre afin de recevoir les derniers articles publiés. Une application officielle android est également disponible.
-Le logo :!: signifie que l'article est encore sous le stade d'ébauche.
+Il propose de nombreux fonctionnalités telles que l'import / export OPML, le partage via RSS ou réseaux sociaux, l'ajout de plugins ou de thèmes, le support des podcasts, le filtrage des flux RSS, etc.
-Les liens en rouge signifie que la doc n'existe pas encore.
-**Sur du Windows**
+Nous considérons que vous êtes équipé de cette manière :
+	- Une VM sous Debian avec docker à installer **[node03]**
-  * [[wiki:windows:howtoconfiguresimplead|Installation d'un AD sur Windows Server]]
+Les allocations de matériel (CPU/RAM...) sont à allouer selon vos envies, attention à respecter la configuration minimale. C'est à dire :
-  * [[wiki:windows:howtoconfigureadcopy|Ajout d'un AD en réplication]]
-  * [[wiki:windows:mecm:management|Exploitation d'un MECM / SCCM]]
-    * [[wiki:windows:mecm:pxebooting|Contexte et compréhension d'une séquence de boot PXE]]
-    * [[wiki:windows:mecm:distributionpoint|Montage d'un Distribution Point]]
-    * [[wiki:windows:mecm:addcomputer|Ajouter des machines dans un parc & boot PXE]]
-    * [[wiki:windows:mecm:packageapplication|Packager une application]]
-    * [[wiki:windows:mecm:packagedriver|Packager un driver]]
-  * [[wiki:windows:scripting|Scripts divers & tips]] :!: *(scripts en vracs)*
-   * [[wiki:windows:scripting:fsmomigration|Migration des rôles FSMO entre deux AD]]
-   * [[wiki:windows:scripting:serverip|Configuration des cartes réseaux sur Windows]]
-   * [[wiki:windows:scripting:adpowershell|Gestion d'un AD avec Powershell]]
-**Sur du Linux**
+Pour **TTRSS** :
+	- *512MB* de ram
+	- *1* cœurs de CPU
+	- *8GB* d'espace disque
+	- *Debian 11*
+	- *PHP 7.4*
+	- *Docker*
-* [[wiki:linux:install|Procédures d'installations & tips]]
+Nos IP pour notre infrastructure seront :
- * [[wiki:linux:proxmox_installation|Installation et exploitation d'un Proxmox et création d'une VM]] :!:
+	- [TTRSS] : **10.192.100.123**
- * [[wiki:linux:glpi_installation|Installation et exploitation d'un GLPI avec liaison LDAP]] :!:
- * [[wiki:linux:nextcloud_installation|Installation et exploitation d'un Nextcloud]]
- * [[wiki:linux:grafana_prometheus|Création d'un système de monitoring avec Grafana & Prometheus]] :!:
- * [[wiki:linux:urbackup|Installation et exploitation du logiciel urBackup]] :!:
- * [[wiki:linux:icinga2|Création d'un système de monitoring avec Icinga 2]] :!:
- * [[wiki:linux:fog_project|Installation et exploitation d'un système de deploiement tel que FOG Project]] :!:
- * [[wiki:linux:gitea_tp|Installation et exploitation d'un GITEA avec liaison LDAP]]
- * [[wiki:linux:ttrss_installation|Installation et exploitation d'un TTRSS]]
- * [[wiki:linux:mail_server|Installation d'un serveur mail avec SoGo, mailcow (docker)]] :!:
-* [[wiki:linux:scripting|Scripts automatiques]]
-  * [[wiki:linux:scripting:lamp|Script d'installation complet d'un LAMP + config MariaDB]]
-* [[wiki:linux:drive|Gestion des disques]]
- * [[wiki:linux:drive:lvm_partitioning|La gestion des partitions sur LINUX (LVM avec les recommandations de l'ANSI)]]
- * [[wiki:linux:drive:mdadm|La création d'un raid logiciel avec MDADM]]
-* [[wiki:linux:nginx_proxy|La notion de proxy et de reverse proxy avec Nginx]]
-* [[wiki:linux:networking|Notions de bases pour configurer le réseau]] :!:
-* [[wiki:linux:chroot|Le fonctionnement de CHROOT]] :!:
-* [[wiki:linux:firewall|Utilisation de opnSense]] :!:
-**Sur du réseau en tout genre**
+Mot de passe par défaut sur toutes les sessions : **Not24get**
-  * [[wiki:network:basicprincipe|Principes de base en réseau]]
+Rappel des deux commandes essentiels :
-  * [[wiki:network:address_math|Calculs d'adresses et de masques]]
+	- ''ip a'' (connaitre son adresse IP)
-  * [[wiki:network:snmp_requests|Les requêtes SNMP et comment les traiter]]
+	- ''nano /etc/network/interfaces'' (configuration de l'interface réseau)
-  * [[wiki:network:nat_protocol|Le protocole NAT et ses utilisations]]
-  * [[wiki:network:sdis53_laubrieres|Montage d'un lien WIFI entre deux centres de secours (SDIS 53)]]
-  * [[wiki:network:802.1X.explanation|Analyse et cas pratique de l'utilisation du protocole 802.1x]]
-  * [[wiki:network:hp:basic|Commandes de bases sur le matériel HP Procurve de serie **A**]]
-  * [[wiki:network:cisco:basic|Les routeurs Cisco]]
-    * [[wiki:network:cisco:tips|Quelques tips de config Cisco]]
-      * SSH
-      * RESET d'un routeur
-      * TFPT RX et TX
-    * [[wiki:network:cisco:vlans|Création de VLANS & notion de trunk/tags]]
-      * replications des vlans (VTP)
-    * [[wiki:network:cisco:dhcp|Configuration du DHCP et exclusions des adresses]]
-      * explication du protocole dhcp
-    * [[wiki:network:cisco:etherchannel|La notion d'Etherchannel / LACP]]
-    * [[wiki:network:cisco:hsrp_vrrp|HSRP & VRRP]]
-    * [[wiki:network:cisco:network_security|La sécurisation des réseaux]]
-    * [[wiki:network:cisco:ospf|Routage dynamique OSPF]]
-**Audio et HI-FI**
+**Conseil :** Ajouter les deux machines dans un logiciel tel que mRemoteNG pour faciliter l'administration.
- * [[wiki:audio:howtousearta|Tutoriel pour utiliser ARTA en profondeur]]
+# Installation de TTRSS
- * [[wiki:audio:calibrate|Tutoriel pour calibrer son matériel pour des mesures]]
- * [[wiki:audio:repair_tips|Tips de dépannage en tout genre]]
- * [[wiki:network:filter_math|Le calcul et dimensionnement d'un filtre ]]
-**Autres**
+## Installation de Docker via le repo
-  * [[wiki:others:seo:digital_reputation|Gérer son image numérique]]
+### Ajout du dépôt
-  * [[wiki:network:seo:optimized|Optimiser le SEO d'un site web]]
-    * [[wiki:network:seo:analytics|Installation et exploitation d'un Matomo]]
-    * [[wiki:network:seo:meta|Les balises META]]
-    * [[wiki:network:seo:search_console|La Google Search Console et Google Business]]
-    * [[wiki:network:seo:howtoorganizewebsite|Comment construire sa page web pour permettre un meilleur référencement]]
+- Ajouter les paquets pour installer des paquets depuis des sources sécurisées
+```bash
+apt-get install \
+    ca-certificates \
+    curl \
+    gnupg
+```
-===== Copyright =====
+- Ajouter la clé GPG de Docker
--2023 (c) Valentin DEROUET <[email protected]>
+```
+mkdir -m 0755 -p /etc/apt/keyrings
-Toute la documentation est **libre** d'être utilisée et reprise, toute citation est __**obligatoire**__.
+```
-{{:88x31.png?100|}}
+```bash
+curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+```
+- Ajouter le repo dans le ''sources.list''
+```bash
+echo \
+  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
+  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
+  tee /etc/apt/sources.list.d/docker.list > /dev/null
+```
+### Installation du moteur Docker
+- Mettre à jour le nouveau dépôt
+```
+apt-get update
+```
+- Installation de Docker et de ses dépendances
+```bash
+apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+```
+#### Essais
+Cette commande télécharge une image de test et l'exécute dans un conteneur. Lorsque le conteneur s'exécute, il imprime un message de confirmation et se ferme.
+```
+docker run hello-world
+```
+<WRAP center round info 60%>
+Si vous souhaiter changer le path de la ''data'' de docker :
+[https://www.ibm.com/docs/en/z-logdata-analytics/5.1.0?topic=compose-relocating-docker-root-directory](https://www.ibm.com/docs/en/z-logdata-analytics/5.1.0?topic=compose-relocating-docker-root-directory)
+</WRAP>
+{{ :wiki:linux:mremoteng_cirqy02xw8.png?500 |}}
+## Installation de TTRSS
+### Depuis le repo Github
+Cette image embarque un serveur web sous base nginx et un serveur SQL.
+- Cloner le repo Github de ''ttrss''
+```
+git clone https://git.tt-rss.org/fox/ttrss-docker-compose.git ttrss-docker
+```
+```
+cd ttrss-docker
+```
+- Changer de branche vers ''static-dockerhub''
+```
+git checkout static-dockerhub
+```
+- Configuration de l'environnement
+```
+mv .env-dist .env
+nano .env
+```
+Modifier le fichier selon votre volonté
+<WRAP center round important 60%>
+Attention à bien spécifier l'adresse EXACTE à partir de laquelle ''ttrss'' sera accessible (`TTRSS_SELF_URL_PATH=`)
+Définissez un mot de passe ''admin'' à la ligne (`ADMIN_USER_PASS=`)
+{{ :wiki:linux:mremoteng_vw5nagxfrt.png?450 |}}
+</WRAP>
+- Télécharger et démarrer le container
+```
+docker compose pull && docker compose up -d
+```
+{{ :wiki:linux:mremoteng_fwxikdutzv.png?500 |}}
+Visiter la page : `http://<IP>:8280/tt-rss`
+{{ :wiki:linux:firefox_bua4kanapd.png?450 |}}
+# Reverse proxy avec nginx
+{{ :wiki:linux:656px-apache-load-balancer-mod-proxy-http.png?400 |}}
+A partir d'un autre serveur nginx.
+## Création de la config nginx
+- Créer une entrée ''A'' dans votre serveur DNS qui point vers l'ip de votre serveur
+	- Exemple :
+```
+ttrss.stoneset.fr.         IN      A       10.192.100.209
+```
+- Créer la configuration dans les *sites-available* :
+<code>nano /etc/nginx/sites-available/proxy_ttrss.conf</code>
+```yaml
+server {
+    server_name ttrss.stoneset.fr;
+    location / {
+        proxy_pass http://node03.local:8280;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_cache_bypass $http_upgrade;
+    }
+}
+```
+<WRAP center round info 60%>
+Spécifier un chemin relatif pour le lien ''proxy_pass'', il est défini dans ''/etc/hosts''
+</WRAP>
+- Redémarrer nginx :
+```
+systemctl restart nginx
+```
+# Configuration de TTRSS
+<WRAP center round info 60%>
+Le compte par défaut est ''admin:password''
+</WRAP>
+- Changer le mot de passe par défaut
+{{ :wiki:linux:firefox_stypu53t0i.png?600 |}}
+## Ajouter un flux RSS
+{{ :wiki:linux:firefox_btbbdclohb.png?400 |}}
+{{ :wiki:linux:firefox_fprldxtkwr.png?400 |}}
+{{ :wiki:linux:firefox_x2yzygs7x0.png?800 |}}
+Une fois les flux ajoutés :
+{{ :wiki:linux:firefox_hm4bzocxwc-min.png?900 |}}
+- Liste de flux well-known RSS :
+	- https://www.anandtech.com/rss
+	- https://www.it-connect.fr/feed/
+	- https://rdr-it.com/feed/
+	- https://www.lesnumeriques.com/rss.xml
+	- https://www.zdnet.fr/feeds/rss/actualites/
+	- https://www.01net.com/actualites/feed/
+	- https://www.lemondeinformatique.fr/flux-rss/thematique/telecom/rss.xml
+## Mes sources
+. https://framalibre.org/content/tiny-tiny-rss
+. https://tt-rss.org/wiki/InstallationNotes
+. https://docs.docker.com/engine/install/debian/
-Pour en savoir plus : https://creativecommons.org/licenses/by/4.0/

StoneSet - Documentations

Outils pour utilisateurs

Outils du site

Différences

Outils de la page