Set up Terraform for Qiskit Runtime¶

If you use Terraform to manage your infrastructure, the IBM Cloud provider for Terraform supports provisioning Qiskit Runtime service instances. The generic ibm_resource_instance resource is used for that. The following parameters have to be specified:

Provisioning with Terraform¶

If you use Terraform to manage your infrastructure, the IBM Cloud provider for Terraform supports provisioning Qiskit Runtime service instances. The generic ibm_resource_instance resource is used for that. The following parameters have to be specified:

name – The name of your service instance.
service – Specify quantum-computing to provision Qiskit Runtime instances.
plan – Can be lite or paygo-standard.
location – Currently, this must be us-east.

Optional parameters include:

resource_group_id – Creates the service instance in the specified resource group.
tags – Add tags to the resource.

Example: Creating a service instance of Qiskit Runtime¶

After the job completes, you can view the results.

In your Terraform configuration file, add the following code. Change the name of the service instance (parameter “name”) and the plan (parameter “plan”) according to your requirements:

resource "ibm_resource_instance" "my-instance" {
        name = "my-instance-name"
        service = "quantum-computing"
        plan = "lite"
        location = "us-east"
}

Create a Terraform execution plan.
```
terraform plan
```
Remove the namespace and re-create it with a new name. Note that this process might take a few minutes to complete.
```
terraform apply
```
Verify on the Instances page that your service instance has been created.

Qiskit Runtime service instances are IAM managed resources. Access can be shaped through terraform using IAM user policies. See IBM IAM user policy for more details and examples.