Automation Suite on EKS/AKS installation guide

Installing cert-manager​

Uninstalling Cert Manager​

Prerequisites​

• Kubectl CLI (kubectl) installed and configured.
• Appropriate permissions to delete resources in the target namespaces.

Information required​

• UiPath namespace where cert-manager resources are being used.

Step-by-step uninstallation process​

1. Delete the role bindings for cert-manager:
   assignment

   # Verify if the role binding exists
   kubectl get rolebinding -n <uipath_namespace> | grep cert-manager
   
   # If it exists, delete it
   kubectl delete rolebinding <role-binding-name> -n <uipath_namespace>
   # Verify if the role binding exists
   kubectl get rolebinding -n <uipath_namespace> | grep cert-manager
   
   # If it exists, delete it
   kubectl delete rolebinding <role-binding-name> -n <uipath_namespace>
   

2. Delete the cert-manager role:
   assignment

   # Check if the role exists
   kubectl get role cert-manager -n <uipath_namespace> | grep cert-manager
   
   # If it exists, delete it
   kubectl delete role <cert-manamger-role> -n <uipath_namespace>
   # Check if the role exists
   kubectl get role cert-manager -n <uipath_namespace> | grep cert-manager
   
   # If it exists, delete it
   kubectl delete role <cert-manamger-role> -n <uipath_namespace>
   

3. Clean up cert-manager resources in the namespace:
   assignment

   # Delete all certificates
   kubectl delete certificates.cert-manager.io --all -n <uipath_namespace>
   
   # Delete all issuers
   kubectl delete issuers.cert-manager.io --all -n <uipath_namespace>
   
   # Delete all clusterissuers if you created any
   kubectl delete clusterissuers.cert-manager.io --all
   # Delete all certificates
   kubectl delete certificates.cert-manager.io --all -n <uipath_namespace>
   
   # Delete all issuers
   kubectl delete issuers.cert-manager.io --all -n <uipath_namespace>
   
   # Delete all clusterissuers if you created any
   kubectl delete clusterissuers.cert-manager.io --all
   

4. Uninstall the cert-manager from cluster, delete the namespace or any residual certificate resources following steps 1, 2, and 3 for other namespaces. Also, cross verify if cert-manager is not used by any other component.
5. Verify remaining resources:
   assignment

   # Check for any remaining cert-manager resources
   kubectl get all -n <uipath_namespace> | grep cert-manager
   kubectl get crd | grep cert-manager
   # Check for any remaining cert-manager resources
   kubectl get all -n <uipath_namespace> | grep cert-manager
   kubectl get crd | grep cert-manager
   

Troubleshooting​

• Ensure you have the necessary permissions.
• Check if the resources are being used by other applications.
• For resources that are stuck in Terminating state, you may need to remove finalizers.

Notes​

• Only uninstall cert-manager if it is not being used by other applications in your cluster.
• If multiple applications depend on cert-manager, consider only removing the UiPath-specific resources.
• Replace <uipath_namespace> with your actual UiPath namespace.

Installing Dapr​

1. Create an image pull secret in the <uipath> namespace. To create the image pull secret, you can use your typical workflow or take the following steps:
   assignment

   registry= <registry_url> #provide the registry where the UiPath images are hosted
   username= <user_name> #provide the username which will be used for the authentication
   password= <password> #provide the password which will be used for the authentication
   namespace= <namespace> #namespace where you want to create a secret
   kubectl create secret docker-registry uipathpullsecret --namespace=${namespace} \
     --docker-server=${registry} --docker-username=${username} \
     --docker-password=${password} --dry-run=client -o yaml \
     | kubectl apply -f -
   registry= <registry_url> #provide the registry where the UiPath images are hosted
   username= <user_name> #provide the username which will be used for the authentication
   password= <password> #provide the password which will be used for the authentication
   namespace= <namespace> #namespace where you want to create a secret
   kubectl create secret docker-registry uipathpullsecret --namespace=${namespace} \
     --docker-server=${registry} --docker-username=${username} \
     --docker-password=${password} --dry-run=client -o yaml \
     | kubectl apply -f -
   

