使用 CLI 创建实例
本教程说明如何在 IBM Cloud® 上创建 IBM® Cloudant® for IBM Cloud® 服务实例 使用IBM Cloud。CLI。
目标
- 使用 IBM Cloud 帐户来创建 IBM Cloudant 服务实例和凭证。
- 检索并使用 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)命令。
-
使用以下命令启动IBM Cloud账户的登录流程。
ibmcloud login
IBM Cloud会做出响应,提醒您当前的 API 端点,并询问您账户的电子邮件地址。
API endpoint: https://cloud.ibm.com Region: au-syd Email> Password>
-
输入账户的电子邮件地址,然后输入密码。
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
-
您现在已登录到 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
的服务实例。
-
使用以下格式设置目标资源组和区域。 要运行此命令,您需要了解在以下步骤中找到的区域和资源组。
有关更多信息,请参阅
ibmcloud target
下的 常规 CLI(ibmcloud)命令。ibmcloud target [-r REGION_NAME] [-g RESOURCE_GROUP]
-
要查看区域列表,请运行以下命令。
ibmcloud regions
-
要查看资源组列表,请运行以下命令。
ibmcloud resource groups
-
使用 "
Lite
计划创建IBM Cloudant服务实例。
实例名称在美国南部位置为cs20170517a
,并且仅使用 IAM 凭证。ibmcloud resource service-instance-create cs20170517a cloudantnosqldb lite us-south -p '{"legacyCredentials": false}'
-
创建服务实例后,请参阅以下示例消息。
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
实例创建凭证。
-
通过运行以下命令,为 IBM Cloudant 服务的
cs20170517a
实例创建凭证 (其中凭证的名称为creds_for_cs20170517a
)。ibmcloud resource service-key-create creds_for_cs20170517a Manager --instance-name cs20170517a
-
接收到为服务实例创建凭证的请求后,请查看来自 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 服务的服务凭证
-
检索 IBM Cloudant 服务的
cs20170517a
实例的凭证。 凭证的名称为creds_for_cs20170517a
。ibmcloud resource service-key creds_for_cs20170517b
-
接收到检索服务实例凭证的请求后,请查看来自 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