準備好使用工作流程
您應該先熟悉Astra工作流程的組織和格式、再將其用於即時部署。
簡介
工作流程_是完成特定管理工作或目標所需的一或多個步驟順序。Astra Control工作流程的每個步驟都是下列其中一個步驟:
-
REST API呼叫(詳細資料如Curl和Json範例)
-
呼叫另一個Astra工作流程
-
其他相關工作(例如做出必要的設計決策)
工作流程包括完成每項工作所需的核心步驟和參數。這些工具可提供自訂自動化環境的起點。
|
工作流程只能包含一個步驟。這些單一步驟工作流程的格式與包含多個步驟的工作流程略有不同。例如、會移除明確的步驟名稱。應根據工作流程標題來清除行動或作業。 |
工作流程類別
根據您的部署模式、Astra工作流程分為兩大類。如果您使用Astra Control Center、則應從基礎架構工作流程開始、然後繼續進行管理工作流程。使用Astra Control Service時、您通常可以直接前往管理工作流程。
|
工作流程中的捲髮樣本使用 Astra Control Service 的 URL 。當您根據環境使用內部部署的Astra Control Center時、需要變更URL。 |
基礎架構工作流程
這些工作流程適用於Astra基礎架構、包括認證、儲存庫和儲存後端。Astra Control Center需要這些工具、但在大多數情況下、也可搭配Astra Control Service使用。工作流程著重於建立及維護Astra託管叢集所需的工作。
管理工作流程
您可以在設定託管叢集之後使用這些工作流程。管理工作流程著重於應用程式保護及支援作業、例如備份、還原及複製應用程式。
通用輸入參數
以下所述的輸入參數適用於用來說明REST API呼叫的所有Curl範例。
|
由於這些輸入參數是通用需求、因此不會在個別工作流程中進一步說明。如果特定的捲曲範例使用其他輸入參數、請參閱*其他輸入參數*一節。 |
路徑參數
每次REST API呼叫所使用的端點路徑包括下列參數。另請參閱 "URL格式" 以取得更多資訊。
- 帳戶ID
-
這是UUIDv4值、可識別執行API作業的Astra帳戶。請參閱 "取得API權杖" 如需尋找帳戶ID的詳細資訊、請參閱。
要求標頭
視REST API呼叫而定、您可能需要包含數個要求標頭。
- 授權
-
工作流程中的所有API呼叫都需要API權杖來識別使用者。您必須在「授權」要求標頭中加入該標誌。請參閱 "取得API權杖" 以取得有關產生API權杖的詳細資訊。
- 內容類型
-
使用HTTP POST並將Json包含在要求本文中的要求放入、您應該根據Astra資源來宣告媒體類型。例如、您可以在建立託管應用程式的快照時、加入標題「Content-Type:application/Astra-appsnap+json」。
- 接受
-
您可以根據Astra資源、宣告回應中預期內容的特定媒體類型。例如、您可以在列出託管應用程式的備份時、加入標題「Accept: application/Astra appBackup + json」。不過為了簡化、工作流程中的捲曲範例可接受所有媒體類型。
呈現權杖和識別碼
與捲動範例搭配使用的API權杖和其他ID值不透明、沒有明顯的意義。因此為了改善範例的讀取性、不會使用實際的權杖和ID值。而是使用較小的保留關鍵字、其優點如下:
-
Curl和Json樣本更清楚、更容易瞭解。
-
由於所有關鍵字的格式都與方括弧和大寫字母相同、因此您可以快速識別要插入或擷取的位置和內容。
-
不會遺失任何值、因為無法複製原始參數、並與實際部署搭配使用。
這些變數已格式化、可在 Bash Shell 環境中使用。每個變數都以美元符號開頭、並視需要以雙引號括住。這讓 Bash 能夠辨識他們的能力。大寫字母會持續用於名稱。
以下是Curl範例中使用的一些常用保留關鍵字。此清單並非詳盡無遺、並會視需要使用其他關鍵字。其意義應根據背景而明確。
關鍵字 | 類型 | 說明 |
---|---|---|
$account_ID |
路徑 |
UUIDv4值可識別執行API作業的帳戶。 |
$API_Token |
標頭 |
識別及授權呼叫者的承載權杖。 |
$APP_ID |
路徑 |
UUIDv4值可識別API呼叫的應用程式。 |
使用範例搭配 Bash
如果您直接使用工作流程捲曲範例、則必須使用適合您環境的值來更新這些範例所包含的變數。您可以手動編輯範例、或是仰賴 Bash Shell 為您進行替代、如下所述。
|
使用 Bash 的優點之一是、您可以在 Shell 工作階段中一次設定變數值、而非每個 Curl 命令一次。 |
-
開啟 Linux 或類似作業系統隨附的 Bash Shell 。
-
設定您要執行的捲髮範例所包含的變數值。例如:
$API_TOKEN=SGgpXHeco6M8PLxzIlgbztA4k3_eX4UCa842hOXHBFA=
-
從工作流程頁面複製捲曲範例、然後貼到 Shell 終端機。
-
按 enter 執行下列工作:
-
請取代您設定的變數值。
-
執行 curl 命令。
-