IBM Cloud Docs
Software deployment in IBM Cloud Schematics

Software deployment in IBM Cloud Schematics

Try out one of the IBM® provided software templates to quickly spin up a classic Virtual Server Instance (VSI), and automatically configure the instance to connect to an IBM Cloud® Databases for PostgreSQL instance.

With IBM Cloud Schematics, you can choose from a wide variety of software and infrastructure templates that you can use to set up IBM Cloud services, and to install IBM and Third party software. The templates are applied by using the built-in Terraform, Ansible, Helm, CloudPak, and Operator capabilities in Schematics.

As part of this getting started tutorial, you create a Schematics workspace that points to the VSI database template. Then, you run this template and watch Schematics provision your VSI and your IBM Cloud Databases for PostgreSQL instance. IBM Cloud Databases for PostgreSQL is a fully managed database offering in IBM Cloud that supports storing of non-relational and relational data types. For more information about this offering, see What is PostgreSQL?.

This getting started tutorial incurs costs. You must have an IBM Cloud Pay-As-You-Go or Subscription account to proceed. Make sure that you review pricing information for classic VSIs and PostgreSQL.

Before you begin

Before you can use this template, you must complete the following tasks.

Setting up and configuring a classic VSI to run PostgreSQL with Schematics

Use one of the IBM provided software templates to set up and configure a classic VSI so that you can store data in an instance of IBM Cloud Databases for PostgreSQL.

  1. Open the VSI database software template from the IBM Cloud catalog. Click Log in, in case you haven't log in to your IBM Cloud account.

    Observe IBM Cloud is specified in Select your deployment target and Terraform Version 1.0.7 or Terraform Version 2.0.0 is displayed in Select a delivery method.

  2. In the Configure your workspace section, enter Name for your Schematics workspace, select your Resource group, and the Location where you want to create the workspace.

  3. Check Override default Terraform version to configure the template to support your Terraform version.

  4. In the Set the deployment values section, enter the following information.

    • Click Yes toggle button to enter value for admin-password as user123, and db-user-password as user123 that you want to use to log in to your PostgreSQL instance.

      The admin-password and db-user-password must be between 10 and 32 characters long and do not support any special characters.

    • Enter the iaas_classic_username as <your classic_username> that you retrieved earlier. For more information about how to retrieve this information, see Creating a classic infrastructure API key.

    • Select the resource group where you want to provision your virtual server and PostgresSQL instance.

  5. Accept the license agreement, and click Install. You are redirected to the Schematics workspace Activity page where you can monitor the progress of your VSI and PostgreSQL setup. Note that it takes a few minutes for the setup to complete.

  6. Verify your virtual server and PostgreSQL setup.

    • From the workspace Resources page, find the virtual server and PostgreSQL instance that were created for you.
    • Click the link to see the details of your instances.

  7. Optional: Remove your Schematics workspace and all related IBM Cloud resources.

    • Select the Actions drop down list, click Delete.
    • Select the Delete workspace and Delete all associated resources option.
    • Enter the name of your workspace, and click Delete.

You used the capabilities of Schematics to provision IBM Cloud infrastructure and database services, and automatically configured your services to allow network communication.

What's next?