IBM Cloud Docs
使用 CLI 创建实例

使用 CLI 创建实例

本教程说明如何在 IBM Cloud® 上创建 IBM® Cloudant® for IBM Cloud® 服务实例 使用IBM Cloud。CLI。

目标

  1. 使用 IBM Cloud 帐户来创建 IBM Cloudant 服务实例和凭证。
  2. 检索并使用 IBM Cloudant 服务实例。

准备工作

通过遵循 IBM Cloud CLI 教程入门,安装 IBM Cloud CLI 开发者工具。

登录到 IBM Cloud 帐户

以下示例描述了如何登录。 如果使用联合用户 ID,请务必改用一次性密码(ibmcloud login --sso)或使用 API 密钥(ibmcloud --apikey key or @key_file)进行身份验证。 有关如何使用 CLI 登录的更多信息,请参阅 "ibmcloud login 下的 常规 CLI(ibmcloud)命令

  1. 使用以下命令启动IBM Cloud账户的登录流程。

    ibmcloud login
    

    IBM Cloud会做出响应,提醒您当前的 API 端点,并询问您账户的电子邮件地址。

    API endpoint: https://cloud.ibm.com
    Region: au-syd
    
    Email>
    
    Password>
    
  2. 输入账户的电子邮件地址,然后输入密码。

    API endpoint: https://cloud.ibm.com
    
    Email> J.Doe@email.com
    
    Password>
    

    IBM Cloud会验证您的详细信息,并汇总登录会话的相关信息。

    API endpoint: https://cloud.ibm.com
    
    Email> J.Doe@email.com
    
    Password>
    Authenticating...
    OK
    
    Targeted account J DOE's Account (707...a32)
    
    Targeted org J.Doe@email.com
    
    Targeted space dev
    
    API endpoint:   https://cloud.ibm.com (API version: 2.54.0)
    Region:         au-syd
    User:           j.doe@email.com
    Account:        J DOE's Account (707...a32)
    Org:            J.Doe@email.com
    Space:          dev
    
  3. 您现在已登录到 IBM Cloud 帐户。

创建 IBM Cloudant 服务

IBM Cloudant 使用资源组调配新实例。

在此示例中,通过运行以下命令在 IBM Cloud 中创建服务实例。

ibmcloud resource service-instance-create NAME SERVICE_NAME SERVICE_PLAN_NAME LOCATION [-p, --parameters @JSON_FILE | JSON_STRING ]

下面的表中描述了该命令中的字段。

基本命令格式字段
字段 描述
NAME 为实例提供的任意名称。
SERVICE_NAME cloudantnosqldb
SERVICE_PLAN_NAME Lite 套餐 (lite) 或 Standard 套餐 (standard)
LOCATION 要部署的位置包括以下城市: 悉尼 au-syd,金奈 in-che,大坂 jp-osa,东京 jp-tok,首尔 kr-seo,法兰克福 eu-de,伦敦 eu-gb,达拉斯 us-south,华盛顿特区 us-east
legacyCredentials 默认为 "true。 此字段指示实例是同时使用旧凭证和 IAM 凭证还是仅使用 IAM 凭证。

SERVICE_PLAN_NAME 是您在创建实例时选择的定价计划类型。 有关更多信息,请参阅文档中的 套餐,以获取有关使用 IBM Cloudant Lite 或 Standard 套餐的详细信息。

有关选择身份验证方法的更多信息,请参阅 IAM 指南。 IBM Cloudant 团队建议您尽可能对 IBM Cloudant 旧认证使用 IAM 访问控制。

现在,我们创建一个名为 cs20170517a 的服务实例。

  1. 使用以下格式设置目标资源组和区域。 要运行此命令,您需要了解在以下步骤中找到的区域和资源组。

    有关更多信息,请参阅 ibmcloud target 下的 常规 CLI(ibmcloud)命令

    ibmcloud target [-r REGION_NAME] [-g RESOURCE_GROUP]
    
  2. 要查看区域列表,请运行以下命令。

    ibmcloud regions
    
  3. 要查看资源组列表,请运行以下命令。

    ibmcloud resource groups
    
  4. 使用 "Lite计划创建IBM Cloudant服务实例。
    实例名称在美国南部位置为 cs20170517a,并且仅使用 IAM 凭证。

    ibmcloud resource service-instance-create cs20170517a cloudantnosqldb lite us-south -p '{"legacyCredentials": false}'
    
  5. 创建服务实例后,请参阅以下示例消息。

    Creating service instance cs20170517a in resource group default of account John Does's Account as j.doe@email.com...
    OK
    Service instance cs20170517a was created.
    Name          Location   State        Tags
    cs20170517a   au-syd   active   service_instance
    

接下来,为 IBM Cloudant 服务实例创建服务凭证。

为 IBM Cloudant 服务创建凭证

需要访问 IBM Cloudant 服务的应用程序必须具有必要的凭证。

服务凭证十分重要。 如果任何人或任何应用程序有权访问凭证,那么就能使用服务实例有效地执行所需的一切操作。 例如,可能会创建虚假数据,或删除有价值的信息。 因此,请谨慎保护这些凭证。

有关服务凭证中所包含字段的更多信息,请参阅 IAM 指南

在下一个示例中,通过运行以下命令为 IBM Cloud 中的服务实例创建凭证。

ibmcloud resource service-key-create NAME ROLE_NAME --instance-name SERVICE_INSTANCE_NAME

下面的表中描述了该命令中的字段。

