設定パイプラインの作成と管理
パイプラインの作成および設定方法について詳しくは、CI/CD パイプラインを参照してください。
Cloud Manager で設定パイプラインを作成する場合は、パイプラインを設定する際に、フルスタックコード ではなく ターゲットデプロイメント を選択します。
前述のように、RDE の設定は、パイプラインではなくコマンドラインツールを使用してデプロイされます。
共通の構文
各設定ファイルは、次の例のスニペットに類似したプロパティで始まります。
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
プロパティ | 説明 | デフォルト |
---|---|---|
kind | ログ転送、トラフィックフィルタールール、リクエスト変換などの設定のタイプを決定する文字列 | 必須、デフォルトなし |
version | スキーマバージョンを表す文字列 | 必須、デフォルトなし |
envTypes | この文字列の配列は、metadata ノードの子プロパティです。可能な値は、dev、stage、prod または任意の組み合わせで、設定を処理する環境タイプを決定します。例えば、配列に dev のみが含まれている場合、設定がステージ環境または実稼動環境にデプロイされていても、設定はステージ環境または実稼動環境に読み込まれません。 | すべての環境タイプ(開発、ステージング、実稼働) |
yq
ユーティリティを使用すると、設定ファイル(例:yq cdn.yaml
)の YAML 形式をローカルで検証できます。
フォルダー構造
/config
または類似の名前のフォルダーをツリーの最上部に存在させ、その下のツリー内にもう 1 つの YAML ファイルを存在させる必要があります。
例:
/config
cdn.yaml
または
/config
/dev
cdn.yaml
/config
の下のフォルダー名とファイル名は任意です。ただし、YAML ファイルには有効な kind
プロパティ値を含める必要があります。
通常、設定はすべての環境にデプロイされます。各環境のすべてのプロパティ値が同じである場合は、1 つの YAML ファイルで十分です。ただし、下位環境のテスト時など、環境間でプロパティ値が異なることは一般的です。
次の節では、ファイルを構造化するいくつかの戦略について説明します。
すべての環境に対する 1 つの設定ファイル
ファイル構造は次のようになります。
/config
cdn.yaml
logForwarding.yaml
この構造は、すべての環境とすべての設定のタイプ(CDN、ログ転送など)に対して同じ設定で十分な場合に使用します。このシナリオでは、envTypes
配列プロパティにすべての環境タイプが含まれます。
kind: "cdn"
version: "1"
metadata:
envTypes: ["dev", "stage", "prod"]
秘密鍵タイプの環境変数を使用すると、${{SPLUNK_TOKEN}}
参照で示すように、秘密鍵プロパティを環境ごとに変更できます。
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
data:
splunk:
default:
enabled: true
host: "splunk-host.example.com"
token: "${{SPLUNK_TOKEN}}"
index: "AEMaaCS"