次の方法で共有


Microsoft.AppPlatform Spring/apps/deployments

Bicep リソース定義

Spring/apps/deployments リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.AppPlatform/Spring/apps/deployments リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2024-05-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      apms: [
        {
          resourceId: 'string'
        }
      ]
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {
        {customized property}: 'string'
      }
      livenessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      readinessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      resourceRequests: {
        cpu: 'string'
        memory: 'string'
      }
      scale: {
        maxReplicas: int
        minReplicas: int
        rules: [
          {
            azureQueue: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              queueLength: int
              queueName: 'string'
            }
            custom: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
              type: 'string'
            }
            http: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
            }
            name: 'string'
            tcp: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
            }
          }
        ]
      }
      startupProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      terminationGracePeriodSeconds: int
    }
    source: {
      version: 'string'
      type: 'string'
      // For remaining properties, see UserSourceInfo objects
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
}

ProbeAction オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

ExecActionの場合は、次のコマンドを使用します。

{
  command: [
    'string'
  ]
  type: 'ExecAction'
}

HTTPGetActionを する場合は、次のコマンドを使用します。

{
  path: 'string'
  scheme: 'string'
  type: 'HTTPGetAction'
}

TCPSocketActionを する場合は、次のコマンドを使用します。

{
  type: 'TCPSocketAction'
}

UserSourceInfo オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

BuildResultの場合は、次を使用します。

{
  buildResultId: 'string'
  type: 'BuildResult'
}

コンテナーの場合は、次を使用します。

{
  customContainer: {
    args: [
      'string'
    ]
    command: [
      'string'
    ]
    containerImage: 'string'
    imageRegistryCredential: {
      password: 'string'
      username: 'string'
    }
    languageFramework: 'string'
    server: 'string'
  }
  type: 'Container'
}

Jarの場合は、次を使用します。

{
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Jar'
}

NetCoreZipの場合は、次の値を使用します。

{
  netCoreMainEntryPath: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'NetCoreZip'
}

ソースの場合は、次を使用します。

{
  artifactSelector: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Source'
}

Warの場合は、次を使用します。

{
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  serverVersion: 'string'
  type: 'War'
}

プロパティ値

ApmReference

名前 形容 価値
resourceId APM のリソース ID string (必須)

BuildResultUserSourceInfo

名前 形容 価値
buildResultId 同じ Spring インスタンスの既存の成功したビルド結果のリソース ID。
種類 アップロードされたソースの種類 'BuildResult' (必須)

ContainerProbeSettings

名前 形容 価値
disableProbe liveness プローブと準備プローブを無効にするかどうかを示します bool

CustomContainer

名前 形容 価値
args エントリポイントの引数。 これが指定されていない場合は、Docker イメージの CMD が使用されます。 string[]
命令 Entrypoint 配列。 シェル内では実行されません。 これが指定されていない場合は、Docker イメージの ENTRYPOINT が使用されます。 string[]
containerImage カスタム コンテナーのコンテナー イメージ。 これは、<リポジトリの>の形式である必要があります。レジストリのサーバー名のないタグ<>
imageRegistryCredential イメージ レジストリの資格情報 ImageRegistryCredential
languageFramework アップロードされたコンテナー イメージの言語フレームワーク。 サポートされる値: "springboot"、""、null。
サーバー コンテナー イメージを含むレジストリの名前

CustomContainerUserSourceInfo

名前 形容 価値
customContainer カスタム コンテナー ペイロード CustomContainer の
種類 アップロードされたソースの種類 'Container' (必須)

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値

DeploymentResourceProperties

名前 形容 価値
能動 展開がアクティブかどうかを示します bool
deploymentSettings 展開の展開設定 DeploymentSettings
デプロイのアップロードされたソース情報。 UserSourceInfo の

DeploymentSettings

