Effectuer une mise à niveau majeure d'une image Docker

Compatible avec :

Ce document explique comment effectuer une mise à niveau majeure pour un agent à distance existant à l'aide de son image Docker. Cette procédure explique comment extraire la dernière image, créer une sauvegarde du conteneur existant, conserver les variables d'environnement essentielles et redémarrer l'agent nouvellement mis à niveau.

Avant de commencer

Cette procédure suppose que vous avez déjà sélectionné l'option de mise à niveau de l'agent à distance et que vous consultez la boîte de dialogue Mise à niveau majeure.

Dans la boîte de dialogue Major Upgrade (Mise à niveau majeure), copiez la commande Docker et collez-la ici pour l'utiliser ultérieurement :

DOCKER_COMMAND

Mettre à niveau l'agent distant existant

Pour mettre à niveau un agent distant existant à l'aide de son image Docker, procédez comme suit :

  1. Exécutez la commande suivante pour lister les conteneurs Docker en cours d'exécution et identifier l'ID et le nom du conteneur de votre agent :
    docker ps
  2. Saisissez l'ID et le nom du conteneur de votre agent :
    CONTAINER_ID
    AGENT_NAME
  3. Exécutez la commande suivante pour extraire la dernière image Docker sur votre machine : Vous pouvez remplacer le tag latest par une version spécifique, telle que 1.4.8.3.
    docker pull us-docker.pkg.dev/siem-ar-public/images/agent:latest
  4. Exécutez la commande suivante pour copier les variables d'environnement modifiées dans un fichier temporaire local :
    docker exec CONTAINER_ID cat /home/siemplify_agent/.bash_profile > temp_bash_profile.txt
  5. Exécutez la commande suivante pour arrêter le conteneur Docker de l'agent :
    docker stop CONTAINER_ID
  6. Exécutez la commande suivante pour renommer le conteneur et créer une sauvegarde :
    docker rename AGENT_NAME AGENT_NAME_backup
  7. Exécutez la nouvelle image de l'agent. Si vous avez utilisé une version spécifique pour la balise latest à l'étape précédente, utilisez la même balise ici :
    DOCKER_COMMAND
  8. Exécutez la commande suivante pour lister les conteneurs Docker en cours d'exécution et trouver le nouvel ID de conteneur :
    docker ps
  9. Saisissez le nouvel ID de conteneur de votre agent :
    NEW_CONTAINER_ID
  10. Exécutez la commande suivante pour copier le contenu d'origine de .bash_profile dans le nouveau conteneur :
    cat temp_bash_profile.txt | docker exec -i
        NEW_CONTAINER_ID sh -c 'cat > /home/siemplify_agent/.bash_profile'
  11. Exécutez la commande suivante pour redémarrer le service de l'agent et appliquer les variables d'environnement modifiées :
    docker exec NEW_CONTAINER_ID supervisorctl restart all

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.