Comment désinstaller Automation Suite

Cette section explique comment désinstaller Automation Suite des environnements EKS/AKS à l'aide du script de désinstallation fourni.

Vous apprendrez à préparer votre système, à exécuter le script, à résoudre les problèmes et à étendre les fonctionnalités pour les exigences personnalisées.

Comprendre le script et les exigences

Cette section vous donne une compréhension de haut niveau du script de désinstallation et décrit les conditions préalables requises pour l'utiliser efficacement.

Le script de désinstallation prend en charge la suppression sélective des composants d'Automation Suite, les simulations de test, la sortie détaillée et la possibilité d'exclure des composants spécifiques via des indicateurs de ligne de commande ou un fichier de configuration JSON.

Prérequis

Cette sous-section répertorie les outils que vous devez avoir installés dans votre environnement pour exécuter avec succès le script de désinstallation :

• EKS/AKS :
  • kubectl
  • helm
• Facultatif :
  • jq : utilisé pour l’analyse JSON

Téléchargement et préparation du script

Pour obtenir le script de désinstallation et le préparer pour son exécution, procédez comme suit :

1. Téléchargez le script uninstall.sh .
2. Rendez le script exécutable en exécutant la commande suivante :

   chmod +x uninstall.sh

Exécution du script et utilisation des options

Cette section décrit comment exécuter le script de désinstallation, y compris la syntaxe de commande, les environnements pris en charge et les indicateurs disponibles.

Vous pouvez exécuter le script à l'aide de la commande suivante :

./uninstall.sh [DISTRIBUTION] [OPTIONS]

Vous pouvez utiliser les options de distribution suivantes, en fonction de vos environnements :

• k8s: utilisez les commandes Kubernetes standard (par défaut).
• openshift: utilisez les commandes et les API OpenShift.

La table suivante répertorie tous les indicateurs et arguments pris en charge que vous pouvez utiliser pour personnaliser le comportement de désinstallation en fonction de votre environnement spécifique.

Option	Description
-h, --help	Affiche les informations d'aide.
-d, --dry-run	Prévisualisez les modifications sans rien supprimer.
-v, --verbose	Activer la journalisation détaillée.
--excluded COMPONENTS	Liste des composants à ignorer, séparés par des virgules.
--clusterconfig FILE	Chemin d'accès à un fichier de configuration JSON pour les exclusions.
--istioNamespace NAMESPACE	Remplacer l'espace de noms Istio par défaut.
--uipathNamespace NAMESPACE	Remplacer l'espace de noms UiPath par défaut.
--argocdNamespace NAMESPACE	Remplacez l'espace de noms ArgoCD par défaut.

Utilisation d'exemples de base

Cette section fournit des exemples de commandes simples pour vous aider à commencer rapidement à utiliser le script de désinstallation avec un minimum d'options.

# Exclude istio from deletion in k8s
./uninstall.sh k8s --excluded istio

# Exclude istio and argocd in OpenShift
./uninstall.sh openshift --excluded istio,argocd

Utilisation de combinaisons avancées

Cette section présente des exemples avancés qui combinent plusieurs options pour des scénarios de désinstallation plus flexibles et plus puissants.

# Dry run to preview changes
./uninstall.sh openshift --dry-run

# Use a JSON config file
./uninstall.sh k8s --clusterconfig input.json

# Custom namespaces
./uninstall.sh openshift --uipathNamespace uipath-prod --istioNamespace custom-istio

# Combined options with verbosity
./uninstall.sh k8s --excluded gatekeeper,falco --clusterconfig input.json --verbose

Configuration des composants et des exclusions

Cette section décrit les composants gérés par le script, la façon de les exclure et les dépendances à prendre en compte.

Composants pris en charge

Cette section répertorie les composants d'Automation Suite que le script de désinstallation est capable de gérer et de supprimer :

• istio - Composants Service Mesh
• istio_configure - Configuration d'Istio
• argocd - Déploiement d'ArgoCD
• uipath - Composants UiPath de base
• cert_manager - Gestion des certificats
• network_policies - Stratégies réseau
• gatekeeper - Application de Gatekeeper
• falco - Application de Gatekeeper

Utilisation de fichiers de configuration

Cette section montre comment configurer les exclusions de composants à l'aide d'un fichier JSON.

Vous pouvez exclure des composants via JSON, comme suit :

{
  "exclude_components": [
    "istio",
    "argocd",
    "gatekeeper"
  ]
}

Comprendre les dépendances des composants

Cette section explique les relations entre les composants pour vous aider à éviter les problèmes lors de l’exclusion d’éléments spécifiques.

Certains composants ont des dépendances par rapport à d'autres :

• Si vous conservez uipath, pensez également à conserver istio et argocd.
• Si vous conservez cert_manager, pensez également à conserver uipath.

Résolution des problèmes et révision des journaux

Cette section met en évidence les problèmes les plus fréquemment rencontrés lors de la désinstallation et explique comment les résoudre efficacement.

• Erreurs d'autorisation :

  kubectl auth can-i delete namespace --all-namespaces
  oc auth can-i delete project --all-namespaces

• Helm introuvable :

  helm version

• Composants non supprimés :

  ./uninstall.sh k8s --verbose

Meilleures pratiques de sécurité

Cette section répertorie les meilleures pratiques pour garantir une exécution sécurisée du script, comme suit :

• Utilisez toujours --dry-run pour prévisualiser les modifications.
• Sauvegarder les fichiers de configuration de cluster.
• Vérifiez les dépendances du composant avant la suppression.

Personnalisation du script

Cette section décrit comment étendre le script pour gérer les nouveaux composants ou types de ressources.

Ajouter de nouveaux composants

Cette section explique comment étendre le script en introduisant de nouveaux composants dans l'étendue de gestion.

Pour ajouter de nouveaux composants, procédez comme suit :

1. Ajoutez votre composant dans la fonction define_components , comme indiqué dans l'exemple suivant :

   function define_components {
       # Existing components...
       
       # Add your new component
       my_new_component="
       helm:my-helm-chart:my-namespace
       role:my-role:my-namespace
       rolebinding:my-rolebinding:my-namespace
       namespace:my-namespace
       argocd:my-application
       crd:my.custom.resource
       "
   }

2. Ajoutez le nom du composant dans la fonction get_all_components , comme indiqué dans l'exemple suivant :

   function get_all_components {
       local components="istio argocd uipath cert_manager network_policies gatekeeper falco istio_configure my_new_component"
       # Rest of the function...
   }