對 Docker 映像檔執行重大升級

支援的國家/地區：

Google SecOps SOAR

本文說明如何使用現有遠端代理程式的 Docker 映像檔，執行重大升級。這個程序涵蓋提取最新映像檔、建立現有容器的備份、保留重要環境變數，以及重新啟動新升級的代理程式。

事前準備

此程序假設您已選取「Remote Agent」升級選項，並正在查看「Major Upgrade」對話方塊。

在「重大升級」對話方塊中，複製 Docker 指令並貼到這裡。系統會在步驟 7 中自動填入這項指令：

DOCKER_COMMAND

如要使用現有遠端代理程式的 Docker 映像檔升級，請按照下列步驟操作：

執行下列指令，列出目前執行的 Docker 容器，找出代理程式的容器 ID 和名稱：
```
docker ps
```
輸入代理程式的容器 ID 和名稱：
```
CONTAINER_ID
```
```
AGENT_NAME
```
執行下列指令，將最新的 Docker 映像檔提取至您的機器：您可以將 latest 標記變更為特定版本，例如 1.4.8.3。
```
docker pull us-docker.pkg.dev/siem-ar-public/images/agent:latest
```

執行下列指令，將修改後的環境變數複製到本機暫時檔案：

docker exec CONTAINER_ID cat /home/siemplify_agent/.bash_profile > temp_bash_profile.txt

執行下列指令，停止代理程式的 Docker 容器：
```
docker stop CONTAINER_ID
```
執行下列指令，將容器重新命名為備份：
```
docker rename AGENT_NAME AGENT_NAME_backup
```
執行新的代理程式映像檔。如果您在步驟 3 中為 latest 標記使用特定版本，請在此處使用相同標記：
注意：這個指令會從「事前準備」一節填入。
```
DOCKER_COMMAND
```
執行下列指令，列出正在執行的 Docker 容器，找出新的容器 ID：
```
docker ps
```
輸入代理商的新容器 ID：
```
NEW_CONTAINER_ID
```

執行下列指令，將 .bash_profile 的原始內容複製到新容器：

cat temp_bash_profile.txt | docker exec -i
    NEW_CONTAINER_ID sh -c 'cat > /home/siemplify_agent/.bash_profile'

執行下列指令，重新啟動代理程式服務，套用修改後的環境變數：
```
docker exec NEW_CONTAINER_ID supervisorctl restart all
```