Getting started with IBM Cloudant

The IBM® Cloudant® for IBM Cloud® Getting started tutorial demonstrates how to use the IBM Cloud® dashboard to create an IBM Cloudant service instance and obtain service credentials to connect to it. Finally, you will use the IBM Cloudant database using the Dashboard.

If you'd prefer to create a IBM Cloudant instance using the command line, see the Creating a service instance using the IBM Cloud CLI tutorial.

Objectives

  • Create a service instance.
  • Create an IBM Cloudant service credential.
  • Create databases and JSON documents using the IBM Cloudant Dashboard.

Creating a service instance

  1. Log in to your IBM Cloud account, and click Create resource.

    IBM Cloud Dashboard, which includes Build tile, Monitor your resources tile, Create and deploy an application tile, API Connect tile, Integrate Watson with anything tile, and Watson starter kits tile.
    IBM Cloud Dashboard

    The IBM Cloud Dashboard can be found at: https://cloud.ibm.com/. After you authenticate with your username and password, you're presented with the IBM Cloud Dashboard.

  2. Type Cloudant in the Search bar and click to open it.

  3. Select an offering and an environment.

  4. Type an instance name.

    Create the IBM Cloudant service name and credentials.
    IBM Cloudant service name and credentials

    (In this example, the instance name is Cloudant-o7.) Verify that the resource group is correct. Add a tag if you like.

  5. To create the service, click Create:

    After you click Create, the system displays a message to say that the instance is being provisioned, which returns you to the Resource list. From the Resource list, you see that the status for your instance is, Provision in progress.

  6. After you create an instance, the status changes to Active.

  7. Click the instance, and proceed to the next section, Creating service credentials.

Creating service credentials

For more information about where to find your credentials, see Locating your credentials.

Using your IBM Cloudant service with the Dashboard

Use the IBM Cloudant Dashboard to manage your IBM Cloudant service. For more information, see Using the IBM Cloudant Dashboard.