Skip to content

Latest commit

 

History

History
74 lines (49 loc) · 2.71 KB

setup-terraform.md

File metadata and controls

74 lines (49 loc) · 2.71 KB
Raw
copyright lastupdated keywords subcollection content-type
years
2022, 2023
2022-03-28
quantum, Qiskit, runtime, near time compute, terraform
quantum-computing
howto

{{site.data.keyword.attribute-definition-list}}

Set up Terraform for Qiskit Runtime

{: #setup-terraform}

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

Provisioning with Terraform

{: #Provisioning-with-Terraform}

If you use Terraform to manage your infrastructure, the IBM Cloud provider for Terraform{: external} 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

{: #example}

After the job completes, you can view the results.

  1. In your Terraform configuration file, add the following code:

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

    {: codeblock}

    Change the name of the service instance (parameter “name”) and the plan (parameter “plan”) according to your requirements.

  2. Create a Terraform execution plan.

    terraform plan

    {: codeblock}

  3. Remove the namespace and re-create it with a new name. Note that this process might take a few minutes to complete.

    terraform apply

    {: codeblock}

  4. Verify on the Instances page{: external} 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{: external} for more details and examples.