跳轉到主要內容
Google Storage 端口從 Google Storage 雲端儲存服務中上傳和下載檔案。

核心功能

  • Google Cloud Storage 整合,支援 OAuth 身分驗證及權杖(Token)自動重新整理
  • 基於儲存桶(Bucket)的檔案組織,支援雙向檔案傳輸
  • 支援 Glob 模式匹配過濾,並提供下載後可選刪除檔案及覆蓋保護功能
  • 提供可選的快取功能,確保僅下載新增或更新的檔案

概觀

每個 Google Storage 端口與一個特定的 Google Storage 帳號連線。在遠端儲存中,儲存桶被設定為上傳和/或下載目標。可以在儲存桶中指定上傳和下載路徑,並且過濾規則只用於傳送和接收指定的檔名和/或副檔名。 知行之橋 工作流程中到達 Google Storage 端口的檔案將被上傳至上傳目的檔案夾,在下載目的檔案夾下的檔案會被下載並進入 知行之橋 工作流程。 帳號認證基於 OAuth,因此使用 Google Storage 端口連線之前必須先取得 OAuth 認證。一旦與 Google 的認證完成,Google Storage 端口會處理重新整理 OAuth 權杖的過程,以確保身分驗證會一直持續。

端口配置

本部分包含所有可配置的端口屬性。

設定

授權

與授權存取遠端儲存有關的設定。
Google 在生成 OAuth 認證時可能需要 OAuth 回呼/重新導向 URL。知行之橋 的回呼/重新導向 URL 與應用程式託管處的地址和端口相同,加下面的源路徑:src/oauthCallback.rst。例如,如果 知行之橋 託管在 ‘mydomain.com’ 的 8001 端口,應指定下面的 URL 為回呼/重新導向 URL:http://mydomain.com:8001/src/oauthCallback.rst。

伺服器配置

與目標儲存伺服器相關的設定。

傳送

與上傳檔案到遠端儲存服務有關的設定。

接收

與從遠端儲存中下載檔案有關的設定。

快取

與快取和比較多次下載之間檔案相關的設定。

知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行,刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內,無需任何手動操作。

預設情況下,檔案保留 30 天,但您可以在進階索引標籤的其他設定欄位中使用 ResourceCacheRetentionDays 設定來調整保留時間以適應您的環境。例如,ResourceCacheRetentionDays=15 表示檔案保留 15 天后將被刪除。

啟用快取時,檔名不區分大小寫。例如,端口無法區分 TEST.TXT 和 test.txt。

進階設定

進階設定

先前目錄中沒有包含的設定。

代理配置

這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下,本節使用 安全設定 頁面的 代理設定 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。

設定描述
代理型別基於代理的防火牆使用的協議。
代理主機基於代理的防火牆的名稱或 IP 地址。
代理端口基於代理的防火牆的 TCP 端口。
代理使用者用於透過基於代理的防火牆進行身分驗證的使用者名稱。
代理密碼用於對基於代理的防火牆進行身分驗證的密碼。
身分驗證方案保留預設值 None 或選擇以下身分驗證方案之一:Basic、Digest、Proprietary 或 NTLM。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定描述
日誌級別指定要記錄在端口日誌目錄中的資訊型別:
  • None - 不建立任何日誌。
  • Error - 僅當端口遇到錯誤時才建立日誌。
  • Warning - 僅當端口發出警告時才建立日誌。
  • Info - 記錄工作流程的一般資訊,包括任何錯誤和警告(如果適用)。
  • Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意:Debug 和 Trace 級別的日誌可能會記錄敏感資訊,包括訊息內容和 SSL 憑證。儘管連線屬性(例如密碼)被遮蔽了,但在與您的組織外部共享它們之前,請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。

雜項

特殊設定適用於特定用例。

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化

自動化設定

與端口自動處理檔案有關的設定。

自動化狀態

效能

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

告警索引標籤

SLA 索引標籤

建立連線

Google Storage 需要 OAuth 認證以建立連線。OAuth 認證應該透過 Google Console 從 Google 直接取得,然後在設定索引標籤上的以下端口欄位中指定:
  • OAuth 用戶端 ID
  • OAuth 用戶端密碼
Google 在生成 OAuth 認證時可能需要 OAuth 回呼/重新導向 URL。知行之橋 的回呼/重新導向 URL 與應用程式託管處的地址和端口相同,加下面的源路徑:src/oauthCallback.rst。例如,如果 知行之橋 託管在 ‘mydomain.com’ 的 8001 端口,應指定下面的 URL 為回呼/重新導向 URL:http://mydomain.com:8001/src/oauthCallback.rst。 一旦與 Google 的認證完成,Google Storage 端口會處理重新整理 OAuth 權杖的過程,以確保身分驗證會一直持續。

上傳和下載

上傳

要上傳檔案,將伺服器配置部分的 桶名稱 欄位設定為目標儲存桶,然後將傳送部分的 遠端資料夾 欄位設定為檔案應被上傳的資料夾。每個 Google Storage 端口上傳到一個特定的資料夾位置。 使用 覆蓋遠端檔案 選項,可以確定是覆蓋還是跳過遠端資料夾中已存在的檔案。 配置之後,放置在端口 交易 索引標籤中的檔案將會被上傳至遠端儲存。如果 傳送自動化 啟用,上傳將會自動進行;否則,可以透過 交易 索引標籤傳送單個檔案。

下載

要下載檔案,將接收部分的 遠端資料夾 欄位設定為下載檔案的資料夾。多個下載資料夾可以使用逗號分隔。 可以將進階設定索引標籤上的 接收過濾規則 欄位設定為全域過濾規則,以指定應從遠端儲存下載哪些檔案(例如 *.txt)。可以使用負模式來確定 不 下載哪些檔案(例如 -*.tmp)。使用逗號分隔清單指定多個過濾規則。 使用 刪除 選項用於切換是否從遠端儲存中刪除成功下載的檔案。 配置之後,將會根據 接收自動化設定的設定下載檔案,或者在 交易 索引標籤中透過點選 接收 按鈕手動下載。

宏

範例