创建证书字段
字段 描述
NAME 为服务凭证提供的任意名称。
ROLE_NAME 目前此字段仅允许“管理者”角色。
SERVICE_INSTANCE_NAME 您为IBM Cloudant实例起的名称。

现在,为您在上一步中创建的 cs20170517a 实例创建凭证。

  1. 通过运行以下命令,为 IBM Cloudant 服务的 cs20170517a 实例创建凭证 (其中凭证的名称为 creds_for_cs20170517a)。

    ibmcloud resource service-key-create creds_for_cs20170517a Manager --instance-name cs20170517a
    
  2. 接收到为服务实例创建凭证的请求后,请查看来自 IBM Cloud 的响应,该响应包含类似于以下示例中的消息。

    Creating service key in resource group default of account John Does's Account as john.doe@email.com...
    OK
    Service key crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42223455bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3:resource-key:621ffde2-ea10-4318-b297-d6d849cec48a was created.
    
    Name:          creds_for_cs20170517a
    ID:            crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42223455bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3:resource-key:621ffde2-ea10-4318-b297-d6d849cec48a
    Created At:    Tue Sep 18 19:58:38 UTC 2018
    State:         active
    Credentials:
                   iam_apikey_name:          auto-generated-apikey-621ffde2-ea10-4318-b297-d6d849cec48a
                   iam_role_crn:             crn:v1:bluemix:public:iam::::serviceRole:Manager
                   url:                      https://apikey-v2-58B528DF5397465BB6673E1B79482A8C:5811381f6daff7255b288695c3544be63f550e975bcde46799473e69c7d48d61@f6cf0c55-48ea-4908-b441-a962b27d3bb6-bluemix.cloudant.com
                   username:                 apikey-v2-58B528DF5397465BB6673E1B79482A8C
                   port:                     443
                   apikey:                   XXXXX-XXXXXX_XXXXXXXXXXXXX-XXXXXXXXXXX
                   host:                     f6cf0c55-48ea-4908-b441-a962b27d3bb6-bluemix.cloudant.com
                   iam_apikey_description:   Auto generated apikey during resource-k  ey operation for Instance - crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42116849bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3::
                   iam_serviceid_crn:        crn:v1:bluemix:public:iam-identity::a/b42116849bb7e2abb0841ca25d28ee4c::serviceid:ServiceId-53f9e2a2-cdfb-4f90-b072-bfffafb68b3e
                   password:                 581138...7d48d61
    

接下来,您将学习如何检索服务凭证。 您需要服务凭证才能登录到 IBM Cloudant 实例。

检索 IBM Cloudant 服务的服务凭证

  1. 检索 IBM Cloudant 服务的 cs20170517a 实例的凭证。 凭证的名称为 creds_for_cs20170517a

    ibmcloud resource service-key creds_for_cs20170517b
    
  2. 接收到检索服务实例凭证的请求后,请查看来自 IBM Cloud 的响应,该响应包含类似于以下 (缩写) 示例中的消息的消息。

    Retrieving service key in resource group default of account John Does's Account as john.doe@email.com...
    OK
    Service key crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42223455bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3:resource-key:621ffde2-ea10-4318-b297-d6d849cec48a was created.
    
    Name:          creds_for_cs20170517a
    ID:            crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42223455bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3:resource-key:621ffde2-ea10-4318-b297-d6d849cec48a
    Created At:    Tue Sep 18 19:58:38 UTC 2018
    State:         active
    Credentials:
                 iam_apikey_name:          auto-generated-apikey-621ffde2-ea10-4318-b297-d6d849cec48a
                 iam_role_crn:             crn:v1:bluemix:public:iam::::serviceRole:Manager
                 url:                      https://apikey-v2-58B528DF5397465BB6673E1B79482A8C:5811381f6daff7255b288695c3544be63f550e975bcde46799473e69c7d48d61@f6cf0c55-48ea-4908-b441-a962b27d3bb6-bluemix.cloudant.com
                 username:                 apikey-v2-58B528DF5397465BB6673E1B79482A8C
                 port:                     443
                 apikey:                   XXXXX-XXXXXX_XXXXXXXXXXXXX-XXXXXXXXXXX
                 host:                     f6cf0c55-48ea-4908-b441-a962b27d3bb6-bluemix.cloudant.com
                 iam_apikey_description:   Auto generated apikey during resource-key operation for Instance - crn:v1:bluemix:public:cloudantnosqldb:us-south:a/b42116849bb7e2abb0841ca25d28ee4c:ee78351d-82bf-4e80-bc22-825c937fafa3::
                 iam_serviceid_crn:        crn:v1:bluemix:public:iam-identity::a/b42116849bb7e2abb0841ca25d28ee4c::serviceid:ServiceId-53f9e2a2-cdfb-4f90-b072-bfffafb68b3e
                 password:                 581138...7d48d61
    

现在,教程已经完成。 (可选) 您可以删除服务凭证或服务实例,如以下两个部分中的步骤中所示。

有关更多信息,请参阅 在 IBM Cloud 上创建和填充简单 IBM Cloudant 数据库 教程。 本教程说明如何使用旧凭证从 Python 应用程序使用 IBM Cloudant 服务实例。 请记住替换您创建的凭证。

(可选) 删除服务凭证

通过运行类似此命令的命令来删除名为 creds_for_cs20170517a 的凭证。

ibmcloud resource service-key-delete creds_for_cs20170517a

(可选) 删除服务实例

通过运行类似如下的命令,删除 IBM Cloudant 服务的 cs20170517a 实例。

ibmcloud resource service-instance-delete cs20170517a