ワークフローを使用する準備をします
変更を提案
PDF
実際の環境で使用する前に、 Astra ワークフローの構成と形式を理解しておく必要があります。
はじめに
a_workflow_ は、特定の管理タスクまたは目標を達成するために必要な 1 つ以上のステップのシーケンスです。Astra Control ワークフローの各手順は、次のいずれかです。
-
REST API 呼び出し（ cURL や JSON の例などの詳細を含む）
-
別の Astra ワークフローの呼び出し
-
その他の関連タスク（必要な設計決定の実行など）
ワークフローには、各タスクを実行するために必要な主要な手順とパラメータが含まれています。自動化環境をカスタマイズするための出発点となります。
共通の入力パラメータ
以下に記載する入力パラメータは、 REST API 呼び出しを示すために使用するすべての cURL サンプルに共通しています。
|
これらの入力パラメータは汎用的に必要なため、個々のワークフローでは詳しく説明していません。特定のカールの例に追加の入力パラメータが使用される場合は、「 * その他の入力パラメータ * 」セクションで説明します。 |
パスパラメータ
すべての REST API 呼び出しで使用されるエンドポイントパスには、次のパラメータが含まれています。も参照してください "URL 形式" を参照してください。
- アカウント ID
-
これは、 API 処理を実行する Astra アカウントを識別する UUIDv4 値です。を参照してください "API トークンを取得します" アカウント ID の検索の詳細については、を参照してください。
要求ヘッダー
REST API 呼び出しに応じて、いくつかの要求ヘッダーを含める必要があります。
- 承認
-
ワークフロー内のすべての API 呼び出しで、ユーザを識別するための API トークンが必要です。にトークンを含める必要があります
Authorization要求ヘッダー。を参照してください "API トークンを取得します" API トークンの生成の詳細については、を参照してください。 - コンテンツタイプ
-
要求の本文に JSON が含まれている HTTP POST 要求と PUT 要求では、 Astra リソースに基づいてメディアタイプを宣言する必要があります。たとえば、ヘッダーを含めることができます
Content-Type: application/astra-appSnap+json管理対象アプリケーションのスナップショットを作成する場合。 - 同意します
-
アストラリソースに基づいて、応答で想定されるコンテンツの特定のメディアタイプを宣言できます。たとえば、ヘッダーを含めることができます
Accept: application/astra-appBackup+json管理対象アプリケーションのバックアップをリスト表示する場合。ただし、簡単にするために、ワークフロー内のカールサンプルはすべてのメディアタイプに対応しています。
トークンと識別子の表示
cURL の例で使用される API トークンおよびその他の ID 値は不透明で、認識不能な意味はありません。サンプルの読みやすさを向上させるために、実際のトークンと ID 値は使用されません。代わりに、小さい予約済みキーワードが使用されます。これには次のような利点があります。
-
cURL と JSON のサンプルは、より明確でわかりやすくなっています。
-
すべてのキーワードは角かっこと大文字で同じ形式を使用するため、挿入または抽出する場所とコンテンツをすばやく識別できます。
-
元のパラメータをコピーして実際の配置で使用することはできないため、値は失われません。
次に、 curl の例で使用される一般的な予約済みキーワードの一部を示します。このリストはすべてを網羅しているわけではなく、必要に応じてその他のキーワードが使用されていその意味はコンテキストに基づいて明確になる必要があります。
| キーワード | を入力します | 説明 |
|---|---|---|
<account_ID> |
パス |
API 処理を実行するアカウントを識別する UUIDv4 値。 |
<api_ctoken> のように指定します |
ヘッダー |
発信者を識別および認可するベアラトークン。 |
<APP_ID> |
パス |
API呼び出しのアプリケーションを識別するUUIDv4値。 |
ワークフローのカテゴリ
導入モデルに応じて、幅広い種類の Astra ワークフローが用意されています。Astra Control Center を使用している場合は、インフラワークフローから始めて、管理ワークフローに進みます。Astra Control Service を使用すると、通常は管理ワークフローに直接移動できます。
|
|
ワークフロー内の cURL のサンプルでは、 Astra Control Service の URL を使用します。オンプレミスの Astra Control Center を使用している場合は、環境に応じて URL を変更する必要があります。 |
インフラワークフロー
これらのワークフローは、クレデンシャル、バケット、ストレージバックエンドなどの Astra インフラを処理します。Astra Control Center で必要ですが、ほとんどの場合は Astra Control Service でも使用できます。このワークフローでは、マネージドクラスタの構築と保守に必要なタスクを中心に説明します。
管理ワークフロー
これらのワークフローは、管理対象クラスタを作成したあとに使用できます。このワークフローでは、アプリケーションのバックアップ、リストア、クローニングなど、アプリケーションの保護とサポートの処理に重点を置いています。