derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
121 lines
11 KiB
Markdown
121 lines
11 KiB
Markdown
# ROCm Systems
|
|
|
|
Welcome to the ROCm Systems super-repo. This repository consolidates multiple ROCm systems projects into a single repository to streamline development, CI, and integration. The first set of projects focuses on requirements for building PyTorch.
|
|
|
|
# Super-repo Status and CI Health
|
|
|
|
This table provides the current status of the migration of specific ROCm systems projects as well as a pointer to their current CI health.
|
|
|
|
**Key:**
|
|
- **Completed**: Fully migrated and integrated. This super-repo should be considered the source of truth for this project. The old repo may still be used for release activities.
|
|
- **In Progress**: Ongoing migration, tests, or integration. Please refrain from submitting new pull requests on the individual repo of the project, and develop on the super-repo.
|
|
- **Pending**: Not yet started or in the early planning stages. The individual repo should be considered the source of truth for this project.
|
|
|
|
| Component | Source of Truth | Migration Status | Component CI Status |
|
|
|------------------------|-----------------|------------------|---------------------------------------|
|
|
| `amdsmi` | Public | Completed | |
|
|
| `aqlprofile` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/aqlprofile-codeql.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/aqlprofile-continuous_integration.yml) |
|
|
| `clr` | Public | Completed | |
|
|
| `hip` | Public | Completed | |
|
|
| `hipfile` | Public | Completed | |
|
|
| `hipother` | Public | Completed | |
|
|
| `hip-tests` | Public | Completed | |
|
|
| `rdc` | Public | Completed | |
|
|
| `rocdbgapi` | Public | Completed | None |
|
|
| `rocdecode` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/media-libs-ci.yml) |
|
|
| `rocjpeg` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/media-libs-ci.yml) |
|
|
| `rocm-core` | Public | Completed | |
|
|
| `rocminfo` | Public | Completed | |
|
|
| `rocm-smi-lib` | Public | Completed | |
|
|
| `rocprofiler` | Public | Completed | |
|
|
| `rocprofiler-compute` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-compute-formatting.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-compute-rhel-8.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-compute-tarball.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-compute-ubuntu-jammy.yml) |
|
|
| `rocprofiler-register` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-register-continuous-integration.yml) |
|
|
| `rocprofiler-sdk` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-code_coverage.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-codeql.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-continuous_integration.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-docs.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-formatting.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-python.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-restrictions.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-sdk-rocm_release_compatibility.yml) |
|
|
| `rocprofiler-systems` | Public | Completed | [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-containers.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-ghcr.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-formatting.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-python.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-redhat.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-ubuntu-jammy.yml) <br> [](https://github.com/ROCm/rocm-systems/actions/workflows/rocprofiler-systems-ubuntu-noble.yml) |
|
|
| `rocr-debug-agent` | Public | Completed | None |
|
|
| `rocr-runtime` | Public | Completed | |
|
|
| `rocshmem` | Public | Completed | |
|
|
| `roctracer` | Public | Completed | |
|
|
|
|
|
|
## Tentative migration schedule
|
|
|
|
| Component | Tentative Date |
|
|
|------------------------|----------------|
|
|
|
|
|
|
*Remaining schedule to be determined.
|
|
|
|
# TheRock CI Status
|
|
|
|
Note TheRock CI performs multi-component testing on top of builds leveraging [TheRock](https://github.com/ROCm/TheRock) build system.
|
|
|
|
[](https://github.com/ROCm/rocm-systems/actions/workflows/therock-ci.yml?query=branch%3Adevelop+event%3Apush)
|
|
|
|
---
|
|
|
|
## Nomenclature
|
|
|
|
Project names have been standardized to match the casing and punctuation of released packages. This removes inconsistent camel-casing and underscores used in legacy repositories.
|
|
|
|
## Structure
|
|
|
|
The repository is organized as follows:
|
|
|
|
```
|
|
projects/
|
|
amdsmi/
|
|
aqlprofile/
|
|
clr/
|
|
hip/
|
|
hipfile/
|
|
hipother/
|
|
hip-tests/
|
|
rccl/
|
|
rdc/
|
|
rocdbgapi/
|
|
rocdecode/
|
|
rocjpeg/
|
|
rocm-core
|
|
rocminfo/
|
|
rocmsmilib/
|
|
rocprofiler/
|
|
rocprofiler-compute/
|
|
rocprofiler-register/
|
|
rocprofiler-sdk/
|
|
rocprofiler-systems/
|
|
rocr-debug-agent/
|
|
rocrruntime/
|
|
rocshmem/
|
|
roctracer/
|
|
```
|
|
|
|
- Each folder under `projects/` corresponds to a ROCm systems project that was previously maintained in a standalone GitHub repository and released as distinct packages.
|
|
- Each folder under `shared/` contains code that existed in its own repository and is used as a dependency by multiple projects, but does not produce its own distinct packages in previous ROCm releases.
|
|
|
|
## Goals
|
|
|
|
- Enable unified build and test workflows across ROCm libraries.
|
|
- Facilitate shared tooling, CI, and contributor experience.
|
|
- Improve integration, visibility, and collaboration across ROCm library teams.
|
|
|
|
## Getting Started
|
|
|
|
To begin contributing or building, see the [CONTRIBUTING.md](./CONTRIBUTING.md) guide. It includes setup instructions, sparse-checkout configuration, development workflow, and pull request guidelines.
|
|
|
|
## License
|
|
|
|
This super-repo contains multiple subprojects, each of which retains the license under which it was originally published.
|
|
|
|
📁 Refer to the `LICENSE`, `LICENSE.md`, or `LICENSE.txt` file within each `projects/` or `shared/` directory for specific license terms.
|
|
📄 Refer to the header notice in individual files outside `projects/` or `shared/` folders for their specific license terms.
|
|
|
|
> **Note**: The root of this repository does not define a unified license across all components.
|
|
|
|
## Questions or Feedback?
|
|
|
|
- 💬 [Start a discussion](https://github.com/ROCm/rocm-systems/discussions)
|
|
- 🐞 [Open an issue](https://github.com/ROCm/rocm-systems/issues)
|
|
|
|
We're happy to help!
|