Skip to content

Commit 63c9229

Browse files
authored
Add Build Automation Docs (#5157)
1 parent 6d672fd commit 63c9229

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

docs/BUILD.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -322,3 +322,20 @@ cd vcpkg
322322
./vcpkg install ms-quic
323323
```
324324
The `MsQuic` port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
325+
326+
# Build Automation
327+
328+
MsQuic has several types and locations for build automation.
329+
330+
## GitHub
331+
332+
The most comprehensive build automation is on GitHub and run via GitHub Action workflows (see [here](https://github.com/microsoft/msquic/actions/workflows/build.yml)) on every PR and push to main. As of June 2025, over 200 different build configurations are run. These are meant to completely cover pretty much all build scenarios that are important to the project.
333+
334+
These builds don't produce any official, signed artifacts. They are merely used for validation and then test (execution) purposes.
335+
336+
## Internal
337+
338+
Microsoft then has official build pipelines that run internally (private) in secure build containers to produce the official binaries. These are then signed and eventually officially released. The main pipeline may be found [here](https://microsoft.visualstudio.com/undock/_build?definitionId=134439) (MSFT-only access required). This pipeline automatically picks up all main branch, release branch and tags from the public repo and mirrors them internally.
339+
340+
There is an older pipeline [here](https://mscodehub.visualstudio.com/msquic/_build?definitionId=1738), which has _mostly_ been superceded by the pipeline above. Issue [#4766](https://github.com/microsoft/msquic/issues/4766) tracks the work to completely move things over. For instance, Linux package publishing still only functions in this older pipeline.
341+

0 commit comments

Comments
 (0)