設定安裝程式和 Docker

支援:

本文說明如何設定代理程式,包括如何查看及變更設定選項。同時說明如何為代理與發布者之間的通訊和整合設定 Proxy 設定。

管理遠端代理程式設定

如要變更代理,請按照下列步驟操作:

  1. 使用 SSH 登入代理程式機器。
  2. 前往 /home/siemplify_agent/agent_source 目錄,如果使用 Docker,請確認您位於容器內。
  3. 執行下列指令,查看 cli 公用程式的所有主要設定選項:
    python agent_cli.py -h

    執行 printenv 指令,查看目前使用中設定的值。

  4. 使用 set_option 格式變更單一主要設定選項的值:

  5. python agent_cli.py set_verify_ssl_slave false
  6. 使用 update_environment 指令修改以環境變數形式儲存的更廣泛設定:
    1. 查看可修改的環境變數清單:
    2. python agent_cli.py update_environment -h
    3. 變更下列任一設定的值:
    4. python agent_cli.py update_environment VARIABLE_NAME VALUE

      例如:

      python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS  30

遠端代理程式環境變數

下表詳細說明可使用 python agent_cli.py update_environment 指令設定的環境變數:

選項 說明 值
TASK_TIMEOUT 設定代理已提取但尚未執行的工作逾時時間 (以秒為單位)。 時間 (秒)
SERVER_API_ROOT 主要發布者 API 伺服器位址。定義代理程式從何處提取工作,以及將結果發布至何處。 API 位址
SERVER_API_TOKEN 用於傳送至發布商的所有要求的驗證權杖。 伺服器 API 權杖 (字串)
VERIFY_SSL 判斷代理程式是否必須出示已簽署的 SSL 憑證,才能連線至發布商。 布林值 (True 或 False)
RETRANSMISSION_LOOP_INTERVAL_SECONDS 設定每次檢查之間的延遲時間 (以秒為單位),確認發布者已收到連接器套件的 CASE_ACK。 時間 (秒)
RETRANSMISSION_SAVE_PERIOD_DAYS 假設未收到 CASE_ACK,連接器套件在刪除前可保留在重新傳輸資料夾中的最長時間 (以天為單位)。 時間 (天)
RETRANSMISSION_FOLDER_MAX_SIZE_MB 重新傳輸資料夾的大小上限 (以 MB 為單位),達到上限後,代理程式就會開始刪除最舊的連接器套件,以維持界線。 大小 (MB)
VERIFY_SSL_SLAVE 如果設為 True,代理程式會要求次要發布商具備已簽署的 SSL 憑證,才能建立通訊。 布林值 (True 或 False)
PROXY_ADDRESS 代理伺服器的 IP 位址,代理程式會使用這個位址與主要發布者通訊。 Proxy IP 位址
AGENT_KEY 代理程式會使用加密金鑰解密從發布商擷取的套件,並在發布結果前加密。 已加密的代理金鑰
SERVER_API_ROOT_SLAVE 次要 Publisher API 伺服器位址,代理程式會從該位址提取工作,並將結果發布至該位址。 API 位址
PROXY_ADDRESS_SLAVE Proxy 伺服器的 IP 位址,代理程式會使用這個位址與次要發布者通訊。 Proxy IP 位址
DEPLOYMENT_TYPE 指出代理程式的安裝方式。 Docker 或 Installer (字串)

設定代理發布者 Proxy

設定 Proxy 伺服器,處理遠端代理服務與發布者之間的所有通訊。這項設定僅適用於代理商與發布商的通訊管道。

如要設定 Agent-Publisher 代理伺服器,請按照下列步驟操作:

  1. 在代理程式機器上執行 update_environment 指令,為現有已部署的代理程式設定 Proxy:
  2. python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
  3. 下載套件,然後編輯 .env 檔案,加入 Proxy 位址:
  4. PROXY_ADDRESS=https://{proxy_host}
  5. 執行部署作業前,請先將 Proxy 位址新增為 Docker 指令的環境變數 (`-e`):
  6. -e PROXY_ADDRESS=https://{proxy_host}。

設定整合 Proxy

這個程序會定義在遠端代理程式上執行的整合 Proxy 設定,確保整合流量會透過指定的 Proxy 伺服器轉送。

如要設定整合 Proxy,請在執行 Docker 指令前,將必要變數新增至代理程式的環境:

變數 說明 範例
HTTP_PROXY HTTP 要求的 Proxy 位址 https://{HTTP_PROXY}
HTTPS_PROXY HTTPS 要求的 Proxy 位址 https://{HTTPS_PROXY}
NO_PROXY 以半形逗號分隔的主機名稱/IP 清單,用於略過 Proxy 路由 https://{NO_PROXY}

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。