Migrate amdgpu-windows-interop to rocm-systems (#808)

This commit is contained in:
Joseph Macaranas
2025-09-05 10:32:44 -04:00
committed by GitHub
parent 3d9d35a1f8
commit 5ca7af2d30
261 changed files with 86831 additions and 2 deletions
+46 -2
View File
@@ -19,7 +19,7 @@ To limit your local checkout to only the project(s) you work on and improve perf
git clone --no-checkout --filter=blob:none https://github.com/ROCm/rocm-systems.git
cd rocm-systems
git sparse-checkout init --cone
git sparse-checkout set projects/rocblas shared/tensile
git sparse-checkout set projects/rocprofiler-sdk shared/rocprofiler-compute
git checkout develop # or the branch you are starting from
```
@@ -33,7 +33,7 @@ The checkout command of the two projects lasted less than 90 seconds.
If your work involves changing projects or introducing new projects, you can update your sparse-checkout environment:
```bash
git sparse-checkout set projects/hipsparse projects/rocsparse
git sparse-checkout set projects/hip projects/clr projects/hip-tests
```
This keeps your working directory clean and fast, as you won't need to clone the entire super-repo.
@@ -130,6 +130,50 @@ Please refer to [this documentation](/docs/continuous-integration.md) for furthe
---
## Large File Storage
[Data Version Control](https://dvc.org) is the system for large file storage in this super-repo. It provides staging capabilities on top of what Git LFS typically provides that ROCm CI/CD workflows can make use of. Files are stored in an AWS S3 bucket that has public-read access.
Currently, `dvc` utilization is limited to the `pal` libraries in the `shared/amdgpu-windows-interop` directory.
If your development does not involve these files, you do not need to install `dvc`.
### Installing DVC
`dvc` can be installed as a python module via pip and is cross-platform. Visit the [dvc installation page](https://dvc.org/doc/install) if you want to use another method of installation. Due to our use of an AWS S3 bucket with `dvc`, the `dvc[s3]` module should be installed. The configuration to download the large files from the AWS S3 bucket is already set in this repository.
```bash
pip install dvc[s3]
```
### Retrieving large files:
```bash
git pull
dvc pull
```
### Switching to versions in other branches or commits:
```bash
git checkout feature-branch
dvc checkout
```
### Update large files
Write-access requires authentication. Please reach out to a project lead for credentials. To make updates to files maintained by `DVC`:
```bash
dvc add [path-to-large-file-modified]
dvc push
git status
git add [dvc-files-mentioned-from-status-output]
git commit -m "commit message"
git push
```
---
## Gardener Rotation
In order to achieve the goal of keeping the `develop` branch healthy, a team of ROCm engineers will be dedicated towards monitoring and triaging issues that arise.