設定パイプラインの作成と管理

パイプラインの作成および設定方法について詳しくは、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"