Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add docs for the PyTorchJob integration #1048

Merged

Conversation

tenzen-y
Copy link
Member

@tenzen-y tenzen-y commented Aug 9, 2023

What type of PR is this?

/kind documentation

What this PR does / why we need it:

I added docs for the PyTorchJob integration.

Which issue(s) this PR fixes:

Fixes #

Special notes for your reviewer:

Does this PR introduce a user-facing change?

Add a task to use the PyTorchJob integration

@k8s-ci-robot k8s-ci-robot added kind/documentation Categorizes issue or PR as related to documentation. do-not-merge/release-note-label-needed Indicates that a PR should not merge because it's missing one of the release note labels. labels Aug 9, 2023
@k8s-ci-robot k8s-ci-robot requested review from ahg-g and trasc August 9, 2023 07:34
@tenzen-y tenzen-y changed the title Add docs for the PyTorchJob integration WIP: Add docs for the PyTorchJob integration Aug 9, 2023
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. labels Aug 9, 2023
@netlify
Copy link

netlify bot commented Aug 9, 2023

Deploy Preview for kubernetes-sigs-kueue ready!

Name Link
🔨 Latest commit f978bb5
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-sigs-kueue/deploys/64dd247ef9920900080adea6
😎 Deploy Preview https://deploy-preview-1048--kubernetes-sigs-kueue.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@k8s-ci-robot k8s-ci-robot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Aug 9, 2023
@tenzen-y tenzen-y changed the base branch from main to website-release-0.5 August 9, 2023 07:34
@k8s-ci-robot k8s-ci-robot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 9, 2023
@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch 2 times, most recently from 6679ad7 to 38bc9ae Compare August 9, 2023 07:40
@k8s-ci-robot k8s-ci-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Aug 9, 2023
@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch from 38bc9ae to fa963b7 Compare August 9, 2023 07:53
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 9, 2023
Signed-off-by: Yuki Iwai <yuki.iwai.tz@gmail.com>
@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch from fa963b7 to d3b029a Compare August 9, 2023 07:56
@tenzen-y
Copy link
Member Author

tenzen-y commented Aug 9, 2023

Blocked on #995

@k8s-ci-robot k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. and removed do-not-merge/release-note-label-needed Indicates that a PR should not merge because it's missing one of the release note labels. labels Aug 9, 2023
@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch from d3b029a to 80cb611 Compare August 11, 2023 11:24
@alculquicondor
Copy link
Contributor

Is this still WIP?

@tenzen-y
Copy link
Member Author

Is this still WIP?

Yes, I need to add a sample to the examples folder.

@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch from 80cb611 to 194577a Compare August 16, 2023 18:07
@tenzen-y tenzen-y changed the title WIP: Add docs for the PyTorchJob integration Add docs for the PyTorchJob integration Aug 16, 2023
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 16, 2023
@tenzen-y
Copy link
Member Author

@alculquicondor This PR is ready for review.

@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch from 194577a to 0a82b98 Compare August 16, 2023 18:41

This example is based on https://github.com/kubeflow/training-operator/blob/855e0960668b34992ba4e1fd5914a08a3362cfb1/examples/pytorch/simple.yaml.

Note that the minimum requirement training-operator version is v1.7.0.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be said in the "Before you begin" section.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It makes sense.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch 2 times, most recently from eac90cf to d05b74f Compare August 16, 2023 19:06
```{{ .Get 1 }}
{{ (printf "%s%s" .Page.File.Dir $path) | readFile | replaceRE "^---[\\s\\S]+?---" "" | safeHTML }}
{{ (printf "%s" $path) | readFile | replaceRE "^---[\\s\\S]+?---" "" | safeHTML }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{{ (printf "%s" $path) | readFile | replaceRE "^---[\\s\\S]+?---" "" | safeHTML }}
{{ $path | readFile | replaceRE "^---[\\s\\S]+?---" "" | safeHTML }}

?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@@ -1,6 +1,6 @@
{{ $file := .Get 0 }}
[{{$file}}]({{printf "/examples/%s" $file}})
{{ $path := (printf "../../static/examples/%s" $file)}}
{{ $path := (printf "/opt/build/repo/site/static/examples/%s" $file)}}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

uhm... this is worrisome. It will work in the bot, but it won't work if someone is trying to build the site locally.

Can you try "site/static/examples/%" or "static/examples/%"?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It sounds reasonable. Let me try it.

@tenzen-y tenzen-y force-pushed the add-pytorchjob-docs branch 7 times, most recently from 593f652 to 3e5da71 Compare August 16, 2023 19:24
Signed-off-by: Yuki Iwai <yuki.iwai.tz@gmail.com>
@alculquicondor
Copy link
Contributor

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 16, 2023
@tenzen-y
Copy link
Member Author

@alculquicondor Can you add approve to this PR?

@alculquicondor
Copy link
Contributor

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: alculquicondor, tenzen-y

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 16, 2023
@k8s-ci-robot k8s-ci-robot merged commit 7e8d24d into kubernetes-sigs:website-release-0.5 Aug 16, 2023
@tenzen-y tenzen-y deleted the add-pytorchjob-docs branch August 16, 2023 20:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/documentation Categorizes issue or PR as related to documentation. lgtm "Looks good to me", indicates that a PR is ready to be merged. release-note Denotes a PR that will be considered when it comes time to generate release notes. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants