getting-started-terraform.md

copyright	lastupdated	keywords	subcollection
years 2017, 2022	2022-11-05	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}}

Getting started: Infrastructure and cloud service deployment in {{site.data.keyword.bplong_notm}}

{: #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}} Workspaces 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}

• Make sure that you have the permissions to create a {{site.data.keyword.bpshort}} Workspaces{: external}.
• Make sure that you have the permissions to create an {{site.data.keyword.cos_full_notm}} instance{: external}.

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

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

   {: codeblock}

3. Select terraform_v01.0 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 right 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, to 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:

• Try out this IBM-provided template{: external} to create a bucket in the {{site.data.keyword.cos_full_notm}} instance that you created with {{site.data.keyword.bpshort}}.
• Learn how to create your own Terraform template.
• Explore other IBM-provided templates{: external}.
• Set up the {{site.data.keyword.bpshort}} CLI or API to start automating {{site.data.keyword.cloud_notm}} resources.