docs: add ARM64/AArch64 validation and troubleshooting guide#3397
docs: add ARM64/AArch64 validation and troubleshooting guide#3397iknowmaaz-mz wants to merge 17 commits intokubeflow:masterfrom
Conversation
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
Welcome to the Kubeflow Manifests Repository Thanks for opening your first PR. Your contribution means a lot to the Kubeflow community. Before making more PRs: Community Resources:
Thanks again for helping to improve Kubeflow. |
There was a problem hiding this comment.
Pull request overview
Adds an ARM64/AArch64 validation + troubleshooting document and exposes it from the repository README to help users collect consistent debugging info for ARM-related failures (image pulls, wrong-arch binaries, crash loops).
Changes:
- Added
docs/arm64.mdwith ARM64/AArch64 prerequisites, common failure modes, and copy/paste debugging commands. - Added a short Documentation section to
README.mdlinking to the new ARM64 guide.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/arm64.md | New ARM64/AArch64 install validation & troubleshooting guide, including debugging commands and a reporting template. |
| README.md | Adds a Documentation section pointing readers to the new ARM64 guide. |
You can also share your feedback on Copilot code review. Take the survey.
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
|
Hi @christian-heusel , thanks again for the earlier guidance. I’ve addressed the feedback in the thread and the PR should be ready now. |
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
| exit 1 | ||
| fi | ||
|
|
||
| echo "SUCCESS: All checked multi-arch images advertise linux/arm64 (excluding allowlist)." |
There was a problem hiding this comment.
| echo "SUCCESS: All checked multi-arch images advertise linux/arm64 (excluding allowlist)." |
There was a problem hiding this comment.
I noticed the suggestion is the same as the current code:
echo "SUCCESS: All checked multi-arch images advertise linux/arm64 (excluding allowlist)."
Could you clarify if you’d like the success message revised further or if this is fine as is? I can simplify it to something more concise if needed.
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
43335b6 to
9379756
Compare
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com> - Removed unnecessary debug outputs. - Adjusted to only report unsupported images. - Updated triggers and preserved allowlist handling. - Focused solely on test results and summary output. Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
- Added retry logic for Kustomize download to handle network failures. - Added fallback to Kustomize v5.8.0 if v5.8.1 fails to download. - Verified checksums before installation. - Improved error handling for readability. Signed-off-by: Your Name <your.email@example.com> Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
…nore Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
Signed-off-by: iknowmaaz-mz <iknowmaaz@gmail.com>
|
And this might not be needed anymore after the KFP arm Backport for the 2.16 release. Please also read the copilot instructions.md /hold |
|
Thanks for pointing this out! I’ll review the KFP ARM backport for 2.16 and check the copilot_instructions.md to see if this is still needed. Will follow up soon. |
✏️ Summary of Changes
docs/arm64.md.ImagePullBackOff,ErrImagePull,exec format error,CrashLoopBackOff).kubectl describe,kubectl logs) and extract the full list of images referenced bykustomize build example.README.mdunder a new Documentation section.kustomize build examplesuccessfully; it prints existing warnings about deprecated kustomize fields and unused vars (kfp-app-name,kfp-app-version).📦 Dependencies
🐛 Related Issues
✅ Contributor Checklist