Effectuer une mise à niveau majeure d'une image Docker

Compatible avec :

Ce document explique comment effectuer une mise à niveau majeure d'un agent distant 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 mis à niveau.

Avant de commencer

Cette procédure suppose que vous avez déjà sélectionné l'option de mise à niveau de l'agent distant et que la boîte de dialogue Mise à niveau majeure est affichée. Vérifiez que votre pare-feu autorise l'accès HTTPS sortant sur le port TCP 443 aux registres de conteneurs répertoriés dans Exigences relatives au réseau et au pare-feu.

Dans la boîte de dialogue Mise à niveau majeure, copiez la commande Docker et collez-la ici. Cette commande sera automatiquement renseignée à l'étape 7 :

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 afin d'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 afin de 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 le tag latest à l'étape 3, utilisez le même tag ici :

    Remarque : Cette commande est renseignée à partir de la section Avant de commencer.

    DOCKER_COMMAND
  8. Exécutez la commande suivante pour lister les conteneurs Docker en cours d'exécution afin de trouver l'ID du nouveau 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 afin d'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.