Dapr
v1.19.0Orchestration & Managementワークフロー、アクター、ストレージ、メッセージング、可観測性、スケジューラーによる配置の機能が加わり、性能と正確性も改善されています。既定値の変更や互換性要件、デプロイ時の制約、セキュリティ修正を含むため、アップグレードでは事前の確認と計画が必要です。
要対応 (1)
breakingメトリクスサーバーの許可メソッド応答が変更されました
メトリクスサーバーは、POST、PUT、PATCH、DELETEに対して405を返し、
Allow: GET, HEADを応答するようになりました。
影響確認 (15)
breakingサイドカー更新後の有効化が必要です
すべてのサイドカーが1.19以降で稼働する前に有効化する場合に該当します。
有効化する前に、すべてのサイドカーを1.19以降へ更新する必要があります。
breaking配置用チャートの設定要件が追加されました
global.、scheduler. enabled global.、actors. enabled global.を設定する場合に該当します。actors. serviceName チャートは、
global.、scheduler. enabled global.、actors. enabled global.を設定しないとレンダリングされません。actors. serviceName=placement breakingカスタムRBACにScheduler用権限が必要です
カスタムRBACを使用する場合に該当します。
カスタムRBACを使用する場合は、1.19へ更新する前に
dapr-scheduler-pods用の権限を追加する必要があります。breakingSchedulerによる配置の更新順序が定められました
すべてのサイドカーを1.19以降へ先に更新せずにコントロールプレーンを更新する場合、または更新後にアプリケーションを再起動しない場合に該当します。
global.を使用する場合、すべてのサイドカーを1.19以降へ先に更新し、コントロールプレーンの更新後にアプリケーションを再起動する必要があります。scheduler. placement. enabled breaking
Sentryのロールバック先が制限されました1.19から1.17.6以前へ直接ロールバックする場合に該当します。
1.19から1.17.6以前へ直接ロールバックすることはできません。安全なロールバック先は1.18.xです。
breaking
WorkflowAccessPolicyのダウングレード時にrequiresの調整が必要ですWorkflowAccessPolicyでrequiresを使用する場合に該当します。1.18のコントロールプレーンとサイドカーは
requiresフィールドを認識せず、ゲートなしでルールを適用します。ダウングレード前に、requiresを含むルールを削除するか範囲を狭める必要があります。breaking
WorkflowAccessPolicyCRD適用前のrequiresの扱いが変わりました1.19の
WorkflowAccessPolicyCRDを適用しておらず、requiresを使用する場合に該当します。1.19の
WorkflowAccessPolicyCRDを適用するまで、APIサーバーは新しいrequiresフィールドを破棄します。そのため、requiresを含むルールはそのゲートなしで適用されます。breaking
Scheduler用のPod参照権限が追加されましたSchedulerをデプロイする場合に該当します。チャートはDapr名前空間に
dapr-scheduler-podsのRoleとRoleBindingを追加します。これらにより、Schedulerはpodsに対してget、list、watchを実行できます。breakingetcdコンパクション保持数の既定値が変更されました
--etcd-compaction-retentionとdapr_scheduler.のどちらも設定していない場合に該当します。etcdCompactionRetention --etcd-compaction-retentionフラグとHelm値dapr_scheduler.の既定保持数が、どちらもetcdCompactionRetention 1000000から10000に下がりました。breaking所有外アクターへのタイマー操作が失敗するようになりました
アクターを所有していないサイドカーでタイマー操作を使用する場合に該当します。
所有していないアクターに対するタイマー操作は、そのアクターを所有しないサイドカーで失敗するようになりました。
breaking通常のAMQP URLでTLS設定が拒否されます
通常の
amqp://URLにcaCert、clientCert、またはclientKeyを設定する場合に該当します。通常の
amqp://URLに設定したTLS設定(caCert、clientCert、clientKey)は、コンポーネントの初期化時に拒否されます。breakingサービス呼び出しメソッドの不正なエンコードが拒否されます
%2F、%5C、%2E、またはリテラルの\\を含むサービス呼び出しメソッドを使用する場合に該当します。%2F、%5C、%2E(大文字小文字を問いません)、またはリテラルの\\を含むメソッドは、アクセス制御の確認前に失敗するようになりました。breaking内部アクタータイプの呼び出しが拒否されます
dapr.アクタータイプに対して、gRPCのinternal. * InvokeActorまたはHTTPの/v1.でアクターを呼び出す場合に該当します。0/actors/{type}/{id}/method/{method} gRPCの
InvokeActorとHTTPの/v1.は、すべての0/actors/{type}/{id}/method/{method} dapr.アクタータイプを拒否するようになりました。internal. * breaking
GetConfigurationの参照範囲がアノテーションで指定されます呼び出し元アプリケーションのいずれかのPodに
dapr.アノテーションを付けてio/config GetConfigurationを使用する場合に該当します。GetConfigurationは、呼び出し元アプリケーションのいずれかのPodにあるdapr.アノテーションで指定された設定だけを返します。該当するアノテーションがなければio/config PermissionDeniedを返します。breakingタイムゾーン付き
@everyスケジュールが拒否されますタイムゾーン付きの
@everyスケジュールを使用する場合に該当します。タイムゾーンを指定した
@everyスケジュールは、解析時にtimezone is not supported for @every schedulesというエラーで失敗するようになりました。
その他の記録済み変更 83 件すべてsecurity fixes 1 · additions 45 · value changes 22 · fixes 9 · defaults 3 · constraints 2 · removals 1
security fixes (1)
- Five security fixes. Four of them, for service invocation, the Scheduler and workflows, also shipped in 1.18.6. The fifth makes the Operator enforce app scopes and configuration assignment, and it also shipped in 1.18.9 and 1.17.18. Four of the five change behavior.
additions (45)
- the
workflowblock of the metrics settings inConfigurationnow takes its ownlatencyDistributionBuckets, with alatencyDistributionUnitssuch as1s. - The repository also ships Grafana dashboards for workflows and for the Scheduler in [
grafana/] - A [worker](https://v1-19.docs.dapr.io/developing-applications/building-blocks/workflow/workflow-stateful-client/) can now advertise the
WORKER_CAPABILITY_STATEFUL_HISTORYcapability on its work-item stream. - the sidecar now sends a health ping every 30 seconds to a worker that advertises the
WORKER_CAPABILITY_HEALTH_PINGcapability - The new [
WorkflowsFastPath](https://v1-19.docs.dapr.io/developing-applications/building-blocks/workflow/workflow-fast-path/) [preview feature](https://v1-19.docs.dapr.io/operations/support/support-preview-features/) is off by default. - A workflow client can now run its operations on a workflow that [another app in the same namespace](https://v1-19.docs.dapr.io/developing-applications/building-blocks/workflow/workflow-multi-app/) owns
- The workflow request protos have a new optional
app_idfield, and the HTTP endpoints accept anappIDquery parameter. - A [
WorkflowAccessPolicy](https://v1-19.docs.dapr.io/operations/security/workflow-access-policy/) rule can now have arequiresblock. - A workflow can now start a [detached workflow](https://v1-19.docs.dapr.io/developing-applications/building-blocks/workflow/workflow-detached/).
- With this feature on, the [Scheduler](https://v1-19.docs.dapr.io/concepts/dapr-services/scheduler/) places actors itself
- set this Helm value
dapr_scheduler_placement_leaderanddapr_scheduler_placement_streams_connectedshow the leader and the connected sidecars, anddapr_scheduler_placement_incapable_sidecarscounts sidecars older than 1.19.- New flags: daprd
--actors-placement-startup-timeout - use [
dapr init --scheduler-placement](https://v1-19.docs.dapr.io/reference/cli/dapr-init/) - A new [building block](https://v1-19.docs.dapr.io/developing-applications/building-blocks/binarystore/) stores files through one API
- HTTP:
/v1..0-alpha1/binarystore/{name}/{fileName} - gRPC:
SetBinaryFileAlpha1streams a file in,GetBinaryFileAlpha1streams it out, andDeleteBinaryFileAlpha1deletes it. - SDK support in 1.19: .NET (via
Dapr.) and JavaScript (BinaryStore @dapr/dapr). - A new [building block](https://v1-19.docs.dapr.io/developing-applications/building-blocks/search/) lets an application store, retrieve and query documents
- Components:
search., andmeilisearch search.for tests.in-memory - SDK support in 1.19: .NET (via [
Dapr.](https://www.nuget.org/packages/Dapr.Search)) and JavaScript (Search @dapr/dapr). - A new [building block](https://v1-19.docs.dapr.io/developing-applications/building-blocks/vector/) provides a means to store, retrieve and run similarity queries
- Components:
vector., andmeilisearch vector.for tests.in-memory - SDK support in 1.19: .NET (via [
Dapr.](https://www.nuget.org/packages/Dapr.Vector)) and JavaScript (Vector @dapr/dapr). - gRPC: [
ListActorTimersandGetActorTimer](https://v1-19.docs.dapr.io/reference/api/actors_api/). - HTTP:
GET /v1.and0/actors/{actorType}/{actorId}/timers GET /v1..0/actors/{actorType}/{actorId}/timers/{name} - HTTP:
GET /v1., to match the gRPC0/actors/{actorType}/{actorId}/reminders ListActorRemindersAPI. - daprd now sends a
Dapr-Actor-Activation-Idheader producerTransactionsEnabled: every publish, single or bulk, runs in a Kafka transactionconsumerIsolationLevel: "read_committed": a subscription reads only committed records.consumerTransactionsEnabled: each delivery runs inside a transaction- Two new metadata options, [
exchangeDeclareModeandqueueDeclareMode] - The [AMQP 1.0 component](https://v1-19.docs.dapr.io/reference/components-reference/supported-pubsub/setup-amqp/) now also registers as
pubsub..amqp - Subscriptions can set
subscriptionName,durable,sharedandselector - New component settings:
containerID,durableMessagesandapplicationPropertiesFromMetadata. - A [Conversation API](https://v1-19.docs.dapr.io/reference/api/conversation_api/) request can now cap how many tokens a call generates. Set
max_tokenson the request, ormaxTokensin the component metadata as a default. - Set
useResponsesAPI: "true"in the [OpenAI component](https://v1-19.docs.dapr.io/reference/components-reference/supported-conversation/openai/) metadata --log-outputs: a comma-separated list of log destinations (stdout,stderr, or a file path).--log-file-max-size,--log-file-max-backups,--log-file-max-ageand--log-file-compression: rotation for file destinations.--log-timestamp-format: a Go time layout for the log timestamp.- Dapr 1.19 updates two CRDs:
Configuration(new workflow latency-bucket fields in the metrics settings) andWorkflowAccessPolicy(the new [requires](https://v1-19.docs.dapr.io/operations/security/workflow-access-policy/) field). - The opt-in Helm value
global.(defaultscheduler. placement. enabled false) makes the [Scheduler service](https://v1-19.docs.dapr.io/concepts/dapr-services/scheduler/) serve actor placement, instead of the standalone [Placement service](https://v1-19.docs.dapr.io/concepts/dapr-services/placement/). - the new [
maxConcurrentHandlers](https://v1-19.docs.dapr.io/reference/components-reference/supported-pubsub/setup-azure-eventhubs/) option (default100) limits the batches per partition that wait for a checkpoint. - **Dapr MCP server (alpha).**
- run
dapr init --scheduler-placement.
value changes (22)
- 1.19 contains behavior changes that can affect an upgrade, mostly in the SDKs.
- Workflows: throughput is 40% higher in
TestWorkflowWithConstantVUsand 32% higher inTestSeriesWorkflowWithMaxVUs. - Jobs scheduling: p99 latency is 33% lower (39.5 ms to 26.3 ms), and the test now sustains the full requested 1000 QPS (921 QPS on 1.18.0).
- Actor reminder registration: p99 latency is 71% lower (148 ms to 43 ms), at 43% more registrations per second.
- Configuration subscribe: throughput is 67% higher over HTTP and about 2.8x over gRPC.
- fails with the gRPC
AlreadyExistsstatus code when the instance ID belongs to an active (not completed) instance - A child workflow that runs as a retry attempt now records the instance ID of the first attempt in the parent's history.
- expect actor and workflow activity to pause for longer than that while the Schedulers come back up.
- You can turn the feature on or off without sidecar restarts.
- actors are deactivated and reactivated on their new hosts once per switch, in either direction.
- Workload identity certificates now record which images run in the pod.
- Every [Kubernetes Service](https://v1-19.docs.dapr.io/operations/hosting/kubernetes/) that Dapr creates now sets
appProtocolon each port. - When rotation is on and no size is set, a file rotates at 100 MB.
- Every port of every [Service](https://v1-19.docs.dapr.io/operations/hosting/kubernetes/) that Dapr creates now declares
appProtocol(http,grpc,tls,httpsortcp). - When the Scheduler server stops with a runtime error, for example because its embedded store is briefly unavailable, the Scheduler now recreates it in the process.
- The Scheduler process exits, and Kubernetes restarts it, as in 1.18, so alerts that count Scheduler pod restarts still see this condition.
- The span name no longer contains the actor ID or the reminder or timer name.
- When a message carries no W3C trace context (no
traceparentand no legacytraceid), the sidecar now starts a new root span for the delivery, and the app receives atraceparentheader. pubsub.now answers a handler error with the AMQPsolace. amqp modifiedoutcome, so the broker delivers the message again.- On a 1.19 runtime, [
dapr scheduler list,getanddelete](https://v1-19.docs.dapr.io/reference/cli/dapr-scheduler/) show workflow activity jobs asactivity/<app-id>/<instance-id>::<task-id>::0. - The sidecar sets them from the caller's mTLS identity, and it removes any value that the calling app sets.
- now fail with
no workflow worker is connected for app '<app-id>'instead of actor routing errors such asdid not find address for actor
fixes (9)
- these operations now fail at once with a clear error instead of a 20 second retry and an actor routing error
- When an actor moves to another host, its in-memory timers on the old host are now deleted.
- Publishing with
ttlInSecondsno longer panics the sidecar - a lost connection reconnects with backoff, and a failed link no longer closes the shared connection.
- Before 1.19 the flags had no effect, and the servers always bound all interfaces.
- A duration string such as
"30s"was ignored, and the [component](https://v1-19.docs.dapr.io/reference/components-reference/supported-pubsub/setup-redis-pubsub/) always used 15 seconds. The configured value now applies. - The [setting](https://v1-19.docs.dapr.io/reference/components-reference/supported-configuration-stores/azure-appconfig-configuration-store/) now controls the initial retry delay as documented.
- Before, the checkpoint could move past a failed batch. Now the component retries a failed batch with the
backOff*settings until the handler succeeds. - Inbound retries now use the handler's own context. Before 1.19, they used a context that never ended.
defaults (3)
- The SDKs that support it turn it on by default
- The [default model](https://v1-19.docs.dapr.io/reference/components-reference/supported-conversation/anthropic/) is now
claude-sonnet-4-6, because the previous default model is retired. - A consumer group with no stored checkpoint now starts from the earliest retained event, not the latest.
constraints (2)
- The component also accepts the
x-consistent-hashexchange kind - Set [
vaultAuthMethod: kubernetes](https://v1-19.docs.dapr.io/reference/components-reference/supported-secret-stores/hashicorp-vault/)
removals (1)
- The [workflow Get API](https://v1-19.docs.dapr.io/reference/api/workflow_api/) no longer copies the failure message into
dapr.for a workflow in theworkflow. output FAILEDstate.
対応が必要なリリースが出たときに、週次メールでお知らせします。 今回の破壊的変更も、その一例です。