Try   HackMD

1.0.0 Release Planning

Permalink: https://hackmd.io/@porter/v1-release-planning

Agenda

  • Timeline and remaining issues
  • Possible errors users WILL see, we need docs ready to support these
    • Data migration required
    • Version mismatch of plugins/mixins
    • Schema version mismatch of resources (e.g. installation, parameter set)
  • Alpha
    • 1.0.0-alpha.20 was last alpha release
    • No more planned schema changes
    • Do we need an alpha release for the latest bundle dependency change in the bundle format?
      • No we can release it in beta.1 and just not make further changes going forward.
      • If we end up needing dependency changes later, we need to queue that up for v2.
  • Beta
    • Starting with beta.1 porter supports migrating existing data from v0.38
    • If we make any schema changes from now on, we have to suport migrating existing users
    • Someone should be able to use their current data with beta onwards though our final release
    • Data Migration
      • New PORTER_HOME
      • We don't touch old data so that you can go back if needed
      • porter storage migrate --old-home ~/.porterv0
    • Identify who are our beta testers
  • Release Candidate
    • Starting with rc.1 we should have made ALL planned changes
    • We stay in rc until people stop reporting must fix bugs
    • Must fix = security, or blockers
    • Identify RC testers and who can help us decide that we've vetted the RC "enough"
    • What is the minumum amount of time an RC should be out before we can promote it to 1.0.0?
  • Release Process - What needs to happen to cut a v1.0.0 release
    • Once we have a viable RC, we will retag that same commit as 1.0.0
    • Branches (main, release/v1, release/v0.38.*), timing of when we move release/v1 to main
    • Website (domain, versioning)
    • Plugin and mixin releases should be coordinated.
      • All plugins are now at 1.0.0-beta, and will go to 1.0.0 when we release
      • The exec mixin will automatically go 1.0.0 with Porter
      • Are there other mixins that should go 1.0.0?
      • Update plugin and mixin pages with compatibility ranges
  • Announcement
    • blog posts
      • Announce release and explain migration
      • Revisit major features and changes?
      • Mega rollup or separate?
    • social media
      • We will do a series of tweets about the key points in the blog posts
      • Ask CNCF to retweet the 1.0.0 announcement
    • homepage refresh
      • List adopters with logos on homepage
      • Make sure our features listed still make sense
      • Improve/hone the explanation of what Porter is
      • Highlight CNCF sandbox? (double check sandbox promotion rules)
    • Gifs and Videos
    • CNCF webinar
    • Where are we with F5 on their own promotion around their usage?
  • SLA and support expectations
    • How long do we support v0.38? What constitutes "support"?
    • No internal teams are using v1.0 yet.
    • EY is going to start evaluating v1.0 after we hit beta.1 and support migrations
    • F5 is dogfooding v1.0