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

Update documentation around CRD removal #3422

Merged
merged 2 commits into from
Oct 30, 2023
Merged

Update documentation around CRD removal #3422

merged 2 commits into from
Oct 30, 2023

Conversation

theunrepentantgeek
Copy link
Member

What this PR does / why we need it:

Fixes incorrect documentation.

Closes #3416

How does this PR make you feel:
gif

If applicable:

  • this PR contains documentation

@theunrepentantgeek theunrepentantgeek added the documentation Improvements or additions to documentation label Oct 16, 2023
@theunrepentantgeek theunrepentantgeek added this to the v2.4.0 milestone Oct 16, 2023
@theunrepentantgeek theunrepentantgeek self-assigned this Oct 16, 2023
docs/hugo/content/guide/uninstalling.md Outdated Show resolved Hide resolved
docs/hugo/content/guide/uninstalling.md Outdated Show resolved Hide resolved

-- Retrieved from [**helm.sh**](https://helm.sh/docs/chart_best_practices/custom_resource_definitions/) on Monday, 16 October 2023

### Uninstalling with kubectl
Copy link
Member

Choose a reason for hiding this comment

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

After this, wonder if we should have a ### Uninstalling the CRDs section, which explains that:

  1. Neither of the above commands for Helm or kubectl will uninstall the CRDs, nor automatically delete any Custom Resource instances.
  2. Uninstalling the CRDs is dangerous (risk of data loss), and should only be done on a cluster that has ASO already uninstalled via one of the above methods and no existing instances of the CRDs. This can be verified by running the (somewhat slow to execute): kubectl api-resources -o name | grep azure.com | paste -sd "," - | xargs kubectl get -A
  3. Deleting the CRDs can be accomplished by running kubectl delete -f https://github.com/Azure/azure-service-operator/releases/download/v2.3.0/azureserviceoperator_customresourcedefinitions_v2.3.0.yaml

I don't have a Windows version of the command for kubectl api-resources -o name | grep azure.com | paste -sd "," - | xargs kubectl get -A, and there might be a better command for it... I will play around and see if I can find one... but that one is better than what we have currently so might be worth including.

Copy link
Member Author

Choose a reason for hiding this comment

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

I'll add a warning section; we can add specific commands in a later PR.

@matthchr matthchr added this pull request to the merge queue Oct 30, 2023
Merged via the queue into main with commit f7e18f1 Oct 30, 2023
@matthchr matthchr deleted the doc/no-crd-deletion branch October 30, 2023 22:58
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
Development

Successfully merging this pull request may close these issues.

Documentation says uninstalling chart uninstalls CRDs, but it does not
2 participants