Skip to content

Commit 2697578

Browse files
committed
Addressing feedback
Signed-off-by: ytimocin <ytimocin@microsoft.com>
1 parent 748836b commit 2697578

File tree

1 file changed

+6
-16
lines changed

1 file changed

+6
-16
lines changed

architecture/2025-03-upgrade-design-doc.md

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,7 @@ RELEASE VERSION BICEP COMMIT
219219
0.40.0 v0.40.0 0.31.93 1dd17270ec9bc9e725f314fa62c249406034edda
220220

221221
# Upgrade directly to latest version
222-
> rad upgrade kubernetes --version latest
222+
> rad upgrade kubernetes --version latest (Future Version)
223223

224224
Initiating Radius upgrade from v0.40.0 to v0.44.0 (latest stable)...
225225
Pre-flight checks:
@@ -571,7 +571,6 @@ The upgrade process will implement the following error handling strategies:
571571
3. **Helm-based Rollback**: For version 1, failed upgrades will leverage Helm's built-in rollback capability to revert Kubernetes resources to their previous state. Note that this does not include restoration of any user data that might have been modified during the failed upgrade attempt. Full user data backup and restore capabilities will be added in a future version.
572572
4. **Detailed Error Reporting**: Clear error messages with troubleshooting guidance.
573573
5. **Idempotent Operations**: Commands can be safely retried after addressing issues.
574-
6. **Resource Cleanup**: Temporary resources created during the upgrade are properly removed.
575574

576575
## Test Plan
577576

@@ -581,12 +580,6 @@ The upgrade process will implement the following error handling strategies:
581580
- Test each preflight check with various input scenarios (pass/fail/warning)
582581
- Test preflight check registry with multiple checks of different severities
583582

584-
### Integration Tests
585-
586-
- Verify interactions between components during upgrade process
587-
- Test lock acquisition and release across multiple commands
588-
- Validate backup/restore operations against actual databases
589-
590583
### End-to-End Tests
591584

592585
- Perform upgrades across consecutive versions (e.g., v0.43 → v0.44)
@@ -596,15 +589,12 @@ The upgrade process will implement the following error handling strategies:
596589

597590
## Security
598591

599-
No changes to the existing security model needed.
600-
601-
## Compatibility (optional)
592+
No changes to the existing security model needed. However, when the backup/restore functionality is implemented in future versions, several security considerations will apply:
602593

603-
<!--
604-
Describe potential compatibility issues with other components, such as
605-
incompatibility with older CLIs, and include any breaking changes to
606-
behaviors or APIs.
607-
-->
594+
- **Backup storage location**: User data backups will be stored as Kubernetes resources (ConfigMaps or PersistentVolumes) within the same namespace as the Radius installation, inheriting the cluster's security boundaries.
595+
- **Access control**: Only users with appropriate Kubernetes RBAC permissions to the Radius namespace will be able to access or manage these backups, following the principle of least privilege.
596+
- **Backup lifecycle**: Backups will have configurable retention policies with automatic pruning of older backups after successful upgrades, preventing accumulation of sensitive historical data.
597+
- **Data sensitivity**: Since backups contain only metadata about user applications (not the applications themselves), the security risk is limited to configuration exposure rather than direct workload compromise.
608598

609599
## Monitoring and Logging
610600

0 commit comments

Comments
 (0)