Skip to content

Add VMR Repository Onboarding Guide#2635

Merged
MichaelSimons merged 13 commits into
dotnet:mainfrom
MichaelSimons:add-repository-onboarding-guide
Sep 29, 2025
Merged

Add VMR Repository Onboarding Guide#2635
MichaelSimons merged 13 commits into
dotnet:mainfrom
MichaelSimons:add-repository-onboarding-guide

Conversation

@MichaelSimons

Copy link
Copy Markdown
Member

This document provides a step-by-step guide for onboarding new repositories into the VMR (Virtual Monolithic Repository). It covers:

  • Prerequisites and repository requirements
  • 6-step onboarding process from source mappings to validation
  • Proper references to existing detailed VMR documentation
  • Guidance on handling license and binary validation
  • Getting help resources

The guide follows a one-sentence-per-line convention and focuses on practical, actionable steps rather than duplicating existing detailed documentation.

This document provides a step-by-step guide for onboarding new repositories
into the VMR (Virtual Monolithic Repository). It covers:

- Prerequisites and repository requirements
- 6-step onboarding process from source mappings to validation
- Proper references to existing detailed VMR documentation
- Guidance on handling license and binary validation
- Getting help resources

The guide follows a one-sentence-per-line convention and focuses on
practical, actionable steps rather than duplicating existing detailed
documentation.
@MichaelSimons MichaelSimons force-pushed the add-repository-onboarding-guide branch from d889db4 to 2fc3f26 Compare September 26, 2025 18:45
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
MichaelSimons and others added 2 commits September 29, 2025 08:30
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md Outdated
@premun

premun commented Sep 29, 2025

Copy link
Copy Markdown
Member

@MichaelSimons if this is a brand new repo (and not arcadified), it would also have to have a build registered in BAR for the subscription to do anything. So I am wondering what kind of repos we're thinking about?

But even if you have that repo, it needs to have a build of the SHA you're thinking of ingesting as the subscriptions are build-oriented.

The other flow (subscription-less) would be this:

  • Add the new source mapping
  • Run darc vmr initialize [mapping name]:[sha or branch] (not sure this works when you're outside of MSFT)

@MichaelSimons

Copy link
Copy Markdown
Member Author

@MichaelSimons if this is a brand new repo (and not arcadified), it would also have to have a build registered in BAR for the subscription to do anything. So I am wondering what kind of repos we're thinking about?

But even if you have that repo, it needs to have a build of the SHA you're thinking of ingesting as the subscriptions are build-oriented.

The other flow (subscription-less) would be this:

  • Add the new source mapping
  • Run darc vmr initialize [mapping name]:[sha or branch] (not sure this works when you're outside of MSFT)

I don't see onboarding of a brand new repo before it is onboarded onto arcade and producing builds as something that this document needs to address. I can add a prereq that the repo must have builds registered in BAR.

To help clarify, I made this change:

This document provides a step-by-step guide for onboarding new repositories into the VMR (Virtual Monolithic Repository).

Comment thread docs/Repository-Onboarding.md Outdated
Comment thread docs/Repository-Onboarding.md
@MichaelSimons MichaelSimons merged commit 9ab7ffb into dotnet:main Sep 29, 2025
6 of 11 checks passed
@MichaelSimons MichaelSimons deleted the add-repository-onboarding-guide branch September 29, 2025 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants