Démarrage rapide
Cette page vous guide pour déployer clmBot en 15 minutes et exécuter un flux complet de renouvellement de certificat.
Avant de commencer, veuillez confirmer :
- Le service sslTrus CaaS est activé et vous pouvez vous connecter au panneau d’administration.
- Le serveur cible peut accéder en sortie aux services cloud.
- Vous disposez des privilèges d’administrateur sur le serveur (pour l’installation et l’initialisation de clmBot).
Étape 1 : Générer AccessKey / AccessSecret
Connectez-vous au panneau d’administration, accédez à sslTrus CaaS Service -> Détails du produit -> Détails du certificat SSL, puis cliquez sur 生成AK/SK pour obtenir AccessKey (AK) et AccessSecret (SK).
Veuillez conserver AccessKey et AccessSecret en lieu sûr. Ne soumettez pas AccessSecret à un dépôt Git, ne l’écrivez pas dans des scripts publics ni ne l’envoyez à des systèmes tiers non fiables ; en cas de suspicion de fuite, régénérez-le dans le panneau d’administration.
Étape 2 : Télécharger clmBot et le téléverser sur le serveur
Téléchargez la version correspondante du programme selon le système depuis la page de publication de clmBot :
Sélectionnez la version appropriée en fonction du système d’exploitation et de l’architecture du serveur (par exemple clm-bot-linux-amd64), puis téléversez-la sur le serveur. Il est recommandé de créer un répertoire d’installation dédié, par exemple /opt/clm-bot.
mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64
Étape 3 : Connexion et intégration
Dans le répertoire d'installation, exécutez la commande login pour terminer l'intégration :
./clm-bot-linux-amd64 login
Suivez les instructions pour sélectionner d'abord le numéro de l'adresse du service cloud (ou saisir directement cette adresse), puis renseignez AccessKey et AccessSecret dans cet ordre.
Une fois la connexion établie, clmBot crée le fichier de configuration config.yaml dans le répertoire d'installation pour y enregistrer les informations de connexion.
Étape 4 : Activer le nœud dans le panneau d’administration
Connectez-vous au panneau d’administration, accédez à la liste des nœuds clmBot, et vous verrez qu’un nouveau nœud clmBot a été ajouté. Cliquez sur l’interrupteur 是否允许接入 à droite du nœud pour activer ce nœud.
Les nœuds nouvellement connectés sont désactivés par défaut ; ce n’est qu’après leur activation dans le panneau d’administration que clmBot peut normalement récupérer les certificats depuis le cloud.
Étape 5 : Découvrir les certificats sur le serveur
Exécutez la commande de découverte des certificats pour scanner automatiquement les certificats déjà déployés sur le serveur ainsi que leurs chemins de stockage :
./clm-bot-linux-amd64 discover-certificate
Une fois la commande exécutée, les informations sur les certificats trouvés s’affichent sous forme de tableau (source, type, émetteur, chemin, domaine, etc.). Saisissez le numéro de série du certificat à téléverser pour confirmer l’ajout à l’administration du backend :
all: tout téléversernone: ne pas téléverser1,3-5: sélectionner selon le numéro de série, avec prise en charge de la notation par plage
Une fois le téléversement terminé, ces certificats apparaissent comme points d’installation dans l’administration du backend. clmBot génère la configuration correspondante pour chaque point d’installation dans le fichier config.yaml du répertoire courant.
Dans la configuration générée automatiquement, chaque point d’installation comporte les champs before_script et after_script, dont after_script est le script de rechargement exécuté après la mise à jour du certificat. Vérifiez s’il est utilisable selon l’environnement réel. Pour la signification des champs, consultez la référence de configuration.
Étape 6 : effectuer la première mise à jour du certificat
Après avoir défini la période de renouvellement automatique du certificat dans le panneau d’administration (voir Mode de mise à jour du certificat), vous pouvez déclencher manuellement une mise à jour pour valider l’ensemble du processus :
./clm-bot-linux-amd64 update-certificate
Après exécution, clmBot vérifie si un certificat plus récent est disponible dans le cloud :
- Le certificat local est déjà à jour : un message est affiché et l'étape est ignorée.
- Un nouveau certificat existe dans le cloud : une tentative de génération d'une sauvegarde
.bakest effectuée, le nouveau certificat est écrit, puisafter_scriptest exécuté selon la configuration. En cas d'échec de la sauvegarde, une erreur est enregistrée mais la mise à jour se poursuit ; le rechargement du service doit être vérifié via les résultats du script et l'état de l'intergiciel.
Étapes suivantes
- Choisir la méthode de mise à jour du certificat (poussée depuis le cloud ou récupération planifiée).
- En environnement de production, il est recommandé de restreindre les permissions d'exécution de clmBot, voir Exigences en matière de permissions d'exécution.
- Enregistrer clmBot comme service système pour un démarrage automatique, voir Déploiement et mise à niveau en tant que service.