名前 形容 価値
addonConfigs アドオンのコレクション DeploymentSettingsAddonConfigs
apms ApmReferences のコレクション ApmReference[]
containerProbeSettings コンテナーのライブネスと準備プローブの設定 ContainerProbeSettings
environmentVariables 環境変数のコレクション DeploymentSettingsEnvironmentVariables
livenessProbe アプリ インスタンスのライブネスの定期的なプローブ。 プローブが失敗すると、アプリ インスタンスが再起動されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
readinessProbe App Instance サービスの準備状況の定期的なプローブ。 プローブが失敗した場合、App Instance はサービス エンドポイントから削除されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
resourceRequests 必要な CPU とメモリに対して要求されたリソース量。 必要な CPU とメモリを表すためにこのフィールドを使用することをお勧めします。古いフィールドの cpu と memoryInGB は後で非推奨になります。 ResourceRequests
規模 Azure Spring Apps アプリ インスタンスのプロパティのスケーリング。 スケール
startupProbe StartupProbe は、アプリ インスタンスが正常に初期化されたことを示します。 指定した場合、これが正常に完了するまで、他のプローブは実行されません。 このプローブが失敗した場合、livenessProbe が失敗した場合と同様に、ポッドが再起動されます。 これは、データの読み込みまたはキャッシュのウォーム化に長い時間がかかる場合に、アプリ インスタンスのライフサイクルの開始時に、安定状態の操作中とは異なるプローブ パラメーターを提供するために使用できます。 これは更新できません。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
terminationGracePeriodSeconds アプリ インスタンスが正常に終了する必要がある時間 (秒単位)。 削除要求で減らされる可能性があります。 値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 この値が nil の場合は、代わりに既定の猶予期間が使用されます。 猶予期間は、アプリ インスタンスで実行されているプロセスが終了シグナルを送信してから、プロセスが強制終了シグナルで強制的に停止されるまでの時間 (秒単位) です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 既定値は 90 秒です。 int

DeploymentSettingsAddonConfigs

名前 形容 価値

DeploymentSettingsEnvironmentVariables

名前 形容 価値

ExecAction

名前 形容 価値
命令 コマンドはコンテナー内で実行するコマンド ラインであり、コマンドの作業ディレクトリはコンテナーのファイルシステムのルート ('/') です。 このコマンドはシェル内では実行されないため、従来のシェル命令 (' 'など) は機能しません。 シェルを使用するには、そのシェルを明示的に呼び出す必要があります。 終了ステータス 0 はライブ/正常として扱われ、0 以外は異常として扱われます。 string[]
種類 正常性チェックを実行するために実行するアクションの種類。 'ExecAction' (必須)

HttpGetAction

名前 形容 価値
パス HTTP サーバー上のアクセスのパス。
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。

指定できる列挙値:
- "HTTP" は、使用されるスキームが http:// されることを意味します
- "HTTPS" は、使用されるスキームが https:// されることを意味します
'HTTP'
'HTTPS'
種類 正常性チェックを実行するために実行するアクションの種類。 'HTTPGetAction' (必須)

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値

ImageRegistryCredential

名前 形容 価値
パスワード イメージ レジストリ資格情報のパスワード
username イメージ レジストリ資格情報のユーザー名

JarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion Jar ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Jar' (必須)

Microsoft.AppPlatform/Spring/apps/deployments

名前 形容 価値
名前 リソース名 string (必須)
Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。
種類のリソースのシンボリック名: spring/apps
プロパティ デプロイ リソースのプロパティ DeploymentResourceProperties の
sku デプロイ リソースの SKU SKU

NetCoreZipUploadedUserSourceInfo

名前 形容 価値
netCoreMainEntryPath zip ルートを基準とした .NET 実行可能ファイルへのパス
relativePath ソースを格納するストレージの相対パス
runtimeVersion .Net ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'NetCoreZip' (必須)

プローブ

名前 形容 価値
disableProbe プローブが無効かどうかを示します。 bool (必須)
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 最小値は 1 です。 int
initialDelaySeconds プローブが開始されるまでのアプリ インスタンスの開始後の秒数。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds プローブを実行する頻度 (秒単位)。 最小値は 1 です。 int
probeAction プローブのアクション。 ProbeAction の
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 int
timeoutSeconds プローブがタイムアウトする秒数。最小値は 1 です。 int

ProbeAction

名前 形容 価値
種類 ExecAction型 'ExecAction' に設定します。 HttpGetActionの型 'HTTPGetAction' に設定します。 TCPSocketAction'TCPSocketAction' に設定します。 'ExecAction'
'HTTPGetAction'
'TCPSocketAction' (必須)

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ResourceRequests

