mrx-link convert

Link 파이프라인이 포함된 파일을 다른 형식으로 변환합니다.

📘

• 현재 ipynb를 yaml로 변환하거나, yaml을 ipynb으로 변환하는 기능만 지원됩니다.
• ipynb을 yaml로 변환하고자 할 경우, 해당 파이프라인의 모든 컴포넌트가 성공적으로 실행된 다음에 해당 기능을 이용할 수 있습니다.
• Python code에서의 Link 파이프라인을 ipynb 파일로 내보내는 법은 convert_to_ipynb 문서를, Kubeflow yaml 파일로 내보내는 방법은 convert_to_kfp 문서를 참고하십시오.

mrx-link convert --from-path FILE1.format --to-path FILE2.format

• Options

  • --from-path FILE1.format: 변환하고자 하는 파일 명을 입력합니다.

  • --to-path FILE2.format: 변환하여 저장하고자 파일 명을 입력합니다.

  • -h, --help: 헬프 메시지를 출력합니다.

    Usage: mrx-link convert [OPTIONS]
    
      Convert a file with the Link pipeline to other formats.
    
      `ipynb` to `yaml` and `yaml` to `ipynb` conversions are supported.
    
    Options:
      --from-path TEXT  File name to be converted.  [required]
      --to-path TEXT    File name to be saved after conversion.  [required]
      -h, --help        Show this message and exit.
    

• Troubleshooting

  • [Errno 2] No such file or directory: 'FILE.format'
    • 변환하고자 하는 파일이 존재하지 않을 때 발생합니다.
  • The file should be ipynb or yaml file with a Link pipeline
    • 변환하고자 하는 파일 형식이 ipynb이지만 Link에서 생성된 파일이 아닐 때 발생합니다.
  • The file should be ipynb or yaml file with a Link pipeline
    • 변환하고자 하는 파일 형식이 yaml이지만 Link에서 생성된 파일이 아닐 때 발생합니다.
  • It must not include [:, *, ", ?, <, >, |]
    • FILE에 : * " ? < > | 중 하나가 추가되어 있을 때 발생합니다.
  • Only ipynb and yaml are supported for target file.
    • FILE 형식이 ipynb이나 yaml이 아닐 경우 발생합니다.
  • Failed to execute the pipeline for converting to yaml. Please try again
    • yaml로 변환하는 과정에서 필요한 파이프라인 실행 과정에 문제가 발생한 경우 발생합니다.
  • Only ipynb to yaml and yaml to ipynb conversions are supported
    • ipynb에서 yaml로의 변환 또는 yaml에서 ipynb으로의 변환이 아닐 경우 발생합니다.
  • zsh: no matches found: FILE.format
    • 노트북 파일 이름에 Bash 특수 문자 또는 공백이 포함된 경우 발생합니다.
      • Bash 특수 문자 또는 공백 앞에 \가 포함되면 정상적으로 실행됩니다.
        • ex) mrx-link convert --from cli-test\(name\).yaml --to cli-test\(name\).ipynb
      • “ 또는 ‘ 따옴표로 문자열을 감싸면 정상적으로 실행됩니다.
        • ex) mrx-link convert --from "cli-test(name).yaml" --to 'cli-test(name).ipynb'

Example

1. Sample Source를 다운로드 받습니다.
   • iris_classification.ipynb
2. 필요한 패키지를 설치하고 해당 파일을 실행합니다. (yaml로 변환하는 경우에 해당)
   CLI

   pip install sklearn torch "pytorch_lightning>=1.6, <1.9" "torchmetrics>=0.7.0, <0.11.1" livelossplot &&
   mrx-link run --file 'iris_classification.ipynb'
   

3. ipynb 파일을 yaml로 변환하여 저장합니다.
   CLI

   mrx-link convert --from-path iris_classification.ipynb --to-path sample.yaml