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

feat: add Makefile command for updating auto-generated docs #2014

Closed
wants to merge 1 commit into from

Conversation

YashPimple
Copy link
Member

Fix #1879

Changes made:

  • Modified the Makefile to include a new target named resources.

Signed-off-by: Yash Pimple <yashpimple22@gmail.com>
@YashPimple YashPimple requested review from a team as code owners September 4, 2023 09:59
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Sep 4, 2023
@netlify
Copy link

netlify bot commented Sep 4, 2023

Deploy Preview for keptn-lifecycle-toolkit ready!

Name Link
🔨 Latest commit 8e6b920
🔍 Latest deploy log https://app.netlify.com/sites/keptn-lifecycle-toolkit/deploys/64f5aa8078f4c10008e0b50f
😎 Deploy Preview https://deploy-preview-2014--keptn-lifecycle-toolkit.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.

@sonarcloud
Copy link

sonarcloud bot commented Sep 4, 2023

Kudos, SonarCloud Quality Gate passed!    Quality Gate passed

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

@mowies mowies changed the title fix: command for updating auto-generated docs feat: add Makefile command for updating auto-generated docs Sep 4, 2023
@@ -46,3 +46,34 @@ markdownlint:

markdownlint-fix:
$(MDL_CMD) --entrypoint="markdownlint-cli2-fix" davidanson/markdownlint-cli2-rules:${MDL_DOCKER_VERSION} "**/*.md"

# Define the directories
Copy link
Member

Choose a reason for hiding this comment

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

I suppose these changes are to be made in metrics-operator/Makefile and lifecycle-operator/Makefile. It doesn't make sense to regenerate the resources for lifecycle-operator, if the API has been changed for only the metrics-operator.

Copy link
Member Author

Choose a reason for hiding this comment

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

We'll focus on updating the metrics-operator/Makefile accordingly to target the specific API changes

Copy link
Member

@mowies mowies left a comment

Choose a reason for hiding this comment

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

I would put all the code here in the root Makefile. This is not only about docs so I think that's the more fitting place.


generate-manifests:
@echo "Generating manifests..."
cd $(OPERATOR_DIR) && make generate && make manifests
Copy link
Member

Choose a reason for hiding this comment

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

please use make -C $(OPERATOR_DIR) to call make command from sub-makefiles. same for metrics operator


copy-manifests:
@echo "Copying manifests to Helm..."
cp $(CONFIG_DIR)/crd/bases/*.yaml $(HELM_TEMPLATES_DIR)/
Copy link
Member

Choose a reason for hiding this comment

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

you will need to use kustomize to generate the crds here. just copying the yaml files will not be enough since there are some patch files that are applied to the CRD yamls by kustomize

Comment on lines +72 to +73
awk '/metadata:/{print;print " labels:\n app.kubernetes.io/part-of: keptn-lifecycle-toolkit\n crdGroup: metrics.keptn.sh\n keptn.sh/inject-cert: \"true\"";next}1' $$file > $$tmpfile; \
awk '/metadata:/{print;print " annotations:\n cert-manager.io/inject-ca-from: \"{{ .Release.Namespace }}/klt-certs\"";next}1' $$tmpfile > $$file; \
Copy link
Member

Choose a reason for hiding this comment

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

i would prefer doing this in a different way. is there a way to patch the yaml with kustomize for example?
we did that before here: https://github.com/keptn/lifecycle-toolkit/blob/v0.7.1/helm/overlay/kustomization.yaml


update-crd-docs:
@echo "Updating CRD docs..."
cd .github/scripts/generate-crd-docs/ && ./generate-crd-docs.sh
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
cd .github/scripts/generate-crd-docs/ && ./generate-crd-docs.sh
./.github/scripts/generate-crd-docs/generate-crd-docs.sh

@RealAnna
Copy link
Contributor

Hey @YashPimple are you working on this still?

@YashPimple
Copy link
Member Author

Hey @YashPimple are you working on this still?

Hello @RealAnna I apologize for the oversight, I forgot about it. I'll promptly make a PR soon. Thank You for your patience and support!

@mowies
Copy link
Member

mowies commented Oct 4, 2023

any updates on this @YashPimple ? :)

Copy link
Contributor

github-actions bot commented Dec 4, 2023

This PR has been automatically marked as stale because it has not had recent activity. It will be
closed if no further activity occurs. Thank you for your contributions.

@github-actions github-actions bot added the stale label Dec 4, 2023
@mowies
Copy link
Member

mowies commented Dec 4, 2023

Again asking for updates... @YashPimple

@mowies mowies removed the stale label Dec 4, 2023
@YashPimple
Copy link
Member Author

Again asking for updates... @YashPimple

Hello @mowies sorry for the late update.
I would like to provide an update regarding the above issue i am unable to resolve it and I tried navigating through this issue but am not able to resolve it. I would like to get your help for this issue.

@bacherfl
Copy link
Member

bacherfl commented Dec 7, 2023

Again asking for updates... @YashPimple

Hello @mowies sorry for the late update. I would like to provide an update regarding the above issue i am unable to resolve it and I tried navigating through this issue but am not able to resolve it. I would like to get your help for this issue.

Hi @YashPimple can you please share more details about the issue you are having with this one?

@odubajDT
Copy link
Contributor

Hi @YashPimple any updates on this PR?

@odubajDT
Copy link
Contributor

odubajDT commented Feb 7, 2024

Closing this PR due to inactivity as the issue is already assigned to another contributor. Please feel free to look and take other tickets if you are interested!

@odubajDT odubajDT closed this Feb 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Create command for updating auto-generated docs and helm resources for CRD structs
6 participants