名前 形容 価値
cpu 必要な CPU。 1 コアは 1 または 1000m で表すことができます。 Basic レベルの場合は 500m または 1、Standard レベルの場合は {500m、1、2、3、4} です。
記憶 必要なメモリ。 1 GB は 1Gi または 1024Mi で表すことができます。 Basic レベルの場合は {512Mi、1Gi、2Gi}、Standard レベルの場合は {512Mi、1Gi、2Gi、...、8Gi} です。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名
tcp Tcp 要求ベースのスケーリング。 TcpScaleRule の

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となる Azure Spring Apps アプリ インスタンス シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

SKU

名前 形容 価値
能力 ターゲット リソースの現在の容量 int
名前 SKU の名前
SKU の階層

SourceUploadedUserSourceInfo

名前 形容 価値
artifactSelector マルチモジュール プロジェクトのデプロイに使用する成果物のセレクター。 これは次のようになります。
ターゲット モジュール/プロジェクトへの相対パス。
relativePath ソースを格納するストレージの相対パス
runtimeVersion ソース ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Source' (必須)

TcpScaleRule

名前 形容 価値
認証 TCP スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata TCP スケール ルールを記述するメタデータ プロパティ。 TcpScaleRuleMetadata の

TcpScaleRuleMetadata

名前 形容 価値

TCPSocketAction

名前 形容 価値
種類 正常性チェックを実行するために実行するアクションの種類。 'TCPSocketAction' (必須)

UserSourceInfo

名前 形容 価値
種類 BuildResultUserSourceInfoの型 'BuildResult' に設定します。 CustomContainerUserSourceInfoの型 'Container' に設定します。 JarUploadedUserSourceInfoの型 'Jar' に設定します。 NetCoreZipUploadedUserSourceInfo種類として 'NetCoreZip' に設定します。 SourceUploadedUserSourceInfo種類として 'Source' に設定します。 WarUploadedUserSourceInfo種類として 'War' に設定します。 'BuildResult'
'Container'
'Jar'
'NetCoreZip'
'Source'
'War' (必須)
バージョン ソースのバージョン

WarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion war ファイルのランタイム バージョン
serverVersion サーバー のバージョン。現在サポートされているのは Apache Tomcat のみです
種類 アップロードされたソースの種類 'War' (必須)

クイック スタートのサンプル

次のクイック スタート サンプルでは、このリソースの種類をデプロイします。

Bicep ファイル 形容
単純な Azure Spring Apps マイクロサービス アプリケーション をデプロイする このテンプレートは、Azure 上で実行する単純な Azure Spring Apps マイクロサービス アプリケーションをデプロイします。

ARM テンプレート リソース定義

Spring/apps/deployments リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.AppPlatform/Spring/apps/deployments リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.AppPlatform/Spring/apps/deployments",
  "apiVersion": "2024-05-01-preview",
  "name": "string",
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {
        "{customized property}": {}
      },
      "apms": [
        {
          "resourceId": "string"
        }
      ],
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {
        "{customized property}": "string"
      },
      "livenessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "readinessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "resourceRequests": {
        "cpu": "string",
        "memory": "string"
      },
      "scale": {
        "maxReplicas": "int",
        "minReplicas": "int",
        "rules": [
          {
            "azureQueue": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "queueLength": "int",
              "queueName": "string"
            },
            "custom": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              },
              "type": "string"
            },
            "http": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              }
            },
            "name": "string",
            "tcp": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              }
            }
          }
        ]
      },
      "startupProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "terminationGracePeriodSeconds": "int"
    },
    "source": {
      "version": "string",
      "type": "string"
      // For remaining properties, see UserSourceInfo objects
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  }
}

ProbeAction オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

ExecActionの場合は、次のコマンドを使用します。

{
  "command": [ "string" ],
  "type": "ExecAction"
}

HTTPGetActionを する場合は、次のコマンドを使用します。

{
  "path": "string",
  "scheme": "string",
  "type": "HTTPGetAction"
}

TCPSocketActionを する場合は、次のコマンドを使用します。

{
  "type": "TCPSocketAction"
}

