Ceph分布式存储实践应用之Ceph Swift生产实践运用

Posted mirson

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Ceph分布式存储实践应用之Ceph Swift生产实践运用相关的知识，希望对你有一定的参考价值。

1. Ceph封装与自动化装配

  1. 创建ceph-starter自动化工程：

    创建一个spring boot工程，作为一个公用组件。

  2. pom文件依赖：

    <dependencies>
        <!-- Spring Boot 自定义启动器的依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-actuator-autoconfigure</artifactId>
        </dependency>
        <!-- ceph 依赖 -->
        <dependency>
            <groupId>com.ceph</groupId>
            <artifactId>rados</artifactId>
            <version>0.6.0</version>
        </dependency>

        <!-- ceph fs 操作依赖 -->
        <dependency>
            <groupId>com.ceph</groupId>
            <artifactId>libcephfs</artifactId>
            <version>0.80.5</version>
        </dependency>

        <!-- ceph swift 依赖 -->
        <dependency>
            <groupId>org.javaswift</groupId>
            <artifactId>joss</artifactId>
            <version>0.10.2</version>
        </dependency>
    </dependencies>

    直接采用目前的最新版， 加入Ceph相关的三个依赖。

  3. 代码实现

    封装Ceph操作接口， CephSwiftOperator类：

    public class CephSwiftOperator {

    private static final Logger log = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

    /**
     * 用户名
     */
    private String username;   
    /**
     * 密码
     */
    private String password;

    /**
     * 认证接入地址
     */
    private String authUrl;

    /**
     * 默认容器名称
     */
    private String defaultContainerName;

    /**
     * Ceph账户对象
     */
    private Account account;

    /**
     * Ceph容器对象
     */
    private Container container;   

    public CephSwiftOperator(String username, String password, String authUrl, String defaultContainerName) {
        // 初始化配置信息
        this.username = username;
        this.password = password;
        this.authUrl = authUrl;
        this.defaultContainerName = defaultContainerName;
        init();   
    }

    /**
     * 初始化建立连接
     */
    public void init() {
        try {
            // Ceph用户认证配置
            AccountConfig config = new AccountConfig();
            config.setUsername(username);
            config.setPassword(password);
            config.setAuthUrl(authUrl);
            config.setAuthenticationMethod(AuthenticationMethod.BASIC);
            account = new AccountFactory(config).createAccount();
            // 获取容器
            Container newContainer = account.getContainer(defaultContainerName);
            if (!newContainer.exists()) {
                container = newContainer.create();
                log.info("account container create ==> " + defaultContainerName);
            } else {
                container = newContainer;
                log.info("account container exists!  ==> " + defaultContainerName);
            }
        }catch(Exception e) {
            // 做异常捕获, 避免服务不能正常启动
            log.error("Ceph连接初始化异常： " + e.getMessage());
        }
    }   

    /**
     * 上传对象
     * @param remoteName
     * @param filepath
     */
    public void createObject(String remoteName, String filepath) {
        StoredObject object = container.getObject(remoteName);
        object.uploadObject(new File(filepath));
    }

    /**
     * 上传文件对象（字节数组形式）
     * @param remoteName
     * @param inputStream
     */
    public void createObject(String remoteName, byte[] inputStream) {
        StoredObject object = container.getObject(remoteName);
        object.uploadObject(inputStream);
    }

    /**
     * 获取指定对象
     * @param containerName
     * @param objectName
     * @param outpath
     */
    public void  retrieveObject(String objectName,String outpath){
        StoredObject object = container.getObject(objectName);
        object.downloadObject(new File(outpath));
    }
   /**
     * 下载文件， 转为文件流形式
     * @param objectName
     * @return
     */
    public InputStream retrieveObject(String objectName){
        StoredObject object = container.getObject(objectName);
        return object.downloadObjectAsInputStream();
    }
   
    /**
     * 删除指定文件对象
     * @param containerName
     * @param objectName
     * @return
     */
    public boolean deleteObject(String objectName){
        try {
            StoredObject object = container.getObject(objectName);
            object.delete();
            return !object.exists();
        }catch(Exception e) {
            log.error("Ceph删除文件失败: " + e.getMessage());
        }
        return false;
    }

    /**
     * 获取所有容器
     * @return
     */
    public List listContainer() {
        List list = new ArrayList();
        Collection<Container> containers = account.list();
        for (Container currentContainer : containers) {
            list.add(currentContainer.getName());
            System.out.println(currentContainer.getName());

        }
        return list;
    }   
}
    • 此封装接口将纳入Spring 容器管理， 即为单例， 构造函数会初始化Ceph认证连接等信息
    • 将Account 与Container 设为成员变量， 便于复用， 减少开销。
    • 初始化会默认一个容器名称， 一般每个服务设置一个容器名称， 如果业务功能比较庞杂， 可以每个业务模块设置一个容器。
    • Swift Api已经做了较完善的封装， 我们内部使用比较简单， 主要封装上传和下载接口， 为便于调用处理， 做了进一步封装。

    AutoCephSwiftConfiguration自动化配置类：

    @Configuration
