Skip to content

Latest commit

 

History

History
81 lines (51 loc) · 3.99 KB

getting-started.md

File metadata and controls

81 lines (51 loc) · 3.99 KB
copyright lastupdated keywords subcollection content-type services account-plan completion-time
years
2015, 2023
2023-04-03
example, connect to service instance, create service instance, service credentials, instance, IBM Cloudant, cloudant
Cloudant
tutorial
Cloudant
lite
20m

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

Getting started with {{site.data.keyword.cloudant_short_notm}}

{: #getting-started-with-cloudant} {: toc-content-type="tutorial"} {: toc-services="Cloudant"} {: toc-completion-time="20m"}

The {{site.data.keyword.cloudantfull}} Getting started tutorial demonstrates how to use the {{site.data.keyword.cloud}} dashboard to create an {{site.data.keyword.cloudant_short_notm}} service instance and obtain service credentials to connect to it. Finally, it guides you through the creation of a simple, locally hosted web application that uses your {{site.data.keyword.cloudant_short_notm}} database. {: shortdesc}

Objectives

{: #objectives-get-started}

  • Create a service instance.
  • Create an {{site.data.keyword.cloudant_short_notm}} service credential.

Creating a service instance

{: #creating-an-ibm-cloudant-instance-on-ibm-cloud} {: step}

  1. Log in to your {{site.data.keyword.cloud_notm}} account, and click Create resource.

    {{site.data.keyword.cloud_notm}} 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. {: caption="{{site.data.keyword.cloud_notm}} Dashboard" caption-side="bottom"}

    The {{site.data.keyword.cloud_notm}} Dashboard can be found at: https://cloud.ibm.com/{: external}. After you authenticate with your username and password, you're presented with the {{site.data.keyword.cloud_notm}} Dashboard. {: note}

  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 {{site.data.keyword.cloudant_short_notm}} service name and credentials.{: caption="{{site.data.keyword.cloudant_short_notm}} service name and credentials" caption-side="bottom"}

    (In this example, the instance name is Cloudant-o7.) Verify that the resource group and authentication methods are correct. Add a tag if you like. The authentication methods that are available include IAM or IAM and legacy credentials. For more information, see authentication methods.

    The {{site.data.keyword.cloudant_short_notm}} team encourages you to use IAM access controls over {{site.data.keyword.cloudant_short_notm}} legacy authentication whenever possible. {: important}

  5. Select your plan.

  6. 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.

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

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

Creating service credentials

{: #creating-service-credentials} {: step}

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

  2. See more information on Understanding your service credentials.

  3. Now, you're ready to use your {{site.data.keyword.cloudant_short_notm}} database and get familiar with the basic features of {{site.data.keyword.cloud_notm}} by following this tutorial: Creating a web-based To-Do list.