Guides pratiques¶
Les guides pratiques résolvent un problème concret et spécifique. Contrairement aux tutoriels, qui vous guident pas à pas dans l'apprentissage d'un concept, les guides pratiques supposent que vous maîtrisez déjà les bases et avez besoin d'une recette fiable pour une tâche particulière.
Choisissez le guide correspondant à votre situation :
Guides disponibles¶
| Guide | Description |
|---|---|
| Configuration des clients (APT / RPM / Maven / PyPI / npm) | Pointer apt/dnf/zypper/apk, mvn/Gradle, pip/twine et npm vers votre instance Repod. |
| Registre de conteneurs (Docker / OCI) | docker login/push/pull vers le registre OCI intégré de Repod, ainsi que l'import d'images publiques. |
| Mettre en place un reverse proxy | Terminer le TLS devant Repod avec Nginx, Traefik ou Caddy. |
| Configuration du proxy (accès internet restreint) | Router les appels sortants de Repod (flux CVE, mises à jour de signatures, imports) via un proxy d'entreprise — exemple concret avec Squid inclus. |
| Importer des paquets depuis des sources externes | Miroiter des paquets APT/RPM depuis des dépôts publics ou internes sans upload manuel de fichiers. |
| Cache amont (air-gap) | Exécuter un cache transparent en pull-through pour les clients apt/dnf, avec un flux d'amorçage hors-ligne pour les sites isolés du réseau. |
| Migrer depuis Sonatype Nexus | Exporter votre dépôt APT Nexus et importer chaque paquet dans Repod avec un script d'upload en masse. |
| Migrer depuis JFrog Artifactory | Utiliser l'API REST et l'AQL d'Artifactory pour télécharger les paquets et les réhéberger dans Repod. |
| Faire tourner les clés de signature GPG | Remplacer la clé de signature de votre dépôt en toute sécurité grâce à une période de grâce à double clé, sans jamais casser les machines clientes. |
| Sauvegarder et restaurer Repod | Planifier des sauvegardes automatiques avec backup.sh, les copier hors site, et suivre la procédure de restauration pas à pas. |
| Configurer LDAP / Active Directory | Connecter Repod à l'annuaire LDAP ou AD de votre organisation pour que les utilisateurs se connectent avec leurs identifiants existants. |
| Détection de dérive de configuration | Définir un référentiel YAML (paquets, services, fichiers, permissions) et détecter quand la configuration réelle d'une machine s'en écarte. |
Comment ces guides sont organisés¶
Chaque guide est autonome. Vous pouvez les lire dans n'importe quel ordre. Lorsqu'un guide dépend d'un autre, il y renvoie explicitement. Les blocs de code montrent chaque commande à exécuter ; les encadrés signalent les avertissements, astuces et notes importantes.
Vous ne trouvez pas ce qu'il vous faut ?
Si aucun des guides ci-dessus ne couvre votre situation, ouvrez un ticket sur GitHub et décrivez votre cas d'usage. Les contributions communautaires à la documentation sont toujours les bienvenues.