--- name: schematics-sc-tools title: Schematics worker runtime description: The Schematics worker runs your automation workload. The workload is deployed as a Kubernetes job pod that run only one Schematics automation command and self-destructs on completion. All your Schematics command such as `schematics plan`, `schematics apply`, `schematics run`, and `schematics destroy` runs by using the Schematics worker pods. In addition to the core Terraform CLI and Ansible CLI, the Schematics worker job images include several utilities and executables. last-updated: 2026-08-14 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/schematics?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. # Schematics worker runtime {: #sch-utilities} The Schematics worker runs your automation workload. The workload is deployed as a Kubernetes job pod that run only one Schematics automation command and self-destructs on completion. All your Schematics command such as `schematics plan`, `schematics apply`, `schematics run`, and `schematics destroy` runs by using the Schematics worker pods. In addition to the core Terraform CLI and Ansible CLI, the Schematics worker job images include several utilities and executables. Software can not be installed in the Schematics runtime. Any attempt to install a software in the `schematics-runtime-job` pod, is considered a violation and can cause vulnerability. Following are the Schematics type of workers. | Worker | Description | | --- | --- | | runtime-terraform-job | Used to run the Terraform CLI.
This worker is used to run the Schematics workspace jobs. | | runtime-ansible-job | Used to run the Ansible playbook CLI.
This worker is used to run the Schematics Action jobs. | {: caption="Schematics workers types" caption-side="top"} The Schematics worker images are built by using the [Universal Base Image (UBI-8)](https://catalog.redhat.com/software/containers/ubi8/ubi/5c359854d70cc534b3a3784e){: external} as the base image. The Schematics worker images used by the multi-tenant Schematics service instance and the corresponding Schematics agents are not the same. In the multi-tenant Schematics service instance, your Terraform or Ansible automation cannot install any software or tools in the Schematics worker pods. It is blocked by design. {: note} For more information about deprecation note, see [Schematics announcement](https://cloud.ibm.com/status/announcement?component=schematics){: external}. {: note} | From date | Deprecation notice | | --- | --- | | 21 September 2022 | Support for `Python v3.6` in runtime-ansible-job is deprecated. Instead the runtime-ansible job image uses `Python v3.8`. | {: caption="Schematics deprecation note" caption-side="top"} The following table enlists the preinstalled software and tools in the Schematics worker images. ## Runtime-terraform-job image {: #sch-runtime-tf-job} | Software | Versions | In agent | Description | | --- | --- | ---| --- | |`Terraform CLI` | `1.0.x`, `1.1.x`,
`1.2.x`, `1.3.x`, `1.4.x`,
`1.5.x`, `1.6.x`, `1.7.x`,
`1.8.x`, `1.9.x`, `1.10.x`,
`1.11.x`, `1.12.x`, `1.13.x`, `1.14.x` | `1.13.x`, `1.14.x` | Terraform CLI | | `Ansible` | `v2.9.27` | `v2.9.27` | For use by the [ansible-provisioner](https://github.com/radekg/terraform-provisioner-ansible){: external} for Terraform.
It is recommended to use the Schematics actions to run your Ansible automation.| | `IBM Cloud CLI` | Latest | Latest | Latest version of the IBM Cloud CLI plug-ins are pre-installed. For your Terraform automation, it is recommended to use the Terraform provider plugi-ns for IBM Cloud. | | `JQ` | `v1.6` | Yes | As the [JSON processor](https://cloud.ibm.com/docs/solution-tutorials?topic=solution-tutorials-tutorials&format=markdown#getting-started-macos_jq) in your Terraform automation. | | `Kubectl client` | | Yes |For use in your Terraform automation. It is recommended to use the Terraform provider plug-ins for Kubernetes. | | `OpenShift client` | | Yes | Red Hat OpenShift CLI for your Terraform automation. It is recommended to use the Terraform provider plug-ins for IBM Cloud and Kubernetes. | | `Python` | `v3.6` | No | For use in your Terraform automation. | | `Python libraries` | `netaddr` | No | Red Hat OpenShift CLI for your Terraform automation. It is recommended to use the Terraform provider plug-ins for IBM Cloud and Kubernetes. | {: caption="Schematics runtime terraform job image" caption-side="top"} ## Runtime-ansible-job image {: #sch-runtime-ansible-job} The Schematics actions use the `Ansible v2.9.27` in the `Ansible-runtime-job` image. The current minor version of the Ansible CLI is used in the Schematics. | Software | Versions | In agent | Description | | --- | --- | ---| --- | | `Ansible` | `v2.9.27` | `v2.9.27` | Ansible CLI | | `IBM Cloud CLI` | Latest | Latest | Latest version of the IBM Cloud CLI plug-ins are pre-installed, to use in your Ansible automation.| | `JQ` | `v1.6` | `v1.6` | As the [JSON processor](https://cloud.ibm.com/docs/solution-tutorials?topic=solution-tutorials-tutorials&format=markdown#getting-started-macos_jq) in your Ansible automation. | | `Kubectl client` | Latest | Yes | For use in your Ansible automation.| | `OpenShift client` | Latest | Yes | Red Hat OpenShift CLI for your Ansible automation.| | `Python` | `v3.8` | `v3.8` | For use in your Ansible automation. | | `Python libraries` | `netaddr`,
`kubernetes`,
`openshift`,
`pywinrm`,
`boto3`,
`boto`,
`botocore`,
`PyVmomi` | No | For use in your Ansible automation. | {: caption="Schematics runtime ansible job image" caption-side="top"}