UserSourceInfo オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

BuildResultの場合は、次を使用します。

{
  "buildResultId": "string",
  "type": "BuildResult"
}

コンテナーの場合は、次を使用します。

{
  "customContainer": {
    "args": [ "string" ],
    "command": [ "string" ],
    "containerImage": "string",
    "imageRegistryCredential": {
      "password": "string",
      "username": "string"
    },
    "languageFramework": "string",
    "server": "string"
  },
  "type": "Container"
}

Jarの場合は、次を使用します。

{
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Jar"
}

NetCoreZipの場合は、次の値を使用します。

{
  "netCoreMainEntryPath": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "NetCoreZip"
}

ソースの場合は、次を使用します。

{
  "artifactSelector": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Source"
}

Warの場合は、次を使用します。

{
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "serverVersion": "string",
  "type": "War"
}

プロパティ値

ApmReference

名前 形容 価値
resourceId APM のリソース ID string (必須)

BuildResultUserSourceInfo

名前 形容 価値
buildResultId 同じ Spring インスタンスの既存の成功したビルド結果のリソース ID。
種類 アップロードされたソースの種類 'BuildResult' (必須)

ContainerProbeSettings

名前 形容 価値
disableProbe liveness プローブと準備プローブを無効にするかどうかを示します bool

CustomContainer

名前 形容 価値
args エントリポイントの引数。 これが指定されていない場合は、Docker イメージの CMD が使用されます。 string[]
命令 Entrypoint 配列。 シェル内では実行されません。 これが指定されていない場合は、Docker イメージの ENTRYPOINT が使用されます。 string[]
containerImage カスタム コンテナーのコンテナー イメージ。 これは、<リポジトリの>の形式である必要があります。レジストリのサーバー名のないタグ<>
imageRegistryCredential イメージ レジストリの資格情報 ImageRegistryCredential
languageFramework アップロードされたコンテナー イメージの言語フレームワーク。 サポートされる値: "springboot"、""、null。
サーバー コンテナー イメージを含むレジストリの名前

CustomContainerUserSourceInfo

名前 形容 価値
customContainer カスタム コンテナー ペイロード CustomContainer の
種類 アップロードされたソースの種類 'Container' (必須)

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値

DeploymentResourceProperties

名前 形容 価値
能動 展開がアクティブかどうかを示します bool
deploymentSettings 展開の展開設定 DeploymentSettings
デプロイのアップロードされたソース情報。 UserSourceInfo の

DeploymentSettings

名前 形容 価値
addonConfigs アドオンのコレクション DeploymentSettingsAddonConfigs
apms ApmReferences のコレクション ApmReference[]
containerProbeSettings コンテナーのライブネスと準備プローブの設定 ContainerProbeSettings
environmentVariables 環境変数のコレクション DeploymentSettingsEnvironmentVariables
livenessProbe アプリ インスタンスのライブネスの定期的なプローブ。 プローブが失敗すると、アプリ インスタンスが再起動されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
readinessProbe App Instance サービスの準備状況の定期的なプローブ。 プローブが失敗した場合、App Instance はサービス エンドポイントから削除されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
resourceRequests 必要な CPU とメモリに対して要求されたリソース量。 必要な CPU とメモリを表すためにこのフィールドを使用することをお勧めします。古いフィールドの cpu と memoryInGB は後で非推奨になります。 ResourceRequests
規模 Azure Spring Apps アプリ インスタンスのプロパティのスケーリング。 スケール
startupProbe StartupProbe は、アプリ インスタンスが正常に初期化されたことを示します。 指定した場合、これが正常に完了するまで、他のプローブは実行されません。 このプローブが失敗した場合、livenessProbe が失敗した場合と同様に、ポッドが再起動されます。 これは、データの読み込みまたはキャッシュのウォーム化に長い時間がかかる場合に、アプリ インスタンスのライフサイクルの開始時に、安定状態の操作中とは異なるプローブ パラメーターを提供するために使用できます。 これは更新できません。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
terminationGracePeriodSeconds アプリ インスタンスが正常に終了する必要がある時間 (秒単位)。 削除要求で減らされる可能性があります。 値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 この値が nil の場合は、代わりに既定の猶予期間が使用されます。 猶予期間は、アプリ インスタンスで実行されているプロセスが終了シグナルを送信してから、プロセスが強制終了シグナルで強制的に停止されるまでの時間 (秒単位) です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 既定値は 90 秒です。 int