@EnableAutoConfiguration
@ConditionalOnProperty(name = "ceph.authUrl")
public class AutoCephSwiftConfiguration {   
    @Value("${ceph.username}")
    private String username;
    @Value("${ceph.password}")
    private String password;
    @Value("${ceph.authUrl}")
    private String authUrl;
    @Value("${ceph.defaultContainerName}")
    private String defaultContainerName;  
    @Bean
    public CephSwiftOperator cephSwiftOperator() {
        return new CephSwiftOperator(username, password, authUrl, defaultContainerName);
    }

}

    ConditionalOnProperty根据ceph.authUrl属性来决定是否加载配置，如果配置文件中没有设置Ceph相关属性， 即使maven中引用， 启动也不会报错。 该自动化配置， 负责初始化一个Ceph Swift 接口操作实例。

  4. 自动化配置：

    要让自定义Ceph Starter真正生效， 必须遵循Spring boot 的SPI扩展机制， 在resources环境中, META-INF目录下， 创建spring.factories文件:

    # Auto Configure
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\\
com.ceph.starter.AutoCephSwiftConfiguration

    指定我们上面所写的自动化配置类。

2. 创建用户管理工程

  1. 工程配置
    application.yml

    server:
  port: 10692
spring:
  application:
    name: user-manager
  # 模板配置
  thymeleaf:
    prefix: classpath:/templates/
    suffix: .html
    mode: HTML
    encoding: utf-8
    servlet:
      content-type: text/html

  # 文件上传大小限制
  servlet:
    multipart:
      max-file-size: 100MB
      max-request-size: 100MB

# ceph swift 认证信息配置
ceph:
  username: cephtester:subtester
  password: 654321
  authUrl: http://10.10.20.11:7480/auth/1.0
  defaultContainerName: user_datainfo

  2. POM依赖配置：

       <dependencies>
       <!-- spring boot 依赖 -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>   
       <!-- Spring boot thymeleaf 模板依赖 -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-thymeleaf</artifactId>
       </dependency>   
       <!-- Ceph 自动化封装组件 -->
       <dependency>
           <groupId>com.itcast.ceph</groupId>
           <artifactId>ceph-starter</artifactId>
           <version>1.0-SNAPSHOT</version>
       </dependency>   
   </dependencies>

    加入Ceph 自动化封装组件配置依赖。

3. Ceph文件上传实现

  1. 实现文件上传接口：

    /**
 * 上传用户文件
 * @return
 */
public String uploadUserFile(MultipartFile file) throws Exception {

    // 获取唯一文件ID标识
    String remoteFileId = globalIDGenerator.nextStrId();

    // 上传文件至CEPH
    cephSwiftOperator.createObject(remoteFileId, file.getBytes());

    return remoteFileId;
}

  2. Controller层实现：

    在UserManagerController下面， 增加上传接口：

    /**
 * 用户文件上传
 * @param file
 * @return
 */
@PostMapping("/upload")
@ResponseBody
public String upload(@RequestParam("file") MultipartFile file) {
    String  result = null;
    try {
        // 通过Ceph Swift上传文件
        String userFileId = userManagerService.uploadUserFile(file);
        result = "上传的文件ID: " + userFileId;
    }catch(Exception e) {
        log.error(e.getMessage(), e);
        result = "出现异常：" + e.getMessage();
    }
    return result;
}

    通过Spring boot实现文件上传， 注意以表单form形式提交， 类型为multipart/form-data， 参数名为file， 非直接数据流方式上传， 不然服务不能正常识别接收文件。

4. Ceph文件下载实现

新增一个接口， 根据上传的文件ID标识下载文件。

  1. Service层：

    实现下载用户文件接口：

    /**
 * 下载用户文件
 * @param fileId
 * @return
 * @throws Exception
 */
public InputStream downloadUserFile(String fileId) throws Exception {
    return cephSwiftOperator.retrieveObject(fileId);
}

  2. Controller层：

    /**
 * 根据文件ID下载用户文件信息
 * @param filename
 * @return
 */
@RequestMapping(value = "/download")
public String downloadFile(@NotBlank(message = "文件ID不能为空!") String filename, HttpServletResponse response){   
    String result = null;   
    // 文件流缓存
    BufferedInputStream bis = null;
    // 文件输出流
    OutputStream os = null;
    try {
        // 1. 从Ceph服务器上获取文件流
        InputStream inputStream = userManagerService.downloadUserFile(filename);
        // 2.设置强制下载, 不直接打开
        response.setContentType("application/x-msdownload");
        // 3. 设置下载的文件名称
        response.addHeader("Content-disposition", "attachment; fileName=" + filename);
        // 4. 输出文件流
        byte[] buffer = new byte[1024];
        bis = new BufferedInputStream(inputStream);
        os = response.getOutputStream();
        int i = bis.read(buffer);
        while(i != -1) {
            os.write(buffer, 0, i);
            i = bis.read(buffer);
        }
        os.flush();
        return null;
    }catch(Exception e) {
        log.error(e.getMessage(), e);
        result = "出现异常：" + e.getMessage();
    }finally {
        // 最后, 要记住关闭文件流
        if(bis != null ) {
            try {
                bis.close();
            } catch (IOException e) {
                log.error(e.getMessage(), e);
            }
        }
    }   
    return result;

}

5. 功能验证

  1. 访问上传页面

    地址： http://127.0.0.1:10692/user/file

     ![file](/img/bVcQ8Xw)

  2. 上传成功后， 会返回文件ID：

     ![file](/img/bVcQ8Xx)

  3. 下载文件：

    输入文件ID进行下载：

     ![file](/img/bVcQ8Xy)

本文由mirson创作分享，如需进一步交流，请加QQ群：19310171或访问www.softart.cn

以上是关于Ceph分布式存储实践应用之Ceph Swift生产实践运用的主要内容，如果未能解决你的问题，请参考以下文章

Ceph分布式存储实践应用之集群测试验证（Rados运用）

Ceph分布式radosgw对象存储融合Swift S3的访问应用

滴滴Ceph分布式存储系统优化之锁优化

云原生之存储实战部署Ceph分布式存储集群

ceph 之 crush存储规则理解

ceph在品高云中的实践