2. Create the Argo application using the following YAML file:
   assignment

   apiVersion: argoproj.io/v1alpha1
   kind: Application
   metadata:
     name: dapr
     namespace: <argo_namespace>
   spec:
     destination:
       namespace: <uipath_namespace>
       server: https://kubernetes.default.svc
     ignoreDifferences:
     - jsonPointers:
       - /data
       - /stringData
       - /metadata
       kind: Secret
     - group: apiextensions.k8s.io
       jsonPointers:
       - /spec/conversion
       kind: CustomResourceDefinition
     - group: admissionregistration.k8s.io
       jsonPointers:
       - /webhooks
       kind: MutatingWebhookConfiguration
     project: <project_name>
     source:
       chart: helm/dapr
       helm:
         valueFiles:
         - values.yaml
         values: |
           global:
             registry: <target-registry>/daprio
             imagePullSecrets: uipathpullsecret
             mtls:
               enabled: true
             prometheus:
               enabled: false
             logAsJson: true
             actors:
               enabled: false
             ha:
               enabled: false
               replicaCount: 1
             rbac:
               namespaced: true
             seccompProfile: RuntimeDefault
           dapr_dashboard:
             enabled: false
           dapr_operator:
             watchInterval: 1m
             resources:
               requests:
                 cpu: 100m
                 memory: 100Mi
               limits:
                 cpu: "1"
                 memory: 200Mi
             watchNamespace: <uipath_namespace>
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_sidecar_injector:
             allowedServiceAccounts: <uipath_namespace>:default
             resources:
               requests:
                 cpu: 100m
                 memory: 30Mi
               limits:
                 cpu: "1"
                 memory: 100Mi
             sidecarDropALLCapabilities: true
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_sentry:
             resources:
               requests:
                 cpu: 100m
                 memory: 30Mi
               limits:
                 cpu: "1"
                 memory: 100Mi
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_rbac:
             secretReader:
               enabled: false
             createClusterScopedObjects: true
       repoURL: <target-registry>
       targetRevision: <dapr-version>
     syncPolicy:
       automated:
         prune: true
         selfHeal: true
       retry:
         backoff:
           duration: 10s
           factor: 2
           maxDuration: 1m
         limit: 1000
       syncOptions:
       - CreateNamespace=true
       - RespectIgnoreDifferences=true
   apiVersion: argoproj.io/v1alpha1
   kind: Application
   metadata:
     name: dapr
     namespace: <argo_namespace>
   spec:
     destination:
       namespace: <uipath_namespace>
       server: https://kubernetes.default.svc
     ignoreDifferences:
     - jsonPointers:
       - /data
       - /stringData
       - /metadata
       kind: Secret
     - group: apiextensions.k8s.io
       jsonPointers:
       - /spec/conversion
       kind: CustomResourceDefinition
     - group: admissionregistration.k8s.io
       jsonPointers:
       - /webhooks
       kind: MutatingWebhookConfiguration
     project: <project_name>
     source:
       chart: helm/dapr
       helm:
         valueFiles:
         - values.yaml
         values: |
           global:
             registry: <target-registry>/daprio
             imagePullSecrets: uipathpullsecret
             mtls:
               enabled: true
             prometheus:
               enabled: false
             logAsJson: true
             actors:
               enabled: false
             ha:
               enabled: false
               replicaCount: 1
             rbac:
               namespaced: true
             seccompProfile: RuntimeDefault
           dapr_dashboard:
             enabled: false
           dapr_operator:
             watchInterval: 1m
             resources:
               requests:
                 cpu: 100m
                 memory: 100Mi
               limits:
                 cpu: "1"
                 memory: 200Mi
             watchNamespace: <uipath_namespace>
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_sidecar_injector:
             allowedServiceAccounts: <uipath_namespace>:default
             resources:
               requests:
                 cpu: 100m
                 memory: 30Mi
               limits:
                 cpu: "1"
                 memory: 100Mi
             sidecarDropALLCapabilities: true
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_sentry:
             resources:
               requests:
                 cpu: 100m
                 memory: 30Mi
               limits:
                 cpu: "1"
                 memory: 100Mi
             deploymentAnnotations:
               sidecar.istio.io/inject: "false"
           dapr_rbac:
             secretReader:
               enabled: false
             createClusterScopedObjects: true
       repoURL: <target-registry>
       targetRevision: <dapr-version>
     syncPolicy:
       automated:
         prune: true
         selfHeal: true
       retry:
         backoff:
           duration: 10s
           factor: 2
           maxDuration: 1m
         limit: 1000
       syncOptions:
       - CreateNamespace=true
       - RespectIgnoreDifferences=true
   