DeploymentSettingsAddonConfigs

名前 形容 価値

DeploymentSettingsEnvironmentVariables

名前 形容 価値

ExecAction

名前 形容 価値
命令 コマンドはコンテナー内で実行するコマンド ラインであり、コマンドの作業ディレクトリはコンテナーのファイルシステムのルート ('/') です。 このコマンドはシェル内では実行されないため、従来のシェル命令 (' 'など) は機能しません。 シェルを使用するには、そのシェルを明示的に呼び出す必要があります。 終了ステータス 0 はライブ/正常として扱われ、0 以外は異常として扱われます。 string[]
種類 正常性チェックを実行するために実行するアクションの種類。 'ExecAction' (必須)

HttpGetAction

名前 形容 価値
パス HTTP サーバー上のアクセスのパス。
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。

指定できる列挙値:
- "HTTP" は、使用されるスキームが http:// されることを意味します
- "HTTPS" は、使用されるスキームが https:// されることを意味します
'HTTP'
'HTTPS'
種類 正常性チェックを実行するために実行するアクションの種類。 'HTTPGetAction' (必須)

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値

ImageRegistryCredential

名前 形容 価値
パスワード イメージ レジストリ資格情報のパスワード
username イメージ レジストリ資格情報のユーザー名

JarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion Jar ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Jar' (必須)

Microsoft.AppPlatform/Spring/apps/deployments

名前 形容 価値
apiVersion API のバージョン '2024-05-01-preview'
名前 リソース名 string (必須)
プロパティ デプロイ リソースのプロパティ DeploymentResourceProperties の
sku デプロイ リソースの SKU SKU
種類 リソースの種類 'Microsoft.AppPlatform/Spring/apps/deployments'

NetCoreZipUploadedUserSourceInfo

名前 形容 価値
netCoreMainEntryPath zip ルートを基準とした .NET 実行可能ファイルへのパス
relativePath ソースを格納するストレージの相対パス
runtimeVersion .Net ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'NetCoreZip' (必須)

プローブ

名前 形容 価値
disableProbe プローブが無効かどうかを示します。 bool (必須)
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 最小値は 1 です。 int
initialDelaySeconds プローブが開始されるまでのアプリ インスタンスの開始後の秒数。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds プローブを実行する頻度 (秒単位)。 最小値は 1 です。 int
probeAction プローブのアクション。 ProbeAction の
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 int
timeoutSeconds プローブがタイムアウトする秒数。最小値は 1 です。 int

ProbeAction

名前 形容 価値
種類 ExecAction型 'ExecAction' に設定します。 HttpGetActionの型 'HTTPGetAction' に設定します。 TCPSocketAction'TCPSocketAction' に設定します。 'ExecAction'
'HTTPGetAction'
'TCPSocketAction' (必須)

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ResourceRequests

名前 形容 価値
cpu 必要な CPU。 1 コアは 1 または 1000m で表すことができます。 Basic レベルの場合は 500m または 1、Standard レベルの場合は {500m、1、2、3、4} です。
記憶 必要なメモリ。 1 GB は 1Gi または 1024Mi で表すことができます。 Basic レベルの場合は {512Mi、1Gi、2Gi}、Standard レベルの場合は {512Mi、1Gi、2Gi、...、8Gi} です。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名
tcp Tcp 要求ベースのスケーリング。 TcpScaleRule の

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となる Azure Spring Apps アプリ インスタンス シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

SKU

名前 形容 価値
能力 ターゲット リソースの現在の容量 int
名前 SKU の名前
SKU の階層

SourceUploadedUserSourceInfo

名前 形容 価値
artifactSelector マルチモジュール プロジェクトのデプロイに使用する成果物のセレクター。 これは次のようになります。
ターゲット モジュール/プロジェクトへの相対パス。
relativePath ソースを格納するストレージの相対パス
runtimeVersion ソース ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Source' (必須)

TcpScaleRule

