Warning
The product is in closed beta and not open to the public.
VisionByte TeamCity VCS Plugin 0.1.0.0 Release Notes¶
Summary¶
Version 0.1.0.0 provides source checkout, change history, revision tracking, and automatic builds for VisionByte repositories in TeamCity.
Use server-side or agent-side checkout, build selected branches, and control which directories are included in a build. See the User Guide for installation and configuration.
New Features¶
Repository access: Connect over HTTP or HTTPS with anonymous access or username/password credentials. Test the connection from the VCS root form.
Server and agent checkout: Check out source files on the server or directly on an agent. Support initial checkout and later updates.
Revision tracking: Build the exact version selected by TeamCity, even if the branch changes while a build is queued. Report the full revision UUID.
Multiple branches: Select branches using TeamCity branch specifications and configure VCS triggers to start builds when source changes.
Checkout rules: Include, exclude, and map directories. Attach multiple roots with separate destination folders.
Change history: Review commit authors, descriptions, and affected files, and view file content before and after a change.
Repository browsing: Choose repository files and directories from the default branch in TeamCity’s repository pickers.
Workspace cleanup: Restore tracked files during agent updates and use TeamCity clean checkout to rebuild a workspace.
Cache maintenance: Refresh the server’s VisionByte cache through TeamCity diagnostics.
Simple deployment: Install the plugin without a separate VisionByte command-line client on build nodes.
Requirements and Scope¶
TeamCity 2026.2.1 and a 64-bit Java 21 runtime on the server and agents.
Windows x64, Linux x86_64 with glibc or musl, or macOS Apple Silicon (arm64). Use an ARM64 Java runtime on Apple Silicon.
The server must be able to access the repository. Agent checkout requires direct repository access from the agent as well.
Repository access is read-only. The plugin does not create remote commits, merges, tags, or branches.
Limitations¶
Server checkout and directory-selection agent checkout do not create symbolic links. Exclude those paths or use whole-repository agent checkout on a suitable platform.
Agent checkout rules do not support wildcards or single-file remapping. Different roots must use non-overlapping destination folders.
Directory selection supports up to 500,000 files. TeamCity file-content views are limited to 64 MiB per file.
SSH/private-key authentication, OAuth/token refresh, and personal builds are not supported in this release.
Clean checkout removes untracked files and build outputs in its managed directory. Review Workspace Cleanup before requesting it.