Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/phpunit-feature.yml
Original file line number Diff line number Diff line change
Expand Up @@ -447,7 +447,7 @@ jobs:
-w /app \
--entrypoint sh \
durable-workflow-server-corpus-validator \
-lc 'set -eu; tar --no-same-owner -xf - -C /app; cp -a /app/workflow-package /workflow; php scripts/ci/prepare-release-workflow-composer-metadata.php; composer update durable-workflow/workflow --with-dependencies --minimal-changes --no-install --no-scripts --no-autoloader --no-interaction --no-progress --prefer-dist; composer install --no-interaction --no-progress --prefer-dist; git --version; vendor/bin/phpunit --version; git rev-parse --verify "$CORPUS_BASE_REF^{commit}"; php scripts/ci/check-worker-openapi-evolution.php "$CORPUS_BASE_REF"; vendor/bin/phpunit tests/Feature tests/Unit/NativeReadyOriginSchemaTest.php tests/Unit/NativeScopedDispatchSchemaTest.php tests/Unit/NativePostgresScopedDispatchSchemaTest.php tests/Unit/WorkerProtocolOpenApiContractTest.php tests/Unit/NexusContractTest.php tests/Unit/NativePublishedComposeContractTest.php tests/Unit/PublishedServerAutoSelectionTest.php tests/Unit/CodecRegressionCorpusTest.php tests/Unit/PhpunitFeatureWorkflowContractTest.php tests/Unit/OpenApiDocumentEvolutionTest.php tests/Unit/NamespaceConformanceRunnerContractTest.php tests/Unit/NamespaceRuntimeContractTest.php tests/Unit/SchedulesConformanceRunnerContractTest.php tests/Unit/SchedulesRuntimeContractTest.php tests/Unit/ServerParitySdkDirectionResponseSummaryTest.php tests/Unit/ServerParitySdkQueryTransportTest.php tests/Unit/ServerParitySdkUpdateTransportTest.php tests/Unit/ServerParityLockPressureRetryTest.php tests/Unit/ServerParityManyUpdatesRetryTest.php tests/Unit/ServerParityReadyAgeRestartDiagnosticsTest.php tests/Unit/ServerParityLargeCommandBatchesProbeTest.php --no-progress --colors=never; vendor/bin/phpunit tests/Unit/ReleaseImageContinuationTest.php tests/Unit/ReleaseImageImmutabilityGuardTest.php --no-progress --colors=never; vendor/bin/phpunit tests/Unit/ReleaseImagePublishWorkflowContractTest.php --filter test_php_security_audits_fail_before_release_publication --no-progress --colors=never; python3 scripts/ci/validate-regression-corpus.py --base-ref "$CORPUS_BASE_REF" --verify-counterfactual'
-lc 'set -eu; tar --no-same-owner -xf - -C /app; cp -a /app/workflow-package /workflow; php scripts/ci/prepare-release-workflow-composer-metadata.php; composer update durable-workflow/workflow --with-dependencies --minimal-changes --no-install --no-scripts --no-autoloader --no-interaction --no-progress --prefer-dist; composer install --no-interaction --no-progress --prefer-dist; git --version; vendor/bin/phpunit --version; git rev-parse --verify "$CORPUS_BASE_REF^{commit}"; php scripts/ci/check-worker-openapi-evolution.php "$CORPUS_BASE_REF"; vendor/bin/phpunit tests/Feature tests/Unit/NativeReadyOriginSchemaTest.php tests/Unit/NativeStorageBindingSchemaTest.php tests/Unit/NativeScopedDispatchSchemaTest.php tests/Unit/NativePostgresScopedDispatchSchemaTest.php tests/Unit/WorkerProtocolOpenApiContractTest.php tests/Unit/NexusContractTest.php tests/Unit/NativePublishedComposeContractTest.php tests/Unit/PublishedServerAutoSelectionTest.php tests/Unit/CodecRegressionCorpusTest.php tests/Unit/PhpunitFeatureWorkflowContractTest.php tests/Unit/OpenApiDocumentEvolutionTest.php tests/Unit/NamespaceConformanceRunnerContractTest.php tests/Unit/NamespaceRuntimeContractTest.php tests/Unit/SchedulesConformanceRunnerContractTest.php tests/Unit/SchedulesRuntimeContractTest.php tests/Unit/ServerParitySdkDirectionResponseSummaryTest.php tests/Unit/ServerParitySdkQueryTransportTest.php tests/Unit/ServerParitySdkUpdateTransportTest.php tests/Unit/ServerParityLockPressureRetryTest.php tests/Unit/ServerParityManyUpdatesRetryTest.php tests/Unit/ServerParityReadyAgeRestartDiagnosticsTest.php tests/Unit/ServerParityLargeCommandBatchesProbeTest.php --no-progress --colors=never; vendor/bin/phpunit tests/Unit/ReleaseImageContinuationTest.php tests/Unit/ReleaseImageImmutabilityGuardTest.php --no-progress --colors=never; vendor/bin/phpunit tests/Unit/ReleaseImagePublishWorkflowContractTest.php --filter test_php_security_audits_fail_before_release_publication --no-progress --colors=never; python3 scripts/ci/validate-regression-corpus.py --base-ref "$CORPUS_BASE_REF" --verify-counterfactual'