名前 形容 価値
認証 TCP スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata TCP スケール ルールを記述するメタデータ プロパティ。 TcpScaleRuleMetadata の

TcpScaleRuleMetadata

名前 形容 価値

TCPSocketAction

名前 形容 価値
種類 正常性チェックを実行するために実行するアクションの種類。 'TCPSocketAction' (必須)

UserSourceInfo

名前 形容 価値
種類 BuildResultUserSourceInfoの型 'BuildResult' に設定します。 CustomContainerUserSourceInfoの型 'Container' に設定します。 JarUploadedUserSourceInfoの型 'Jar' に設定します。 NetCoreZipUploadedUserSourceInfo種類として 'NetCoreZip' に設定します。 SourceUploadedUserSourceInfo種類として 'Source' に設定します。 WarUploadedUserSourceInfo種類として 'War' に設定します。 'BuildResult'
'Container'
'Jar'
'NetCoreZip'
'Source'
'War' (必須)
バージョン ソースのバージョン

WarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion war ファイルのランタイム バージョン
serverVersion サーバー のバージョン。現在サポートされているのは Apache Tomcat のみです
種類 アップロードされたソースの種類 'War' (必須)

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
単純な Azure Spring Apps マイクロサービス アプリケーション をデプロイする

Azure にデプロイする
このテンプレートは、Azure 上で実行する単純な Azure Spring Apps マイクロサービス アプリケーションをデプロイします。

Terraform (AzAPI プロバイダー) リソース定義

Spring/apps/deployments リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.AppPlatform/Spring/apps/deployments リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AppPlatform/Spring/apps/deployments@2024-05-01-preview"
  name = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  body = jsonencode({
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {
          {customized property} = ?
        }
        apms = [
          {
            resourceId = "string"
          }
        ]
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {
          {customized property} = "string"
        }
        livenessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        readinessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        resourceRequests = {
          cpu = "string"
          memory = "string"
        }
        scale = {
          maxReplicas = int
          minReplicas = int
          rules = [
            {
              azureQueue = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                queueLength = int
                queueName = "string"
              }
              custom = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
                type = "string"
              }
              http = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
              }
              name = "string"
              tcp = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
              }
            }
          ]
        }
        startupProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        terminationGracePeriodSeconds = int
      }
      source = {
        version = "string"
        type = "string"
        // For remaining properties, see UserSourceInfo objects
      }
    }
  })
}

ProbeAction オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

ExecActionの場合は、次のコマンドを使用します。

{
  command = [
    "string"
  ]
  type = "ExecAction"
}

HTTPGetActionを する場合は、次のコマンドを使用します。

{
  path = "string"
  scheme = "string"
  type = "HTTPGetAction"
}

TCPSocketActionを する場合は、次のコマンドを使用します。

{
  type = "TCPSocketAction"
}

UserSourceInfo オブジェクト

プロパティを設定して、オブジェクトの型を指定します。

BuildResultの場合は、次を使用します。

{
  buildResultId = "string"
  type = "BuildResult"
}

コンテナーの場合は、次を使用します。

{
  customContainer = {
    args = [
      "string"
    ]
    command = [
      "string"
    ]
    containerImage = "string"
    imageRegistryCredential = {
      password = "string"
      username = "string"
    }
    languageFramework = "string"
    server = "string"
  }
  type = "Container"
}

Jarの場合は、次を使用します。

{
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Jar"
}

NetCoreZipの場合は、次の値を使用します。

{
  netCoreMainEntryPath = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "NetCoreZip"
}

ソースの場合は、次を使用します。

{
  artifactSelector = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Source"
}

Warの場合は、次を使用します。

{
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"
  serverVersion = "string"
  type = "War"
}

プロパティ値

ApmReference

名前 形容 価値
resourceId APM のリソース ID string (必須)

BuildResultUserSourceInfo

名前 形容 価値
buildResultId 同じ Spring インスタンスの既存の成功したビルド結果のリソース ID。
種類 アップロードされたソースの種類 'BuildResult' (必須)

ContainerProbeSettings

名前 形容 価値
disableProbe liveness プローブと準備プローブを無効にするかどうかを示します bool

CustomContainer

