Skip to content

Latest commit

 

History

History
79 lines (53 loc) · 5.16 KB

getting-started-terraform.md

File metadata and controls

79 lines (53 loc) · 5.16 KB
copyright lastupdated keywords subcollection
years
2017, 2025
2025-01-17
get started with schematics, infrastructure management, infrastructure as code, iac, schematics cloud environment, schematics infrastructure, schematics terraform, terraform provider
schematics

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

Using workspaces to deploy infrastructure and cloud services

{: #get-started-terraform}

Use one of the IBM provided templates to create an {{site.data.keyword.cos_full}}{: external} service instance that you can use to store your data in {{site.data.keyword.cloud_notm}}. {: shortdesc}

The {{site.data.keyword.bplong_notm}} template is a set of files that define the {{site.data.keyword.cloud_notm}} resources that you want to create, update, or delete. You create a {{site.data.keyword.bpshort}} workspace that points to your template and use the built-in capabilities of the {{site.data.keyword.cloud_notm}} provider plug-in for Terraform to provision your {{site.data.keyword.cloud_notm}} resources. For more information about the provider and how {{site.data.keyword.bpshort}} spins up your {{site.data.keyword.cloud_notm}} resources, see Infrastructure deployment with {{site.data.keyword.bpshort}} workspaces{: external}.

Before you begin

{: #prereq}

Before you can use this template, you must complete the following tasks. {: shortdesc}

Creating an {{site.data.keyword.cos_full_notm}} instance with {{site.data.keyword.bpshort}}

{: #create-cos}

Use the {{site.data.keyword.IBM_notm}} provided Terraform template to provision an {{site.data.keyword.cos_full_notm}} instance with a {{site.data.keyword.bpshort}} workspace. {: shortdesc}

  1. From the {{site.data.keyword.bpshort}} workspaces dashboard{: external}, click Create workspace.

  2. In Specify template section. Enter GitHub, GitLab, or Bitbucket Repository URL as shown in the example.

    https://github.com/IBM-Cloud/terraform-provider-ibm/tree/master/examples/ibm-resource-instance

    {: codeblock}

  3. Select terraform_v1.4 from the Terraform version drop down.

  4. Click Next.

  5. In the Workspace details section, enter your Workspace name, Tags, Resource group, Location, and Description.

    Ensure you provide the resource group, and the location where you want to create the workspace. {: note}

  6. Click Next and then click Create to create {{site.data.keyword.bpshort}} workspaces successfully.

  7. In the Variables section, template variables are displayed. Optionally, override the variables by referring the readme file{: external}.

    If you already have an existing {{site.data.keyword.cos_full_notm}} instance in your account, you must enter standard in the plan field. {: tip}

  8. Click Generate plan to see the plan is generated successfully.

  9. Click Apply plan. This process might take a few minutes to complete. Click Jobs to see the details of the provisioning process.

Output

{: #create-cos-output}

View the provisioned {{site.data.keyword.cos_full_notm}} instance.

  1. From the {{site.data.keyword.cloud_notm}} resource list{: external}, select the Storage to view the provisioned {{site.data.keyword.cos_full_notm}} instance.
  2. For more information about create {{site.data.keyword.cos_full_notm}} bucket, see create some buckets to store your data{: external}.

You used the built-in Terraform capabilities of {{site.data.keyword.bpshort}} to create an {{site.data.keyword.cos_full_notm}} service instance in your {{site.data.keyword.cloud_notm}} account.

What's next?

{: #whats-next-gs}

Now that you created your first {{site.data.keyword.cloud_notm}} resource with {{site.data.keyword.bpshort}}, you can explore the following options.