使用Rest api管理Ceph网关

背景

　　开发基于Ceph RadosGW的微服务，需要实现调用方可以通过rest api就能创建用户，获取用户信息等功能。

实现

　　Ceph的RadosGW自身就有该功能，这些创建用户、获取用户信息、获取使用情况等的功能被称为Admin Operation(管理操作)。我们直接通过RadosGW的URL再加上/admin就可以访问执行管理操作了，比如RadosGW的URL为http://192.168.1.2:8080，那么管理操作的URL就是http://192.168.1.2:8080/admin。

　　管理操作的授权和S3的授权机制一样，只是创建S3用户之后，需要再给响应的用户附上管理权限。如下，我们会创建一个有管理权限的用户。

　　在Ceph集群中执行以下语句(当然，你可以换上你需要的用户名和key)：

$ sudo radosgw-admin user create --uid="my_s3_user" --display-name="my_user_display_name" --access-key="my_admin_access_key" --secret-key="my_admin_secret_key"
$ sudo radosgw-admin --id admin caps add --caps="buckets=*;users=*;usage=*;metadata=*" --uid="my_s3_user"

　　如上，便创建了一个拥有管理权限的用户，接下来就可以使用官网提供的api(点击浏览)来使用了。

　　另外，如果不想直接使用Rest api，也可以使用一些封装好的第三方库。这里，介绍一个Java的第三方库(点击浏览)，也正是我现在正使用的一个库。

　　以下的示例代码，创建了一个S3用户，获取了S3证书，并设置了配额。

    private static void testRadosAdmin() {
        String accessKey = "my_admin_access_key";
        String secretKey = "my_admin_secret_key";
        String adminEndpoint = "http://109.105.115.102:7480/admin";
        RgwAdmin rgwAdmin = new RgwAdminBuilder().accessKey(accessKey).secretKey(secretKey).endpoint(adminEndpoint)
                .build();

        String userId = "8eeb3bb0-eda0-48f9-a18f-c04daecb5e69";
        User user = null;
        // create a user
        user = rgwAdmin.createUser(userId);
        if (user != null) {
            // get user S3Credential
            for (S3Credential credential : user.getS3Credentials()) {
                System.out.println("userid: " + credential.getUserId() + ",getAccessKey: " + credential.getAccessKey()
                        + ", getSecretKey: " + credential.getSecretKey());
            }

            // set user quota, such as maxObjects and maxSize(KB)
            rgwAdmin.setUserQuota(userId, 1000, 1024 * 1024 * 5);

            Optional<Quota> quota = rgwAdmin.getUserQuota(userId);
            if (quota.isPresent()) {
                System.out.println("quota KB: " + quota.get().getMaxSizeKb());
            }
        } else {
            System.out.println("create user failed");
        }
    }