case 4690 - dev docs: build VM deprecated, releases built on the workstation (backup laptop as fallback)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -95,4 +95,4 @@ dotnet publish server\AyaNova\AyaNova.csproj -c Release -r linux-x64 --no-self-c
|
||||
| `devdocs/modernization/CODEBASE-REFERENCE.md` | Stack, structure, configuration, API conventions |
|
||||
| `devdocs/modernization/TESTING.md` | Test suites and their state |
|
||||
| `devdocs/build/BUILD.md` | Release build, packaging, version numbers |
|
||||
| `devdocs/build/DEV-VM-SETUP.md` | Rebuilding the Windows build VM from scratch |
|
||||
| `devdocs/build/DEV-VM-SETUP.md` | Deprecated build VM plan; its tool list still serves for setting up a build machine. Releases are built on the workstation |
|
||||
|
||||
@@ -3,7 +3,9 @@
|
||||
How a full release is built: tools, folder layout, what `build-release.bat` does, and where
|
||||
version numbers live. Written for .NET 8 (8.2.4); updated for .NET 10 (8.3.0).
|
||||
|
||||
To set up a machine that can run this from scratch, see `DEV-VM-SETUP.md`.
|
||||
Releases are built on the workstation; the backup laptop is the fallback. To set up a machine
|
||||
that can run this from scratch, use the tool list and install commands in `DEV-VM-SETUP.md`
|
||||
(the VM itself is deprecated).
|
||||
|
||||
## What gets built
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# AyaNova v8 build VM setup
|
||||
|
||||
> **Deprecated (October 2026).** The plan to develop and build entirely in a VM was dropped: it could not cover the QuickBooks (QBI) project and some other parts. Releases are built directly on the workstation, with the backup laptop as the fallback (see `../modernization/PROJECT-OVERVIEW.md`). The tool list and install commands below are still a usable checklist for setting up either machine.
|
||||
|
||||
> **Purpose**: Step-by-step instructions to create a portable Windows virtual machine containing the complete AyaNova v8 build environment. This VM can run on Windows or Linux hosts.
|
||||
|
||||
Written February 2026 for the .NET 8 build; updated October 2026 for the .NET 10 port (AyaNova 8.3.0): the .NET 10 SDK replaces the .NET 8 SDK.
|
||||
|
||||
@@ -146,7 +146,7 @@ suite is waiting on (case 4653, case 4654, the contract issue).
|
||||
- Windows LAN: `lan.iss` prompts for the ASP.NET Core Hosting Bundle. Text and link updated to .NET 10 (2026-10-23); installer test still in section 4
|
||||
- Windows standalone and the launcher are self-contained: no runtime needed on the customer's machine
|
||||
- [ ] Customer manual (`docs/`): system requirements and upgrade instructions for self-hosted customers. Report browser move (section 3): manual already updated in the same commit (`ops-config-report-render-browser-path.md`, `ops-install-linux-server.md`, `ops-upgrade-linux-server.md`, `ops-upgrade-linux-desktop.md`). The pre-8.2.0 upgrade scripts on the two upgrade pages still install `aspnetcore-runtime-8.0`: update with the .NET 10 runtime instructions
|
||||
- [ ] Build VM: install the .NET 10 SDK (`winget install --id Microsoft.DotNet.SDK.10 -e --source winget`; the .NET 8 SDK is no longer needed). `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` updated (2026-10-23); the VM itself still to do
|
||||
- [ ] Build machines: the workstation already has the .NET 10 SDK (10.0.103). The backup laptop needs it before it can build 8.3.0 (`winget install --id Microsoft.DotNet.SDK.10 -e --source winget`; the .NET 8 SDK is no longer needed). `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` updated (2026-10-23). The build VM is deprecated (John, 2026-10-23): n/a
|
||||
- [ ] Final gate runs on the finished code
|
||||
- [ ] Merge, per repo:
|
||||
```powershell
|
||||
|
||||
@@ -48,7 +48,7 @@ Ground Zero's own test droplet first, then customers through the day by time zon
|
||||
|
||||
- **Workstation:** Beelink SER9 Pro+, 32 GB, Windows 11 Pro. Backup: ThinkPad X13 Gen 3
|
||||
- **Editors:** VS Code for everything except QBI, which needs Visual Studio for the Windows Forms designer
|
||||
- **Build VM:** a complete Windows 11 build environment in VirtualBox, exported and backed up to several drives (`devdocs/build/DEV-VM-SETUP.md`)
|
||||
- **Builds:** releases are built on the workstation; the backup laptop is the fallback. A VirtualBox build VM (`devdocs/build/DEV-VM-SETUP.md`) was set up in early 2026 but is deprecated: going fully virtual could not cover QBI and some other parts
|
||||
- **Source control:** Git on a self-hosted Gitea on DigitalOcean. Moved from SVN in early 2026
|
||||
- **Location:** off-grid, Starlink internet, solar power. The workstation is not left running overnight in winter, so do not plan work that depends on overnight runs on it
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ the original plan (February–March 2026). Statuses are as of October 2026; any
|
||||
| Step | What | Status |
|
||||
|---|---|---|
|
||||
| — | SVN → Git, self-hosted Gitea | ✅ Done |
|
||||
| — | Build process documented; Docker builds for front end and docs; Windows build VM exported and backed up | ✅ Done |
|
||||
| — | Build process documented; Docker builds for front end and docs; Windows build VM exported and backed up (VM later deprecated: builds run on the workstation, see `devdocs/build/BUILD.md`) | ✅ Done |
|
||||
| A1 | E2E tests with Cypress 9.7.0, targeting remote devtest servers, with version validation and environment-based config | **[unverified]**: the suite exists in `raven-test\e2e` (last commit 2026-02-22), but the March notes listed it as both done and in progress |
|
||||
| A2 | Fix the outdated integration tests in `raven-test-integration` | ✅ Done, March 2026: compiles on `net8.0`, broken tests removed or rewritten |
|
||||
| A3 | Data-list filter and sort integration tests | ✅ Done, March 2026, together with Tier 1–3 gap coverage. `raven-test-integration\DataList\DataListOperations.cs` holds 15 real tests, not stubs |
|
||||
|
||||
Reference in New Issue
Block a user