Generating the application YAML file via Bash script​

#!/bin/bas

echo "Enter the namespace of argocd applications"
read argocd_namespace

echo "Enter the name of uipath namespace"
read uipath_namespace


if [[ "${argocd_namespace}" == "openshift-gitops" ]]; then
  echo "Enter the argocd project name"
  read project
else
  project="default"
fi

echo "Enter the registry fqdn"
read registry_fqdn

echo "Enter the DAPR helm chart version"
read dapr_version

echo "-------------------- SUMMARY --------------------"
echo "Argocd Application namespace : $argocd_namespace"
echo "Uipath namespace             : $uipath_namespace"
echo "Argocd Project name          : $project"
echo "Helm registry FQDN           : $registry_fqdn"
echo "DAPR Version                 : $dapr_version"

echo "------------- Application yaml file-------------"

echo -n "apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: dapr
  namespace: $argocd_namespace
spec:
  destination:
    namespace: $uipath_namespace
    server: https://kubernetes.default.svc
  ignoreDifferences:
  - jsonPointers:
    - /data
    - /stringData
    - /metadata
    kind: Secret
  - group: apiextensions.k8s.io
    jsonPointers:
    - /spec/conversion
    kind: CustomResourceDefinition
  - group: admissionregistration.k8s.io
    jsonPointers:
    - /webhooks
    kind: MutatingWebhookConfiguration
  project: $project
  source:
    chart: helm/dapr
    helm:
      valueFiles:
      - values.yaml
      values: |
        global:
          registry: $registry_fqdn/daprio
          imagePullSecrets: uipathpullsecret
          mtls:
            enabled: true
          prometheus:
            enabled: false
          logAsJson: true
          actors:
            enabled: false
          ha:
            enabled: false
            replicaCount: 1
          rbac:
            namespaced: true
          seccompProfile: RuntimeDefault
        dapr_dashboard:
          enabled: false
        dapr_operator:
          watchInterval: 1m
          resources:
            requests:
              cpu: 100m
              memory: 100Mi
            limits:
              cpu: "1"
              memory: 200Mi
          watchNamespace: $uipath_namespace
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_sidecar_injector:
          allowedServiceAccounts: $uipath_namespace:default
          resources:
            requests:
              cpu: 100m
              memory: 30Mi
            limits:
              cpu: "1"
              memory: 100Mi
          sidecarDropALLCapabilities: true
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_sentry:
          resources:
            requests:
              cpu: 100m
              memory: 30Mi
            limits:
              cpu: "1"
              memory: 100Mi
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_rbac:
          secretReader:
            enabled: false
          createClusterScopedObjects: true
    repoURL: $registry_fqdn
    targetRevision: $dapr_version
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    retry:
      backoff:
        duration: 10s
        factor: 2
        maxDuration: 1m
      limit: 1000
    syncOptions:
    - CreateNamespace=true
    - RespectIgnoreDifferences=true"
#!/bin/bas

echo "Enter the namespace of argocd applications"
read argocd_namespace

echo "Enter the name of uipath namespace"
read uipath_namespace


if [[ "${argocd_namespace}" == "openshift-gitops" ]]; then
  echo "Enter the argocd project name"
  read project
else
  project="default"
fi

echo "Enter the registry fqdn"
read registry_fqdn

echo "Enter the DAPR helm chart version"
read dapr_version

