Frappe Operator v2.0.0 Release Guide

Release Summary

Version: v2.0.0
Release Date: November 27, 2024
Release Title: Hybrid App Installation & Enterprise Features

🎯 Release Highlights

Major Features

✅ Hybrid App Installation - FPM, Git, and Image sources
✅ Enterprise Git Control - Disable Git cluster-wide
✅ FPM Repository Management - Private packages with authentication
✅ FrappeBench CRD - Formal bench management
✅ Comprehensive Documentation - Migration guides and examples
✅ Backward Compatibility - No breaking changes

Statistics

Files Created: 16
Files Modified: 9
Code Added: ~4,000 lines
Documentation: ~30 KB
Tests: ✅ Passed

📦 Release Artifacts

Documentation

Code

🏷️ Git Tag Instructions

Step 1: Verify All Changes Are Committed

cd /Users/varkrish/personal/frappe-operator

# Check status
git status

# Review changes
git log --oneline -10

Step 2: Create Annotated Tag

# Create v2.0.0 tag with release notes
git tag -a v2.0.0 -m "Frappe Operator v2.0.0 - Hybrid App Installation & Enterprise Features

Major Features:
- Hybrid app installation (FPM, Git, Image sources)
- Enterprise Git control (disable Git cluster-wide)
- FPM repository management with authentication
- FrappeBench CRD with comprehensive configuration
- Complete documentation and migration guides

Full release notes: https://github.com/vyogotech/frappe-operator/blob/main/RELEASE_NOTES.md

Changelog: https://github.com/vyogotech/frappe-operator/blob/main/CHANGELOG.md"

Step 3: Verify Tag

# List tags
git tag -l

# Show tag details
git show v2.0.0

Step 4: Push Tag to Remote

# Push the tag
git push origin v2.0.0

# Verify on GitHub
# Navigate to: https://github.com/vyogotech/frappe-operator/releases

📝 GitHub Release Instructions

Step 1: Navigate to GitHub Releases

Go to: https://github.com/vyogotech/frappe-operator/releases
Click “Draft a new release”

Step 2: Fill Release Information

Tag version: v2.0.0
Release title: v2.0.0 - Hybrid App Installation & Enterprise Features

Description: (Copy from RELEASE_NOTES.md)

# Frappe Operator v2.0.0

**Release Date:** November 27, 2024

## 🎉 Major Features

### Hybrid App Installation

Install Frappe apps from three different sources:

1. **FPM Packages** - Versioned packages from repositories
2. **Git Repositories** - Traditional bench get-app
3. **Pre-built Images** - Fastest startup

**Example:**

\`\`\`yaml
spec:
  apps:
    - name: frappe
      source: image
    - name: erpnext
      source: fpm
      org: frappe
      version: "15.0.0"
    - name: custom_app
      source: git
      gitUrl: https://github.com/company/custom_app.git
\`\`\`

### Enterprise Git Control

Disable Git access cluster-wide for security compliance.

### FPM Repository Management

Configure multiple FPM repositories with authentication.

## 📦 Installation

\`\`\`bash
kubectl apply -f https://raw.githubusercontent.com/vyogotech/frappe-operator/v2.0.0/install.yaml
\`\`\`

## 📖 Documentation

- [Complete Release Notes](RELEASE_NOTES.md)
- [Migration Guide](FPM_MIGRATION.md)
- [Technical Implementation](HYBRID_FPM_IMPLEMENTATION.md)
- [Changelog](CHANGELOG.md)

## 🎯 What's New

✅ Hybrid app installation (FPM, Git, Image)  
✅ Enterprise Git disable feature  
✅ FPM repository management  
✅ FrappeBench CRD  
✅ Private package support  
✅ Air-gapped deployments  
✅ Complete documentation  

## 🔄 Upgrading

**No breaking changes!** Fully backward compatible.

See [FPM_MIGRATION.md](FPM_MIGRATION.md) for migration guide.

## 🙏 Acknowledgments

Thank you to all contributors and users for making this release possible!

⭐ If you find this useful, please star the project!

Step 3: Attach Files (Optional)

install.yaml
install.sh
Release binaries (if applicable)

Step 4: Publish Release

✅ Check “Set as the latest release”
✅ Click “Publish release”

🚀 Post-Release Tasks

Immediate

Verify release is visible on GitHub
Test installation from release tag
Update project website (if applicable)
Announce on social media/forums

Communication

Post announcement on GitHub Discussions
Post on Frappe Forum (discuss.frappe.io)
Update documentation site
Send newsletter (if applicable)

Monitoring

Monitor GitHub issues for release-related bugs
Track download/usage statistics
Gather user feedback

📊 Release Checklist

Pre-Release

Release

Git tag created
Tag pushed to GitHub
GitHub Release published
Release notes published

Post-Release

Installation verified
Announcements made
Issues monitored
Feedback collected

🎯 Version Information

Current Version: v2.0.0
Previous Version: v1.0.0
Next Planned: v2.1.0

Backward Compatibility: ✅ Yes
Breaking Changes: ❌ No
Migration Required: ❌ Optional

📞 Support

Get Help

Documentation: https://vyogotech.github.io/frappe-operator/
GitHub Issues: https://github.com/vyogotech/frappe-operator/issues
Discussions: https://github.com/vyogotech/frappe-operator/discussions

Report Issues

Bug Reports: https://github.com/vyogotech/frappe-operator/issues/new?template=bug_report.md
Feature Requests: https://github.com/vyogotech/frappe-operator/issues/new?template=feature_request.md

🎉 Success Criteria

Release is successful when:

✅ Git tag created and pushed
✅ GitHub Release published
✅ Installation instructions work
✅ Documentation is accurate
✅ No critical bugs reported
✅ Community feedback is positive

🎉 Ready to Release!

All documentation is complete, code is tested, and the operator is ready for v2.0.0!