名前 形容 価値
args エントリポイントの引数。 これが指定されていない場合は、Docker イメージの CMD が使用されます。 string[]
命令 Entrypoint 配列。 シェル内では実行されません。 これが指定されていない場合は、Docker イメージの ENTRYPOINT が使用されます。 string[]
containerImage カスタム コンテナーのコンテナー イメージ。 これは、<リポジトリの>の形式である必要があります。レジストリのサーバー名のないタグ<>
imageRegistryCredential イメージ レジストリの資格情報 ImageRegistryCredential
languageFramework アップロードされたコンテナー イメージの言語フレームワーク。 サポートされる値: "springboot"、""、null。
サーバー コンテナー イメージを含むレジストリの名前

CustomContainerUserSourceInfo

名前 形容 価値
customContainer カスタム コンテナー ペイロード CustomContainer の
種類 アップロードされたソースの種類 'Container' (必須)

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値

DeploymentResourceProperties

名前 形容 価値
能動 展開がアクティブかどうかを示します bool
deploymentSettings 展開の展開設定 DeploymentSettings
デプロイのアップロードされたソース情報。 UserSourceInfo の

DeploymentSettings

名前 形容 価値
addonConfigs アドオンのコレクション DeploymentSettingsAddonConfigs
apms ApmReferences のコレクション ApmReference[]
containerProbeSettings コンテナーのライブネスと準備プローブの設定 ContainerProbeSettings
environmentVariables 環境変数のコレクション DeploymentSettingsEnvironmentVariables
livenessProbe アプリ インスタンスのライブネスの定期的なプローブ。 プローブが失敗すると、アプリ インスタンスが再起動されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
readinessProbe App Instance サービスの準備状況の定期的なプローブ。 プローブが失敗した場合、App Instance はサービス エンドポイントから削除されます。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
resourceRequests 必要な CPU とメモリに対して要求されたリソース量。 必要な CPU とメモリを表すためにこのフィールドを使用することをお勧めします。古いフィールドの cpu と memoryInGB は後で非推奨になります。 ResourceRequests
規模 Azure Spring Apps アプリ インスタンスのプロパティのスケーリング。 スケール
startupProbe StartupProbe は、アプリ インスタンスが正常に初期化されたことを示します。 指定した場合、これが正常に完了するまで、他のプローブは実行されません。 このプローブが失敗した場合、livenessProbe が失敗した場合と同様に、ポッドが再起動されます。 これは、データの読み込みまたはキャッシュのウォーム化に長い時間がかかる場合に、アプリ インスタンスのライフサイクルの開始時に、安定状態の操作中とは異なるプローブ パラメーターを提供するために使用できます。 これは更新できません。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes プローブ
terminationGracePeriodSeconds アプリ インスタンスが正常に終了する必要がある時間 (秒単位)。 削除要求で減らされる可能性があります。 値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 この値が nil の場合は、代わりに既定の猶予期間が使用されます。 猶予期間は、アプリ インスタンスで実行されているプロセスが終了シグナルを送信してから、プロセスが強制終了シグナルで強制的に停止されるまでの時間 (秒単位) です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 既定値は 90 秒です。 int

DeploymentSettingsAddonConfigs

名前 形容 価値

DeploymentSettingsEnvironmentVariables

名前 形容 価値

ExecAction

名前 形容 価値
命令 コマンドはコンテナー内で実行するコマンド ラインであり、コマンドの作業ディレクトリはコンテナーのファイルシステムのルート ('/') です。 このコマンドはシェル内では実行されないため、従来のシェル命令 (' 'など) は機能しません。 シェルを使用するには、そのシェルを明示的に呼び出す必要があります。 終了ステータス 0 はライブ/正常として扱われ、0 以外は異常として扱われます。 string[]
種類 正常性チェックを実行するために実行するアクションの種類。 'ExecAction' (必須)

HttpGetAction

名前 形容 価値
パス HTTP サーバー上のアクセスのパス。
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。

指定できる列挙値:
- "HTTP" は、使用されるスキームが http:// されることを意味します
- "HTTPS" は、使用されるスキームが https:// されることを意味します
'HTTP'
'HTTPS'
種類 正常性チェックを実行するために実行するアクションの種類。 'HTTPGetAction' (必須)

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値

ImageRegistryCredential

