Release v0.1.0-beta.1: End-to-End Process Validation

[josecelano]

Overview

Execute the first real end-to-end release of the Torrust Tracker Deployer following the release process defined in issue #448. Version 0.1.0-beta.1 is the first pre-release version and serves as the practical validation of the entire release workflow — from version bump to artifact verification.

This task is intentionally broader than a normal release. It treats the release itself as an audit surface: every step where the documentation is inaccurate, incomplete, or misleading must be captured and fixed before closing the issue.

Specification

See detailed specification: docs/issues/450-release-v0-1-0-beta-end-to-end-validation.md

Implementation Plan

Phase 1: Pre-Flight and Setup

• Task 1.1: Verify local workspace is clean and on torrust/main
• Task 1.2: Verify GitHub environments dockerhub-torrust and crates-io are configured
• Task 1.3: Confirm releaser has required push permissions
• Task 1.4: Document any pre-flight issues found

Phase 2: Execute the Release

• Task 2.1: Update version to 0.1.0-beta.1 in both Cargo.toml files
• Task 2.2: Run cargo build && cargo test and verify they pass
• Task 2.3: Create and push the signed release commit to main
• Task 2.4: Create and push annotated signed tag v0.1.0-beta.1
• Task 2.5: Create and push release branch releases/v0.1.0-beta.1
• Task 2.6: Monitor Container and Publish Crate workflows to completion

Phase 3: Artifact Verification

• Task 3.1: Pull and inspect Docker image torrust/tracker-deployer:0.1.0-beta.1
• Task 3.2: Verify crate torrust-tracker-deployer-sdk@0.1.0-beta.1 is on crates.io
• Task 3.3: Verify docs.rs build for the published crate version
• Task 3.4: Create GitHub release from tag v0.1.0-beta.1

Phase 4: Process Review and Cleanup

• Task 4.1: Collect all issues and friction points encountered during execution
• Task 4.2: Fix small documentation inconsistencies in docs/release-process.md
• Task 4.3: Fix small skill inaccuracies in release-new-version/skill.md
• Task 4.4: File follow-up issues for any non-trivial problems found
• Task 4.5: Update release finalization gates to confirm all pass

Acceptance Criteria

Quality Checks:

• Pre-commit checks pass: ./scripts/pre-commit.sh

Release Execution:

• Version 0.1.0-beta.1 is committed and present in both Cargo.toml files on main
• Tag v0.1.0-beta.1 exists and is signed
• Branch releases/v0.1.0-beta.1 exists
• Container workflow completed successfully
• Publish Crate workflow completed successfully
• GitHub release v0.1.0-beta.1 is published (not draft)

Artifact Verification:

• Docker image torrust/tracker-deployer:0.1.0-beta.1 can be pulled and run
• Crate torrust-tracker-deployer-sdk@0.1.0-beta.1 is visible on crates.io
• docs.rs build page loads for the published version

Process Quality:

• All issues found during the release are documented (inline or filed as follow-ups)
• docs/release-process.md reflects any corrections made
• No step was silently skipped or improvised without documentation