管理者專用

熟悉 IBM® Storage Ceph® as a Service 的儲存設備和系統管理員可以輕鬆管理使用者、建立 API 金鑰，以及為使用者和服務授予角色。

設定您的儲存空間

首先，您需要至少有一個 IBM Storage Ceph as a Service 資源實例，以及一些用於儲存資料的儲存卷。 您要如何分段資料的存取權？ 您要資料實際位於哪裡？ 資料的存取頻率為何？

如需更多資訊，請參閱 IAM 概覽。

管理存取權

_服務憑證_是一組重要資訊，用於連線至 IBM® Storage Ceph® as a Service 的部署環境。 它會向使用者提供 IBM Storage Ceph as a Service 部署的識別碼（即「資源實例 ID」）、服務與授權端點，以及將主體與 API 金鑰關聯的方式（即「服務 ID」）。

管理員角色允許使用者根據指定的服務角色執行所有服務層級動作。 此角色允許您管理資料儲存的所有方面，例如針對磁碟區、主機和物件服務憑證建立、更新、刪除和檢視作業。 此角色不允許使用者修改部署。

管理員角色允許使用者查看部署是否存在、檢視現有憑證以及修改部署。 憑證建立後，便會與一個服務 ID 建立關聯。 此服務 ID 必須在部署中具備「管理員」角色，才能建立和刪除卷宗及主機。

如需進一步了解 IAM 角色與權限的相關資訊，請參閱 IBM Cloud 的 IAM 概覽。

建立部署

您可以透過使用者介面，或使用資源控制器 (RC) CLI 及 API 建立部署（也稱為服務實例）。

透過資源控制器 (RC) API 和 CLI，您可以使用輸入的「-parameters」標誌來設定和管理特定於服務的屬性，這是一種易變的屬性。

您必須具有管理員、操作員和編輯員角色才能建立部署。

若要建立部署，您必須準備好 Subscription Plan ID、Satallite CRN 和訂單 ID。 您可以從 Global 目錄 取得 Plan ID。 若要找出您的 Satellite CRN，請按一下漢堡功能表 > 資源清單 > Satellite 位置。

使用使用者介面建立部署

在成本估算和訂單處理啟動後，您就可以開始建立部署。

  1. 開啟來自 IBM 銷售合作夥伴的訂單狀態電子郵件，然後按一下連結「準備部署」。 登入後，連結會開啟部署儀表板，列出您正在進行或已完成的訂單。

  2. 在「準備部署」畫面中，選擇 IBM Cloud Satellite 位置和資源群組。

    這個 Satellite 位置需要出現在 IBM Cloud 上，而不需要在您的內部部署中使用主機，因為位置並不取決於主機和基礎結構中的其他設定。 若要建立新的內部部署類型位置，請開啟 Satellite 主控台。

    在建立 IBM Cloud Satellite 位置時，請選擇物件儲存標準方案，並確保選擇管理的區域為達拉斯或法蘭克福。 所選的區域必須最接近您的資料中心實體所在位置，以確保 Satellite 位置與 IBM Cloud 之間的低網路延遲。

  3. 輸入您的部署名稱，然後按一下「建立」。

    您的部署準備狀態顯示為已完成。

    內部硬體設定完成後，部署會顯示 Available 狀態和 ready-to-be-provisioned。

使用 CLI 建立部署

  1. 首先，請確定您具有 API 金鑰。 請從 IBM Cloud Identity and Access Management 取得它。

  2. 使用 CLI，登入 IBM Cloud Platform。 也可以將 API 金鑰儲存在檔案中，或將它設為環境變數。

    ibmcloud login --apikey <APIKEY>

  3. 接下來，透過指定部署名稱、訂閱計劃和 Satellite 詳細資訊，建立 IBM Storage Ceph as a Service 部署。 現在您已取得該執行個體的 CRN。

    ibmcloud resource service-instance-create <SERVICE_INSTANCE_NAME> software-defined-storage <PLAN_ID> satloc_dal_<SATELLITE_GUID> -p '{"satellite_crn":"<SATELLITE_CRN>","order_id":"<ORDER_ID>"}' -g Default

    請參閱範例。

    $ iibmcloud resource service-instance-create abcd-51150B3JN0 software-defined-storage 94f887fd-e984-4298-8efa-6ae7d3adc9d6 satloc_dal_cuvckfu20ia0nl71ndgg -p '{"satellite_crn":"crn:v1:staging:public:satellite:us-south:a/0b7bd21d002841be9c6a1936412394dd:cuvckfu20ia0nl71ndgg::","order_id":"51150B3JN0"}' -g Default
...
Creating service instance service-instance-cli in resource group resource-group-1 of account account-1 as user@company.com...
OK
Service instance service-instance-cli  was created.
Name:                   abcd-51150B3JN0
ID:                     crn:v1:staging:public:software-defined-storage:satloc_dal_cuvckfu20ia0nl71ndgg:a/0571b3a07aba4a7c8bb3ba1edaf93521:3764d865-75f6-4b8f-9c13-eeaf882b0705::
GUID:                   3764d865-75f6-4b8f-9c13-eeaf882b0705
Location:               satloc_dal_cuvckfu20ia0nl71ndgg
Service Name:           software-defined-storage
Service Plan Name:      capacity
Resource Group Name:    Default
State:                  provisioning
Type:                   service_instance
Sub Type:
Locked:                 false
One-time credentials:   false
Created at:             2025-02-28T10:52:41Z
Created by:             user@company.com
Updated at:             2025-02-28T10:52:51Z
Last Operation:
                        Status    create in progress
                        Message   Started create instance operation

    在建立實例時，狀態會顯示為佈建狀態。 等待狀態變更為 Active 狀態，才能開始使用磁碟區和主機操作。