名前 形容 価値
パスワード イメージ レジストリ資格情報のパスワード
username イメージ レジストリ資格情報のユーザー名

JarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion Jar ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Jar' (必須)

Microsoft.AppPlatform/Spring/apps/deployments

名前 形容 価値
名前 リソース名 string (必須)
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: Spring/apps
プロパティ デプロイ リソースのプロパティ DeploymentResourceProperties の
sku デプロイ リソースの SKU SKU
種類 リソースの種類 "Microsoft.AppPlatform/Spring/apps/deployments@2024-05-01-preview"

NetCoreZipUploadedUserSourceInfo

名前 形容 価値
netCoreMainEntryPath zip ルートを基準とした .NET 実行可能ファイルへのパス
relativePath ソースを格納するストレージの相対パス
runtimeVersion .Net ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'NetCoreZip' (必須)

プローブ

名前 形容 価値
disableProbe プローブが無効かどうかを示します。 bool (必須)
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 最小値は 1 です。 int
initialDelaySeconds プローブが開始されるまでのアプリ インスタンスの開始後の秒数。 詳細情報: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds プローブを実行する頻度 (秒単位)。 最小値は 1 です。 int
probeAction プローブのアクション。 ProbeAction の
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 int
timeoutSeconds プローブがタイムアウトする秒数。最小値は 1 です。 int

ProbeAction

名前 形容 価値
種類 ExecAction型 'ExecAction' に設定します。 HttpGetActionの型 'HTTPGetAction' に設定します。 TCPSocketAction'TCPSocketAction' に設定します。 'ExecAction'
'HTTPGetAction'
'TCPSocketAction' (必須)

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ResourceRequests

名前 形容 価値
cpu 必要な CPU。 1 コアは 1 または 1000m で表すことができます。 Basic レベルの場合は 500m または 1、Standard レベルの場合は {500m、1、2、3、4} です。
記憶 必要なメモリ。 1 GB は 1Gi または 1024Mi で表すことができます。 Basic レベルの場合は {512Mi、1Gi、2Gi}、Standard レベルの場合は {512Mi、1Gi、2Gi、...、8Gi} です。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名
tcp Tcp 要求ベースのスケーリング。 TcpScaleRule の

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となる Azure Spring Apps アプリ インスタンス シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

SKU

名前 形容 価値
能力 ターゲット リソースの現在の容量 int
名前 SKU の名前
SKU の階層

SourceUploadedUserSourceInfo

名前 形容 価値
artifactSelector マルチモジュール プロジェクトのデプロイに使用する成果物のセレクター。 これは次のようになります。
ターゲット モジュール/プロジェクトへの相対パス。
relativePath ソースを格納するストレージの相対パス
runtimeVersion ソース ファイルのランタイム バージョン
種類 アップロードされたソースの種類 'Source' (必須)

TcpScaleRule

名前 形容 価値
認証 TCP スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata TCP スケール ルールを記述するメタデータ プロパティ。 TcpScaleRuleMetadata の

TcpScaleRuleMetadata

名前 形容 価値

TCPSocketAction

名前 形容 価値
種類 正常性チェックを実行するために実行するアクションの種類。 'TCPSocketAction' (必須)

UserSourceInfo

名前 形容 価値
種類 BuildResultUserSourceInfoの型 'BuildResult' に設定します。 CustomContainerUserSourceInfoの型 'Container' に設定します。 JarUploadedUserSourceInfoの型 'Jar' に設定します。 NetCoreZipUploadedUserSourceInfo種類として 'NetCoreZip' に設定します。 SourceUploadedUserSourceInfo種類として 'Source' に設定します。 WarUploadedUserSourceInfo種類として 'War' に設定します。 'BuildResult'
'Container'
'Jar'
'NetCoreZip'
'Source'
'War' (必須)
バージョン ソースのバージョン

WarUploadedUserSourceInfo

名前 形容 価値
jvmOptions JVM パラメーター
relativePath ソースを格納するストレージの相対パス
runtimeVersion war ファイルのランタイム バージョン
serverVersion サーバー のバージョン。現在サポートされているのは Apache Tomcat のみです
種類 アップロードされたソースの種類 'War' (必須)