Chapter 6. Uninstalling the Ansible plug-ins from a Helm installation on OpenShift Container Platform


To uninstall the Ansible plug-ins, you must remove any software templates that use the ansible:content:create action from Red Hat Developer Hub, and remove the plug-ins configuration from the Helm chart in OpenShift.

6.1. Uninstalling a Helm chart installation

To uninstall the Ansible plug-ins from a Helm chart installation, you remove templates using the ansible:content:create action first. Then, you delete the plug-in configuration from the Helm chart YAML, remove the extraContainers section, and delete the Ansible block from the custom ConfigMap. Finally, you restart the deployment.

Procedure

  1. In Red Hat Developer Hub, remove any software templates that use the ansible:content:create action.
  2. In the OpenShift Developer UI, navigate to Helm developer-hub Actions Upgrade Yaml view.
  3. Remove the Ansible plug-ins configuration under the plugins section.

    global:
      dynamic:
        plugins:
          - disabled: false
            package: 'oci://registry.redhat.io/ansible-automation-platform/automation-portal:2.1!ansible-plugin-backstage-rhaap'
            pluginConfig:
              ...
          - disabled: false
            package: 'oci://registry.redhat.io/ansible-automation-platform/automation-portal:2.1!ansible-plugin-scaffolder-backend-module-backstage-rhaap'
            pluginConfig:
              ...

    For HTTP plug-in registry, remove the http://plugin-registry:8080/... entries instead.

  4. Remove the extraContainers section.

    upstream:
      backstage:
        ...
        extraContainers:
          - command:
              - adt
              - server
            image: >-
              registry.redhat.io/ansible-automation-platform-25/ansible-dev-tools-rhel8:latest
            imagePullPolicy: IfNotPresent
            name: ansible-devtools-server
            ports:
              - containerPort: 8000
  5. Click Upgrade.
  6. Edit your custom Red Hat Developer Hub config map, for example app-config-rhdh.
  7. Remove the ansible section.
  8. Restart the Red Hat Developer Hub deployment.
  9. If you used OCI delivery, delete the registry auth secret:

    oc delete secret <deployment-name>-dynamic-plugins-registry-auth
  10. If you used the HTTP plug-in registry method, remove the plug-in registry application:

    oc delete all -l app=plugin-registry
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top