echo "-------------------- SUMMARY --------------------"
echo "Argocd Application namespace : $argocd_namespace"
echo "Uipath namespace             : $uipath_namespace"
echo "Argocd Project name          : $project"
echo "Helm registry FQDN           : $registry_fqdn"
echo "DAPR Version                 : $dapr_version"

echo "------------- Application yaml file-------------"

echo -n "apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: dapr
  namespace: $argocd_namespace
spec:
  destination:
    namespace: $uipath_namespace
    server: https://kubernetes.default.svc
  ignoreDifferences:
  - jsonPointers:
    - /data
    - /stringData
    - /metadata
    kind: Secret
  - group: apiextensions.k8s.io
    jsonPointers:
    - /spec/conversion
    kind: CustomResourceDefinition
  - group: admissionregistration.k8s.io
    jsonPointers:
    - /webhooks
    kind: MutatingWebhookConfiguration
  project: $project
  source:
    chart: helm/dapr
    helm:
      valueFiles:
      - values.yaml
      values: |
        global:
          registry: $registry_fqdn/daprio
          imagePullSecrets: uipathpullsecret
          mtls:
            enabled: true
          prometheus:
            enabled: false
          logAsJson: true
          actors:
            enabled: false
          ha:
            enabled: false
            replicaCount: 1
          rbac:
            namespaced: true
          seccompProfile: RuntimeDefault
        dapr_dashboard:
          enabled: false
        dapr_operator:
          watchInterval: 1m
          resources:
            requests:
              cpu: 100m
              memory: 100Mi
            limits:
              cpu: "1"
              memory: 200Mi
          watchNamespace: $uipath_namespace
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_sidecar_injector:
          allowedServiceAccounts: $uipath_namespace:default
          resources:
            requests:
              cpu: 100m
              memory: 30Mi
            limits:
              cpu: "1"
              memory: 100Mi
          sidecarDropALLCapabilities: true
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_sentry:
          resources:
            requests:
              cpu: 100m
              memory: 30Mi
            limits:
              cpu: "1"
              memory: 100Mi
          deploymentAnnotations:
            sidecar.istio.io/inject: "false"
        dapr_rbac:
          secretReader:
            enabled: false
          createClusterScopedObjects: true
    repoURL: $registry_fqdn
    targetRevision: $dapr_version
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    retry:
      backoff:
        duration: 10s
        factor: 2
        maxDuration: 1m
      limit: 1000
    syncOptions:
    - CreateNamespace=true
    - RespectIgnoreDifferences=true"

Uninstalling Dapr​

Prerequisites​

• Kubectl CLI (kubectl) installed and configured.
• Appropriate permissions to delete resources in the target namespaces.

Information required​

• UiPath namespace where Dapr is installed.
• ArgoCD namespace (typically argocd or openshift-gitops).

Step-by-step uninstallation process​

1. Delete the Dapr application from ArgoCD:

   assignment

   # Verify the application exists first
   kubectl get application.argoproj.io dapr -n <argocd_namespace>
   
   # If it exists, delete it
   kubectl delete application.argoproj.io dapr -n <argocd_namespace>
   # Verify the application exists first
   kubectl get application.argoproj.io dapr -n <argocd_namespace>
   
   # If it exists, delete it
   kubectl delete application.argoproj.io dapr -n <argocd_namespace>
   

   Wait for resources to be deleted.

2. Delete Dapr custom resources:

   assignment

   # Delete all Dapr components in the UiPath namespace
   kubectl delete components.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr configurations in the UiPath namespace
   kubectl delete configurations.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr resiliencies in the UiPath namespace
   kubectl delete resiliencies.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr subscriptions in the UiPath namespace
   kubectl delete subscriptions.dapr.io --all -n <uipath_namespace>
   # Delete all Dapr components in the UiPath namespace
   kubectl delete components.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr configurations in the UiPath namespace
   kubectl delete configurations.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr resiliencies in the UiPath namespace
   kubectl delete resiliencies.dapr.io --all -n <uipath_namespace>
   
   # Delete all Dapr subscriptions in the UiPath namespace
   kubectl delete subscriptions.dapr.io --all -n <uipath_namespace>
   

