Runway Maintainership

Runway is an internal platform as a service (PaaS) actively seeking maintainers for engineering projects.

Name	Location
Reconciler	gitlab-com/gl-infra/platform/runway/runwayctl
Provisioner	gitlab-com/gl-infra/platform/runway/provisioner

To maintain Runway, the following technologies are primarily used:

• Go for programming language.
• Terraform for infrastructure as code.
• GitLab CI/CD for deployment component templates.
• JSON Schema for service manifest validation and documentation.
• GCP for cloud infrastructure.

Additionally, the following technologies comprise of entire platform:

• Kubernetes for container orchestration.
• Helm Charts for observability package management.
• Jsonnet for service/metrics catalog.
• Grafana for dashboards.
• Prometheus for metrics.

If you are familiar with the domain expertise above, or are interested in learning by doing, please consider becoming a maintainer.

As of July 2024, Runway is considered a smaller project with less than 10 internal contributors. As a result, Runway currently uses an accelerated onboarding process.

1. Read documentation (eg architecture, guides, strategy)
2. Author minimum of 3 MRs (eg feat:, fix:)
3. Review minimum of 3 MRs
4. Onboard minimum of 1 service project
5. Perform minimum of 1 service project version upgrade

To become a trainee maintainer:

1. Open maintainer onboarding issue using template
2. Update team member profile projects (eg runway-reconciler: trainee_maintainer)

To become a maintainer:

1. Complete maintainer onboarding issue
2. Update team member profile projects (eg runway-reconciler: maintainer)
3. Request MR approval from Runway EM, PM, and at least 1 existing maintainer
4. That’s it! 🎉 You’re officially a Runway maintainer