- name: Select production image qualification for changed build inputs
id: image_inputs
Expand Down
28 changes: 28 additions & 0 deletions docs/contracts/external-payload-storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,34 @@ credentials, endpoints, bucket names, or object references. Production
operators remain responsible for object-store durability, access policy,
backup, retention, and recovery validation.

### Native local-storage policy changes

The native local driver records the original namespace, storage generation and
canonical root with each admitted object. Disabling new uploads keeps existing
references readable and reclaimable. Moving the namespace write policy sends
new objects to the new root; existing objects keep their original bindings.
Keep every retained root mounted and accessible to the runtime and maintenance
processes until its objects and committed deletion records have been reclaimed.
Changing the policy does not copy objects between roots.

A disable request that omits the location preserves the configured location.
An upload admitted before a policy change can finish at its original root;
requests admitted afterward use the current enabled policy. The public reference
and authenticated namespace boundary remain unchanged.

Schema upgrade leaves older registrations unbound until their recorded URI can
be matched to an admitted local policy. Reads bind them on first use, and a
policy change pins them before replacing the policy. An unavailable or mismatched
original root returns the nonretryable
`external_payload_storage_binding_unavailable` outcome. Restore the original
mount or explicitly configure its matching location before retrying the failed
operation. The runtime does not recreate an empty retained root or infer storage
authority from an arbitrary URI.

Backups must preserve the registry and deletion journals together with bytes
from all retained roots, including roots no longer selected for new uploads.
Prove restored reads before releasing the backup hold.

## State, expiry, and retention

An upload starts as unclaimed and expires after the advertised abandoned-upload
Expand Down
3 changes: 3 additions & 0 deletions rust/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -539,6 +539,9 @@ restart, all database families and S3 qualification. The actual byte probe is
an isolated runtime configured with its disposable fixture token, a default
namespace, four MiB payload ceiling and one-object namespace quota. See the
[port log](../docs/rust-server-port.md) for its precise acceptance scope.
Registered local objects retain their original storage bindings across disabled
or moved write policies. Preserve all retained roots through backup and recovery;
see [local policy changes](../docs/contracts/external-payload-storage.md#native-local-storage-policy-changes).
Workflow start, activity arguments, terminal workflow completion and activity completion accept
verified opaque external payloads. Retention commits with the admitted input or fenced result; cold
delivery, history and descriptions keep references for normal SDK hydration.
Expand Down
1 change: 1 addition & 0 deletions rust/migrations/mariadb/0015_checksum.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
b35a67f3f950226a48d2ebf64e668d4dbe84aac2990e47c31bb758ff5817dce0872294e1fbf7994ea868a4d0f8d7d1c5
Loading
Loading