-
Notifications
You must be signed in to change notification settings - Fork 116
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
10 changed files
with
298 additions
and
69 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
docker: | ||
build: true | ||
docker_os: ubuntu | ||
docker_os_version: "22.04" | ||
|
||
run_with_default_inputs: true #if false the script won't run automatic tests | ||
variation_combinations: | ||
- _bert,_nvidia-original: | ||
minimum_system_requirements: | ||
ram: 4 #in GB | ||
disk_space: 6 #in GB |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,154 @@ | ||
<details> | ||
<summary>Click here to see the table of contents.</summary> | ||
|
||
* [Description](#description) | ||
* [Information](#information) | ||
* [Usage](#usage) | ||
* [ CM installation](#cm-installation) | ||
* [ CM script automation help](#cm-script-automation-help) | ||
* [ CM CLI](#cm-cli) | ||
* [ CM Python API](#cm-python-api) | ||
* [ CM GUI](#cm-gui) | ||
* [ CM modular Docker container](#cm-modular-docker-container) | ||
* [Customization](#customization) | ||
* [ Script flags mapped to environment](#script-flags-mapped-to-environment) | ||
* [ Default environment](#default-environment) | ||
* [Script workflow, dependencies and native scripts](#script-workflow-dependencies-and-native-scripts) | ||
* [Script output](#script-output) | ||
* [New environment keys (filter)](#new-environment-keys-(filter)) | ||
* [New environment keys auto-detected from customize](#new-environment-keys-auto-detected-from-customize) | ||
* [Maintainers](#maintainers) | ||
|
||
</details> | ||
|
||
*Note that this README is automatically generated - don't edit! Use `README-extra.md` to add more info.* | ||
|
||
### Description | ||
|
||
#### Information | ||
|
||
* Category: *Modular MLPerf benchmarks.* | ||
* CM GitHub repository: *[mlcommons@ck](https://github.com/mlcommons/ck/tree/master/cm-mlops)* | ||
* GitHub directory for this script: *[GitHub](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo)* | ||
* CM meta description for this script: *[_cm.json](_cm.json)* | ||
* CM "database" tags to find this script: *pull,git,repo,repository* | ||
* Output cached?: *False* | ||
___ | ||
### Usage | ||
|
||
#### CM installation | ||
|
||
[Guide](https://github.com/mlcommons/ck/blob/master/docs/installation.md) | ||
|
||
##### CM pull repository | ||
|
||
```cm pull repo mlcommons@ck``` | ||
|
||
##### CM script automation help | ||
|
||
```cm run script --help``` | ||
|
||
#### CM CLI | ||
|
||
1. `cm run script --tags=pull,git,repo,repository [--input_flags]` | ||
|
||
2. `cm run script "pull git repo repository" [--input_flags]` | ||
|
||
3. `cm run script c23132ed65c4421d [--input_flags]` | ||
|
||
* `variations` can be seen [here](#variations) | ||
|
||
* `input_flags` can be seen [here](#script-flags-mapped-to-environment) | ||
|
||
#### CM Python API | ||
|
||
<details> | ||
<summary>Click here to expand this section.</summary> | ||
|
||
```python | ||
|
||
import cmind | ||
|
||
r = cmind.access({'action':'run' | ||
'automation':'script', | ||
'tags':'pull,git,repo,repository' | ||
'out':'con', | ||
... | ||
(other input keys for this script) | ||
... | ||
}) | ||
|
||
if r['return']>0: | ||
print (r['error']) | ||
|
||
``` | ||
|
||
</details> | ||
|
||
|
||
#### CM GUI | ||
|
||
```cm run script --tags=gui --script="pull,git,repo,repository"``` | ||
|
||
Use this [online GUI](https://cKnowledge.org/cm-gui/?tags=pull,git,repo,repository) to generate CM CMD. | ||
|
||
#### CM modular Docker container | ||
|
||
*TBD* | ||
|
||
___ | ||
### Customization | ||
|
||
|
||
#### Script flags mapped to environment | ||
<details> | ||
<summary>Click here to expand this section.</summary> | ||
|
||
* `--path=value` → `CM_GIT_CHECKOUT_PATH=value` | ||
|
||
**Above CLI flags can be used in the Python CM API as follows:** | ||
|
||
```python | ||
r=cm.access({... , "path":...} | ||
``` | ||
|
||
</details> | ||
|
||
#### Default environment | ||
|
||
<details> | ||
<summary>Click here to expand this section.</summary> | ||
|
||
These keys can be updated via `--env.KEY=VALUE` or `env` dictionary in `@input.json` or using script flags. | ||
|
||
|
||
</details> | ||
|
||
___ | ||
### Script workflow, dependencies and native scripts | ||
|
||
<details> | ||
<summary>Click here to expand this section.</summary> | ||
|
||
1. ***Read "deps" on other CM scripts from [meta](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/_cm.json)*** | ||
* detect,os | ||
- CM script: [detect-os](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/detect-os) | ||
1. ***Run "preprocess" function from [customize.py](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/customize.py)*** | ||
1. Read "prehook_deps" on other CM scripts from [meta](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/_cm.json) | ||
1. ***Run native script if exists*** | ||
* [run.sh](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/run.sh) | ||
1. Read "posthook_deps" on other CM scripts from [meta](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/_cm.json) | ||
1. ***Run "postrocess" function from [customize.py](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/customize.py)*** | ||
1. Read "post_deps" on other CM scripts from [meta](https://github.com/mlcommons/ck/tree/master/cm-mlops/script/pull-git-repo/_cm.json) | ||
</details> | ||
|
||
___ | ||
### Script output | ||
#### New environment keys (filter) | ||
|
||
#### New environment keys auto-detected from customize | ||
|
||
___ | ||
### Maintainers | ||
|
||
* [Open MLCommons taskforce on automation and reproducibility](https://github.com/mlcommons/ck/blob/master/docs/taskforce.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
{ | ||
"alias": "pull-git-repo", | ||
"automation_alias": "script", | ||
"automation_uid": "5b4e0237da074764", | ||
"category": "Modular MLPerf benchmarks", | ||
"default_env": { | ||
}, | ||
"deps": [ | ||
{ | ||
"tags": "detect,os" | ||
} | ||
], | ||
"input_mapping": { | ||
"path": "CM_GIT_CHECKOUT_PATH" | ||
}, | ||
"new_env_keys": [ | ||
], | ||
"tags": [ | ||
"pull", | ||
"git", | ||
"repo", | ||
"repository" | ||
], | ||
"uid": "c23132ed65c4421d", | ||
"variations": { | ||
} | ||
} |
Oops, something went wrong.