Schematics worker runtime
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. |
The Schematics worker images are built by using the Universal Base Image (UBI-8) 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.
For more information about deprecation note, see Schematics announcement.
| 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. |
The following table enlists the preinstalled software and tools in the Schematics worker images.
Runtime-terraform-job image
| 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 |
Terraform CLI |
Ansible |
v2.9.27 |
v2.9.27 |
For use by the ansible-provisioner 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 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. |
Runtime-ansible-job image
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 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. |