Para administradores

Os administradores de armazenamento e de sistema familiarizados com o site IBM® Storage Ceph® as a Service podem gerenciar facilmente os usuários, criar chaves de API e conceder funções a usuários e serviços.

Configuração de seu armazenamento

Primeiro, é necessário ter pelo menos uma instância do recurso “ IBM Storage Ceph as a Service ” e alguns volumes para armazenar os dados. Como deseja segmentar o acesso aos seus dados? Onde deseja que os dados residam fisicamente? Com que frequência os dados são acessados?

Para obter mais informações, consulte a visão geral do IAM.

Gerenciando o acesso

A credencial de serviço é um conjunto de informações importantes necessárias para se conectar a uma instância do IBM® Storage Ceph® as a Service. Ele fornece ao usuário um identificador para a implantação de um “ IBM Storage Ceph as a Service ” (ou seja, o ID da instância do recurso), pontos de extremidade de serviço e autorização, além de um meio de associar o sujeito a uma chave de API (ou seja, o ID do serviço).

A função Manager permite que os usuários executem todas as ações de nível de serviço com base na função de serviço atribuída. Essa função permite que você gerencie todos os aspectos do armazenamento de dados, como operações de criação, atualização, exclusão e visualização de volumes, hosts e credenciais de serviço de objeto. Essa função não permite que os usuários modifiquem as implementações.

A função de Administrador permite que o usuário veja que a implementação existe, visualize as credenciais existentes e modifique as implementações. Quando as credenciais são criadas, elas são associadas a um ID de serviço. Esse ID de serviço precisaria ter a função de Gerente na implantação para poder criar e excluir volumes e hosts.

Para obter mais informações sobre funções e permissões do IAM, consulte a visão geral do IAM em IBM Cloud.

Criando implementações

Você pode criar uma implementação (também chamada de instância de serviço) por meio da interface do usuário ou usando a CLI do controlador de recursos (RC) e a API.

Com a API e a CLI do controlador de recursos (RC), você pode definir e gerenciar os atributos específicos do serviço usando o sinalizador '-parameters' para entradas, que é um atributo volátil.

Você deve ter as funções de Administrador, Operador e Editor para criar a implantação.

Para criar uma implementação, você deve ter em mãos o ID do plano de assinatura, o CRN da Satallite e o ID do pedido. Você pode obter o ID do plano no catálogo Global. Para localizar seu CRN Satellite, clique no menu de hambúrguer > Lista de recursos > Localização Satellite.

Criação de implantações usando a interface do usuário

Você pode começar a criar uma implementação depois que a estimativa de custos e o processamento de pedidos forem iniciados.

  1. Abra o e-mail de status do pedido de seu parceiro de vendas IBM e clique no link Prepare deployment (Preparar implantação). Depois de fazer login, o link abre o painel de implantação, que lista seus pedidos em andamento ou concluídos.

  2. Na tela Prepare deployment (Preparar implantação), selecione o local IBM Cloud Satellite e o grupo de recursos.

    É necessário que esse local Satellite esteja presente em IBM Cloud sem um host para sua implementação local, pois o local não depende do host e de outras configurações em sua infraestrutura. Para criar um novo tipo de local no local, abra o console Satellite.

    Ao criar o local IBM Cloud Satellite, escolha o plano padrão de armazenamento Object e certifique-se de selecionar o Managed for region como Dallas ou Frankfurt. A região selecionada deve ser a mais próxima de onde seu data center reside fisicamente para garantir baixa latência de rede entre o local Satellite e IBM Cloud.

  3. Digite seu endereço Nome da implantação e clique em Criar.

    O status da preparação da implantação é exibido como Concluído.

    Depois que a configuração do hardware local for concluída, a implantação mostrará o status Disponível e pronto para ser provisionado.

Criação de implantações usando a CLI

  1. Primeiro, certifique-se de que tenha uma chave de API. Obtenha-a no IBM Cloud Identity and Access Management.

  2. Efetue login no IBM Cloud Platform usando a CLI. Também é possível armazenar a chave de API em um arquivo ou configurá-la como uma variável de ambiente.

    ibmcloud login --apikey <APIKEY>
    
  3. Em seguida, crie uma implantação do IBM Storage Ceph as a Service especificando o nome da implantação, o plano de assinatura e os detalhes do Satellite. Agora você tem um CRN para a instância.

    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
    

    Veja um exemplo.

    $ 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
    

    Durante a criação da instância, o status é exibido como estado de provisionamento. Aguarde até que o status mude para o estado Ativo para começar a usar o volume e as operações do host.

Ao criar uma nova instância, se você encontrar o erro No resource group targeted, isso indica que o grupo de recursos padrão não está disponível e que um grupo de recursos deve ser explicitamente definido. Uma lista de grupos de recursos disponíveis pode ser encontrada usando ibmcloud resource groups e o alvo pode ser definido com ibmcloud target -g <resource-group>.

Criação de implantações com a API

Para criar uma implementação, você precisa do token do portador do ID de usuário usado.

Use um local de satélite completo ou sem host como local para a implementação.

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"
    }
}'

Uma resposta bem-sucedida é semelhante a esta:

{
    "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
}

Durante a criação da implantação, o status é exibido como provisioning state. Aguarde até que o status mude para o estado Active para começar a usar o volume e as operações do host.