Skip to content

Latest commit

 

History

History
61 lines (47 loc) · 5.07 KB

release-team-onboarding.md

File metadata and controls

61 lines (47 loc) · 5.07 KB
Raw

Onboarding Notes for Release Team

Overview

Welcome to the Cluster API Release Team onboarding documentation!

As a member of the Release Team, you play a crucial role in helping to ensure project releases are delivered smoothly and in a timely manner. While there are specific responsibilities for each sub-team within the Release Team, below are some general notes that every member of the Release Team might benefit by going through at the beginning of the cycle:

  • Slack:
    • Most discussions related CAPI Release topics happens in the #cluster-api channel on the Kubernetes Slack. If you need access to the Kubernetes Slack, please visit http://slack.k8s.io/.
  • Kubernetes SIG membership:
    • Try to become an official member of the Kubernetes SIG, if possible. More information on the membership and requirements can be found here.
  • Familiarize yourself with the Release Process:
    • Review the release team roles which explains the responsibilities and tasks for each role within the release team.
  • Check the Release Timeline:
    • Go through the release timeline of the release cycle you are involved in (i.e checkout release-1.6.md if you are part of the 1.6 cycle release team) to better understand the key milestones and deadlines.

Now, let's dive into the specific onboarding notes for each sub-team below.

Release Lead Team

  • Explore CI Setup and Tools:
    • Gain some insights into how CI is setup in the Cluster API and tools used. You can check out CI Team onboarding notes for more details.
  • Learn about Release Notes Generation:
    • Get to know how the release notes generation tools works.
  • Review the onboarding notes for both the Comms and CI Lead teams:

Comms Team

  • Understand Release Process:
    • Get to know how project's release process works.
    • Walk through the release note generation process and try to generate notes by yourself. This is the most important process the comms team is in charge of.
    • Familiarize yourself with the release notes tool code. You'll probably need to update this code during the release cycle to cover new cases or add new features.
  • Documentation familiarity:
    • Explore project's documentation and start learning how to update and maintain it.
  • Communication channels:
    • Learn about project's primary communication channels, including Slack, mailing list and office hours. Try to understand how information is distributed and how to use them effectively for announcements, updates and discussions related to the release cycle.

CI Signal Team

  • Start by gaining a general understanding of GitHub labels and how to find issues and pull requests for the current milestone.
  • Familiarize yourself with Prow commands: The Cluster API project utilizes Prow to manage CI automation. Issues and PRs are categorized by applying specific list of area labels, which helps in prioritization of that specific issue/PR during the release cycle or release process. Learn more about the available labels and prow commands.
  • Take a look at TestGrid, an interactive dashboard for visualizing the CI job results of the project in a grid format!
  • Examine the CI jobs in the test-infra repository. These jobs are defined in YAML and represent various job types, such as periodics and presubmits, that we run in the project. You can also find dedicated notes for them in the book.
  • Explore k8s-triage, a tool that identifies groups of similar test failures across all jobs.
  • Experiment with running end-to-end tests on your local machine to gain a better understanding of the tests and build a confidence debugging CI issues.