建立新的實例時，如果遇到錯誤 No resource group targeted，表示預設資源群組不可用，必須明確設定資源群組。 使用 ibmcloud resource groups 可以找到可用資源群組清單，使用 ibmcloud target -g <resource-group> 可以設定目標。

使用 API 建立部署

若要建立部署，您需要使用使用者 ID 的 Bearer 令牌。

使用無主機或完整衛星位置作為部署的位置。

curl --location 'https://resource-controller.cloud.ibm.com/v2/resource_instances/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $IAM_TOKEN' \
--data '{
    "name": "test-maryam-27feb:2:29",
    "target": "satloc_dal_cspit2i20f0dosc3rn20",
    "resource_group": "e094c5810724956dc62890402dbbbe3d",
    "resource_plan_id": "34beb6d3-7afb-406c-9c75-6e2ab91e87ed",
    "parameters": {
        "satellite_crn" : "crn:v1:staging:public:satellite:us-south:a/3faf73b8d12b47fa6ce87494f8ae7686:cspit2i20f0dosc3rn20::",
        "order_id":"MVT-test-1"
    }
}'

成功回應類似下列內容：

{
    "id": "crn:v1:staging:public:software-defined-storage:satloc_dal_cspit2i20f0dosc3rn20:a/3faf73b8d12b47fa6ce87494f8ae7686:a8d1c2c0-de91-4c59-a983-9866d8cd5b2a::",
    "guid": "a8d1c2c0-de91-4c59-a983-9866d8cd5b2a",
    "url": "/v2/resource_instances/a8d1c2c0-de91-4c59-a983-9866d8cd5b2a",
    "created_at": "2025-02-28T12:59:29.736799693Z",
    "updated_at": "2025-02-28T12:59:40.705078066Z",
    "deleted_at": null,
    "created_by": "IBMid-6960008R79",
    "updated_by": "",
    "deleted_by": "",
    "scheduled_reclaim_at": null,
    "restored_at": null,
    "scheduled_reclaim_by": "",
    "restored_by": "",
    "name": "test-sample-28feb:6:29",
    "region_id": "satloc_dal_cspit2i20f0dosc3rn20",
    "account_id": "3faf73b8d12b47fa6ce87494f8ae7686",
    "reseller_channel_id": "",
    "resource_plan_id": "34beb6d3-7afb-406c-9c75-6e2ab91e87ed",
    "resource_group_id": "e094c5810724956dc62890402dbbbe3d",
    "resource_group_crn": "crn:v1:staging:public:resource-controller::a/3faf73b8d12b47fa6ce87494f8ae7686::resource-group:e094c5810724956dc62890402dbbbe3d",
    "target_crn": "crn:v1:staging:public:globalcatalog::a/3faf73b8d12b47fa6ce87494f8ae7686::deployment:satdep_cspit2i20f0dosc3rn20_sattmpl_34beb6d3-7afb-406c-9c75-6e2ab91e87ed%3Asatcon_dal13892",
    "parameters": {
        "order_id": "MVT-test-1",
        "satellite_crn": "crn:v1:staging:public:satellite:us-south:a/3faf73b8d12b47fa6ce87494f8ae7686:cspit2i20f0dosc3rn20::"
    },
    "allow_cleanup": false,
    "crn": "crn:v1:staging:public:software-defined-storage:satloc_dal_cspit2i20f0dosc3rn20:a/3faf73b8d12b47fa6ce87494f8ae7686:a8d1c2c0-de91-4c59-a983-9866d8cd5b2a::",
    "state": "provisioning",
    "type": "service_instance",
    "resource_id": "2bea02b0-c0a4-11ee-83aa-3171b0bf2976",
    "dashboard_url": "https://cloud.ibm.com/software-defined-storage/crn:v1:staging:public:software-defined-storage:satloc_dal_cspit2i20f0dosc3rn20:a%2F3faf73b8d12b47fa6ce87494f8ae7686:a8d1c2c0-de91-4c59-a983-9866d8cd5b2a::",
    "last_operation": {
        "type": "create",
        "state": "in progress",
        "async": true,
        "description": "Started create instance operation",
        "cancelable": false,
        "poll": false
    },
    "resource_aliases_url": "/v2/resource_instances/a8d1c2c0-de91-4c59-a983-9866d8cd5b2a/resource_aliases",
    "resource_bindings_url": "/v2/resource_instances/a8d1c2c0-de91-4c59-a983-9866d8cd5b2a/resource_bindings",
    "resource_keys_url": "/v2/resource_instances/a8d1c2c0-de91-4c59-a983-9866d8cd5b2a/resource_keys",
    "plan_history": [
        {
            "resource_plan_id": "34beb6d3-7afb-406c-9c75-6e2ab91e87ed",
            "start_date": "2025-02-28T12:59:29.736799693Z",
            "requestor_id": "IBMid-6960008R79"
        }
    ],
    "migrated": false,
    "extensions": {
        "allocate_burst_capacity": true,
        "available_burst_capacity": 60,
        "committed_capacity": 200,
        "quota": {
            "block": 130,
            "object": 130
        },
        "storage_type": "unified",
        "tenure": 0
    },
    "controlled_by": "",
    "locked": false,
    "onetime_credentials": false
}

在建立部署時，狀態顯示為 provisioning state。 等到狀態變更為 Active 狀態，才能開始使用磁碟區和主機操作。