Différences

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

--- vdirsyncer [Le 02/11/2022, 21:26]
AdeDidou
+++ vdirsyncer [Le 04/11/2022, 10:59] (Version actuelle)
AdeDidou [Automatisation]
@@ Ligne 3: / Ligne 3: @@
 ====== Vdirsyncer ======
-Le logiciel **Vdirsyncer**, sous licence 3-clause BSD ([[https://opensource.org/licenses/BSD-3-Clause|BSD-3-Clause]]), est un outil de ligne de commande pour la synchronisation de calendriers et de carnets d’adresses entre différents serveurs et le système de fichiers local. Le cas d’utilisation le plus populaire est de synchroniser un serveur avec un dossier local et d’utiliser un ensemble d’autres programmes pour modifier les événements et les contacts locaux. Vdirsyncer peut ensuite synchroniser ces modifications sur le serveur.
+Le logiciel **Vdirsyncer**, sous licence 3-clause BSD ([[https://opensource.org/licenses/BSD-3-Clause|BSD-3-Clause]]), est un outil de ligne de commande pour la synchronisation de calendriers et de carnets d’adresses entre différents serveurs et le système de fichiers local((Basé sur [[https://vdirsyncer.pimutils.org/en/stable/|« Documentation de vdirsyncer »]] par Markus Unterwaditzer & contributors.)). Le cas d’utilisation le plus populaire est de synchroniser un serveur avec un dossier local et d’utiliser un ensemble d’autres programmes pour modifier les événements et les contacts locaux. Vdirsyncer peut ensuite synchroniser ces modifications sur le serveur.
 Cependant, vdirsyncer ne se limite pas à la synchronisation entre les clients et les serveurs. Il peut également être utilisé pour synchroniser des calendriers et/ou des carnets d’adresses entre deux serveurs directement.
@@ Ligne 11: / Ligne 11: @@
 ===== Installation =====
-Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>vdirsyncer|vdirsyncer]]**.
+Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>vdirsyncer|vdirsyncer]]**.\\
 Cependant au cas où la version de la distribution n'est pas assez à jour, il est possible de trouver des version plus rapidement mise à jour [[https://packagecloud.io/pimutils/vdirsyncer|sur le serveur]].
@@ Ligne 25: / Ligne 25: @@
 ==== Section Général====
-Le seul paramètre requis est status_path. Il permet de spécifier un dossier où vdirsyncer peut stocker des métadonnées sur chaque paire de stockage.
+Le seul paramètre requis est //status_path//. Il permet de spécifier un dossier où vdirsyncer peut stocker des métadonnées sur chaque paire de stockage.
 Par default, nous avons :
-<code>status_path = "~/.vdirsyncer/status/"</code>
+<code>
+status_path = "~/.vdirsyncer/status/"
+</code>
 ==== Section Paire====
-Dans cette section, on va définir le nom de la paire, les noms des deux stockages utilisés.
+Dans cette section, on va définir le nom de la paire, les noms des deux stockages utilisés et les collections à synchroniser et éventuellement le mode de résolution des conflits et les metadatas à synchroniser:
-Voici la syntaxe de base :
 <code>
 [pair nom_paire]
-a = "nom_stockage_1"
+a = "nom_stockage_a"
-b = "nom_stockage_2"
+b = "nom_stockage_b"
-collections = ["from a", "from b"]
+collections = ["nom_config", "nom_a", "nom_b"]
+#conflict_resolution = null
+#metadata = ["color", "displayname"]
 </code>
+<note tip>Le terme « collection » est utiliser pour désigner les adresses et les calendriers. Chaque collection provenant d’un stockage a un « nom de collection », un identificateur unique pour chaque collection.
+Dans le cas de fichier locaux, c’est le nom du répertoire qui représente la collection, dans le cas des stockages DAV c’est le dernier segment de l’URL.</note>
 ==== Section Stockage====
@@ Ligne 47: / Ligne 52: @@
 [storage nom_stockage]
 type = "TYPE"
-path = "DOSSIER_DE_STOCKAGE" ou url = "URL"
-fileext = "EXTENSION_DES_FICHIERS"
 </code>
+Liste des stockages supportés et leur différents paramétrages :
+  * [[https://vdirsyncer.pimutils.org/en/stable/config.html#caldav-and-carddav|CalDAV and CardDAV]]
+  * [[https://vdirsyncer.pimutils.org/en/stable/config.html#google|Google]]
+  * [[https://vdirsyncer.pimutils.org/en/stable/config.html#etesync|EteSync]]
+  * [[https://vdirsyncer.pimutils.org/en/stable/config.html#local|Local]]
+===Google===
+Vdirsyncer prend en charge la synchronisation avec les calendriers Google avec quelques restrictions. La synchronisation avec les contacts Google est moins fiable, pensez à toujours sauvegarder vos données.
+Il faut tout d'abord [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>python3-pip|python3-pip]]**.\\
+Puis installer des dépendances supplémentaires :
+<code>pip install vdirsyncer[google]</code>
+Enfin, vous devez enregistrer vdirsyncer en tant qu’application vous-même pour obtenir client_id et client_secret afin de respecter les Conditions d’utilisation de Google :
+  -  Accédez à [[https://console.cloud.google.com/apis/dashboard|Google API Manager]] et créez un nouveau projet sous n’importe quel nom. Il faut cliquer sur la liste déroulante en haut à gauche à droite de "Google Cloud"{{:screenshot_2022-11-03_at_13-03-38_parametres_iam_et_administrati_go-next_google_cloud_console.png?direct&200|}} Puis sur nouveau projet en haut à droite de la fenêtre qui s'ouvre{{:screenshot_2022-11-03_at_13-04-06_parametres_iam_et_administrati_go-next_google_cloud_console.png?direct&200|}}
+  - Dans ce projet, activez les API « CalDAV » (pour les calendrier) et/ou « CardDAV » (pour les contacts). Il devrait y avoir une boîte de recherche où vous pouvez simplement entrer ces termes. {{::caldav.png?direct&200|}}
+  - Dans la barre latérale, sélectionnez « Identifiants » puis sur configurer l'écran d'autorisation. Vous pouvez choisir externe
+  - Créez un nouveau « OAuth Client ID ». Vous serez invité à créer d’abord un écran de consentement OAuth. Remplissez ce formulaire comme vous le souhaitez. En ajoutant dans les utilisateur autorisés votre compte Google. Enfin, vous devriez avoir un code de client et un secret de client. Fournissez-les dans votre config de stockage.
+Exemple de configuration de stockage pour les calendriers Google :
+<code>
+[storage calendrier_google]
+type = "google_calendar"
+token_file = "~/.vdirsyncer/google"
+client_id = "ID_CLIENT_SUR_API"
+client_secret = "CODE_SECRET_DU_CLIENT_SUR_API"
+</code>
+Lors du premier lancement de vdirsyncer, il faudra se connecter à Google puis copier dans le terminal le code d'autorisation qui s'affiche. Ensuite, la connexion est automatique.
+===Nextcloud===
+Exemple de configuration de stockage pour les calendriers Nextcloud :
+<code>
+[storage calendrier_nextcloud]
+type = "caldav"
+url = "URL_SERVEUR_NEXTCLOUD"
+username = "UTILISATEUR"
+password = "MOT_DE_PASSE"
+</code>
 ====Configuration avancée====
-Pour  plus de détails, vous pouvez consulter la [[https://vdirsyncer.pimutils.org/en/stable/tutorial.html|configuration avancée
+Pour plus de détails, vous pouvez consulter la [[https://vdirsyncer.pimutils.org/en/stable/tutorial.html|configuration avancée
 ]]
+===Synchronisation Google et Nextcloud===
+Exemple de configuration pour synchroniser deux calendriers entre Google et Nextcloud :
+<code>
+[pair google_nextcloud]
+a = "calendrier_google"
+b = "calendrier_nextcloud"
+collections = [["CALENDRIER_1","ID_CALENDRIER_1_GOOGLE","ID_CALENDRIER_1_NEXTCLOUD"], ["CALENDRIER_2","ID_CALENDRIER_2_GOOGLE","ID_CALENDRIER_2_NEXTCLOUD"]]
+</code>
+<note tip>Si vous ne connaissez pas les identifiants de vos calendriers, vous pouvez mettre n'importe quoi pour les identifiants puis lancer <code>vdirsyncer discover</code>
+Vous verrez alors apparaître la liste des calendriers sur les serveurs sous ce format :
+<code>
+calendrier_google:
+  - "ID_CALENDRIER_1_GOOGLE" ("NOM_CALENDRIER_1_GOOGLE")
+  - "ID_CALENDRIER_2_GOOGLE" ("NOM_CALENDRIER_2_GOOGLE")
+calendrier_nextcloud:
+  - "ID_CALENDRIER_1_NEXTCLOUD" ("NOM_CALENDRIER_1_NEXTCLOUD")
+  - "ID_CALENDRIER_2_NEXTCLOUD" ("NOM_CALENDRIER_2_NEXTCLOUD")
+</code>
+Pensez à mettre non quand l'application vous demande si vous souhaitez créer les collections non trouvées.
+</note>
 ===== Utilisation=====
-Lancez la découverte des listes (de contacts ou de calendrier via le [[:terminal]] avec la [[:commande_shell|commande]] suivante : <code>vdirsyncer discover</code>
+Lancez la découverte des listes (de contacts ou de calendrier via le [[:terminal]] avec la [[:commande_shell|commande]] suivante :
+<code bash>
+vdirsyncer discover
+</code>
-Puis la synchronisation avec la [[:commande_shell|commande]] suivante : <code>vdirsyncer sync</code>
+Puis la synchronisation avec la [[:commande_shell|commande]] suivante :
+<code bash>
+vdirsyncer sync
+</code>
+====Automatisation====
+En utilisant systemd.timer, vdirsyncer peut s'exécuter à un intervalle régulier (par défaut toutes les 15 minutes). Pour activer la minuterie, lancez
+<code bash>systemctl --user enable vdirsyncer.timer</code>
+Pour voir les journaux des analyses précédentes, utilisez <code bash>journalctl --user -u vdirsyncer</code>
 ===== Désinstallation =====
@@ Ligne 66: / Ligne 135: @@
 ===== Voir aussi =====
-  * **(en)** [[https://vdirsyncer.pimutils.org/en/stable/index.html|Site de documentation du logiciel vdirsyncer]]
+  * **(en)** [[https://vdirsyncer.pimutils.org/en/stable/|Site de documentation du logiciel vdirsyncer]]
   * **(en)** [[https://github.com/pimutils/vdirsyncer|Github du logiciel vdirsyncer]]
@@ Ligne 73: / Ligne 142: @@
 //Contributeurs principaux : [[utilisateurs:AdeDidou|AdeDidou]]
-//Basé sur [[https://vdirsyncer.pimutils.org/en/stable/index.htmlm|« Documentation de vdirsyncer »]] par Markus Unterwaditzer & contributors.//