Distribution ownership areas

The following is a breakdown of the areas of Sourcegraph that the Distribution team owns, as well as relevant documentation and resources. Distribution team members may also be involved in other areas of Sourcegraph not mentioned here (i.e., you’re not restricted just to the distribution team or working on just the areas of ownership assigned below).

To see what Distribution is currently prioritizing, see the Distribution Goals.

Infrastucture

  • Infrastructure for Sourcegraph.com and other Sourcegraph instances operated by Sourcegraph
  • 3rd-party services (ghe.sgdev.org)
  • Buildkite, CI pipeline / infrastructure.

Related

Release pipeline

  • End-to-end release process infrastructure
  • Creating monthly releases
  • Testing environments when applicable
  • Releasing security updates when asked to

Related

Deployment

Kubernetes cluster installation & upgrade experience

  • Kubernetes YAML & associated tooling
  • Cloud-specific setup docs (AWS/Google Cloud)
  • Deployment setup & upgrade docs

Related

Docker Compose & pure-docker installation & upgrade experience

  • Docker-compose YAML & associated tooling
  • Pure-docker shell scripts & upgrade docs
  • Cloud-specific setup docs (AWS/Google Cloud)
  • Deployment setup & upgrade docs

Related

Single-container installation & upgrade experience

  • Primarily in maintenance mode
  • Pushing admins to upgrade to Docker Compose
  • Communicating the limitations of single-container deployments

Related

Scalability

  • Documenting when to upgrade from one deploy type to another
  • Resource estimation for new deployments
  • Scaling advice for existing deployments

Related

Observability

Related

Monitoring

  • Metrics & alerting infrastructure
  • Educating site admins about how to monitor Sourcegraph
  • Supporting engineers at Sourcegraph to help them add monitoring to Sourcegraph services
  • Ensuring our monitoring tooling:
    • is compelling for engineers at Sourcegraph to interact with and build on top of.
    • supports use cases specific to the needs of engineers at Sourcegraph and Sourcegraph Cloud.

Related

Also see observability.

Debugging

  • Logging & Tracing infrastructure
  • Working with & ensuring engineering @ Sourcegraph adds needed logging/tracing to debug issues
  • Making the debugging process for common problems seamless and straightforward
  • Making reporting issues with all needed information easy
  • Ensuring logs/tracing are not overly verbose, identify most useful information for solving problems

Related

Also see observability.