Skip to content
This repository has been archived by the owner on Jul 11, 2023. It is now read-only.

doc: uninstalling OSM and removing all related components from a cluster #2880

Closed
22 tasks
draychev opened this issue Mar 15, 2021 · 1 comment · Fixed by #3003
Closed
22 tasks

doc: uninstalling OSM and removing all related components from a cluster #2880

draychev opened this issue Mar 15, 2021 · 1 comment · Fixed by #3003
Assignees
@michelleN
Labels
area/documentation work items associated with the improvements or additions to documentation priority/P0 P0 priority size/M 7 days (~1.5 week)
Projects
OSM Roadmap
Milestone
v0.9.0

Comments

@draychev
Copy link
Contributor

draychev commented Mar 15, 2021 •
edited
Loading

This GitHub issue is for fleshing out the OSM documentation around uninstalling Open Service Mesh and removing all of its components from a cluster.

  • Document the OSM CLI tool and process of uninstalling OSM -- save the doc in ./docs/wip/uninstall_osm.md (exact location is TBD - wip short term)

    • How do you uninstall OSM? What CLI command does that?
    • What is expected to be deleted by using the CLI?
    • What is expected to remain on the cluster by using the OSM CLI?
    • Does the OSM CLI also remove Envoy sidecars from existing pods?
    • How do we remove the sidecars from existing pods?
    • Could this cause downtime?
    • How do we prevent downtime during removal of OSM from the cluster?
    • What happens to the CA?
    • Are there alternatives?

  • Create Troubleshooting Guide

    • How do you manually delete Mutating WebhookConfig, Validating WHc, OSM ConfigMap,
    • How do you backup SMI CRDs and delete Custom Resource Definitions (SMI) from the cluster
    • How do you remove the CA?
    • Are there any other artifacts that need to be manually removed?
    • List all artifacts related to OSM and provide a command to remove them
    • How do you manually perform rolling restart to remove Envoy sidecars?
    • How do you remove annotations from namespaces?
    • What namespaces are annotated? What are the annotations that need to be removed (monitor, inject, metrics)
    • How can we remove OSM Controller with 0-downtime?
      • Change MutatingWebhook first? Change to Ignore
      • Shutdown / delete controller?
@draychev draychev added area/documentation work items associated with the improvements or additions to documentation priority/P0 P0 priority labels Mar 15, 2021
@michelleN michelleN self-assigned this Mar 19, 2021
@michelleN
Copy link
Contributor

Should this doc live in /docs/content/docs/tasks_usage/?

@phillipgibson phillipgibson added this to Planned & Scoped in OSM Roadmap via automation Mar 22, 2021
@phillipgibson phillipgibson moved this from Planned & Scoped to In progress (Active Development) in OSM Roadmap Mar 22, 2021
@phillipgibson phillipgibson added this to the v0.9.0 milestone Mar 22, 2021
michelleN pushed a commit to michelleN/osm that referenced this issue Mar 25, 2021
ref(docs): update uninstall guide
5d00566 
+ update uninstall guide
+ resolves openservicemesh#2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
@michelleN michelleN mentioned this issue Mar 25, 2021
Merged
michelleN pushed a commit to michelleN/osm that referenced this issue Mar 26, 2021
ref(docs): update uninstall guide
7defd42 
+ update uninstall guide
+ update uninstall troubleshooting guide
+ resolves openservicemesh#2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
michelleN pushed a commit to michelleN/osm that referenced this issue Mar 26, 2021
ref(docs): update uninstall guide
051c322 
+ update uninstall guide
+ update uninstall troubleshooting guide
+ resolves openservicemesh#2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
michelleN pushed a commit to michelleN/osm that referenced this issue Mar 26, 2021
ref(docs): update uninstall guide
e8a687d 
+ update uninstall guide
+ update uninstall troubleshooting guide
+ resolves openservicemesh#2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
@draychev draychev added the size/M 7 days (~1.5 week) label Mar 29, 2021
michelleN pushed a commit to michelleN/osm that referenced this issue Apr 1, 2021
ref(docs): update uninstall guide
825f6d1 
+ update uninstall guide
+ update uninstall troubleshooting guide
+ resolves openservicemesh#2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
OSM Roadmap automation moved this from In progress (Active Development) to Done Apr 1, 2021
michelleN pushed a commit that referenced this issue Apr 1, 2021
ref(docs): update uninstall guide (#3003)
d5bf349 
+ update uninstall guide
+ update uninstall troubleshooting guide
+ resolves #2880

Signed-off-by: Michelle Noorali <minooral@microsoft.com>
@bridgetkromhout bridgetkromhout mentioned this issue May 21, 2021
Closed
22 tasks
@draychev draychev mentioned this issue May 27, 2021
Closed
30 tasks
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees

@michelleN michelleN

Labels
area/documentation work items associated with the improvements or additions to documentation priority/P0 P0 priority size/M 7 days (~1.5 week)
Projects
No open projects
OSM Roadmap
  
Done
Milestone
v0.9.0
Development

Successfully merging a pull request may close this issue.

ref(docs): update uninstall guide michelleN/osm
3 participants
@michelleN @phillipgibson @draychev