3. Delete Dapr custom resource definitions (CRDs):

   assignment

   # Delete Dapr CRDs
   kubectl delete crd components.dapr.io
   kubectl delete crd configurations.dapr.io
   kubectl delete crd resiliencies.dapr.io
   kubectl delete crd subscriptions.dapr.io
   # Delete Dapr CRDs
   kubectl delete crd components.dapr.io
   kubectl delete crd configurations.dapr.io
   kubectl delete crd resiliencies.dapr.io
   kubectl delete crd subscriptions.dapr.io
   

4. Remove Dapr webhook configurations:

   assignment

   # Delete the Dapr sidecar injector webhook
   kubectl delete mutatingwebhookconfigurations dapr-sidecar-injector
   # Delete the Dapr sidecar injector webhook
   kubectl delete mutatingwebhookconfigurations dapr-sidecar-injector
   

5. Remove Dapr-specific role bindings

   assignment

   # Verify if the role binding exists
   kubectl get rolebinding -n <uipath_namespace> | grep dapr
   
   # If it exists, delete dapr specific role binding
   kubectl delete rolebinding <dapr-role-binding> -n <uipath_namespace>
   # Verify if the role binding exists
   kubectl get rolebinding -n <uipath_namespace> | grep dapr
   
   # If it exists, delete dapr specific role binding
   kubectl delete rolebinding <dapr-role-binding> -n <uipath_namespace>
   

6. Remove Dapr-specific roles:

   assignment

   # Check if the dapr-creator role exists
   kubectl get role -n <uipath_namespace> | grep dapr
   
   # If it exists, delete dapr specific rolekubectl delete role <dapr-role> -n <uipath_namespace>
   # Check if the dapr-creator role exists
   kubectl get role -n <uipath_namespace> | grep dapr
   
   # If it exists, delete dapr specific rolekubectl delete role <dapr-role> -n <uipath_namespace>
   

7. Clean up remaining Dapr resources

   • Pods:
     assignment

     # List all Dapr-related pods
     kubectl get pods -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr pod if any
     kubectl delete pod <pod_name> -n <uipath_namespace>
     # List all Dapr-related pods
     kubectl get pods -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr pod if any
     kubectl delete pod <pod_name> -n <uipath_namespace>
     

   • Services:
     assignment

     # List all Dapr-related services
     kubectl get svc -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr service if any
     kubectl delete svc <service_name> -n <uipath_namespace>
     # List all Dapr-related services
     kubectl get svc -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr service if any
     kubectl delete svc <service_name> -n <uipath_namespace>
     

   • Deployments:
     assignment

     # List all Dapr-related deployments
     kubectl get deployments -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr deployment
     kubectl delete deployment <deployment_name> -n <uipath_namespace>
     # List all Dapr-related deployments
     kubectl get deployments -n <uipath_namespace> | grep dapr
     
     # Delete each Dapr deployment
     kubectl delete deployment <deployment_name> -n <uipath_namespace>
     

Verification​

# Check for any remaining Dapr resources
kubectl get pods -n <uipath_namespace> | grep dapr
kubectl get svc -n <uipath_namespace> | grep dapr
kubectl get deployments -n <uipath_namespace> | grep dapr
kubectl get crd | grep dapr
# Check for any remaining Dapr resources
kubectl get pods -n <uipath_namespace> | grep dapr
kubectl get svc -n <uipath_namespace> | grep dapr
kubectl get deployments -n <uipath_namespace> | grep dapr
kubectl get crd | grep dapr

Troubleshooting​

• Ensure you have the necessary permissions.
• Check if the resources are being managed by another controller.
• Investigate any dependencies that might be preventing deletion.

Notes​

• Replace <uipath_namespace> with your actual UiPath namespace.
• Replace <argocd_namespace> with your actual ArgoCD namespace.
• Be cautious when deleting shared resources that might affect other applications.