prvng_platform/docs/deployment/known-issues.md
2026-01-14 05:24:46 +00:00

2.4 KiB

Known Issues - Provisioning Platform

Control-Center Requires Rust Nightly (Edition 2024 Dependency)

Status: Resolved (using nightly) Severity: Low Affects: Docker deployment only Date Reported: 2025-10-07 Date Resolved: 2025-10-07

Issue

Control-center Docker builds fail with the following error:

feature 'edition2024' is required
this Cargo does not support nightly features, but if you
switch to nightly channel you can add
`cargo-features = ["edition2024"]` to enable this feature

Root Cause

Dependency chain:

control-center → surrealdb 2.3.10 → surrealdb-core 2.3.10 → async-graphql 7.0.17

The async-graphql-value crate v7.0.17 requires Rust edition 2024, which is not yet stable in Rust 1.82. Edition 2024 is currently only available in Rust nightly builds.

Resolution

Updated Dockerfiles to use Rust nightly (2025-10-07):

Both orchestrator/Dockerfile and control-center/Dockerfile now use:

FROM rustlang/rust:nightly-bookworm AS builder

This provides edition2024 support required by the surrealdb dependency chain.

Production Considerations

Rust Nightly Stability:

  • Nightly builds are generally stable for compilation
  • The compiled binaries are production-ready
  • Runtime behavior is not affected by nightly vs stable compilation
  • Consider pinning to a specific nightly date for reproducible builds

Alternative: Use native deployment with stable Rust if nightly is a concern:

cd provisioning/platform/scripts
nu run-native.nu build
nu run-native.nu start-all --background

Timeline

  • Rust 1.85 (estimated Feb 2025): Expected to stabilize edition 2024
  • SurrealDB 3.x: May drop async-graphql dependency

Tracking

  • provisioning/platform/control-center/Dockerfile
  • provisioning/platform/Cargo.toml (workspace dependencies)
  • provisioning/platform/control-center/Cargo.toml

RocksDB Build Takes Long Time

Status: Known Limitation Severity: Low Affects: All builds

Issue

RocksDB compilation takes 30-60 seconds during builds.

Workaround

Use cached Docker layers or native builds with incremental compilation.


Last Updated: 2025-10-07