Migrate amdgpu-windows-interop to rocm-systems (#808)
This commit is contained in:
+46
-2
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user