新底层存储系统扩展软件

该页是面向底层存储扩展的开发者的。请浏览管理使用新底层存储系统扩展文档来获取使用已有扩展的指导。

底层存储扩展被构建为jar，并包含在一个特定的扩展位置，由Alluxio core提取。这一页描述了在Alluxio中的扩展如何工作的机制，并提供了开发底层存储扩展的详细说明。扩展提供了一个框架，使更多的存储库能够使用Alluxio，并使开发Alluxio不支持的模块变得方便。

工作原理

发现服务

扩展jar包在Alluxio server运行时动态加载，使得Alluxio能与新的底层存储扩展交互而不用重启。 Alluxio server使用Java ServiceLoader来发现底层存储API。 提供者要把alluxio.underfs.UnderFileSystemFactory的接口的实现包含在内。 实现的宣传方式是在META-INF/services中包含一个文本文件，其中只有一行指向实现该接口的类。

依赖管理

实现者需要将传递的依赖包含在扩展jar包内。Alluxio为每个扩展jar包实行独立的类加载来避免Alluxio server和扩展之间的冲突。

实现一个底层存储扩展

建立一个新的底层存储连接涉及:

• 实现所需的存储接口

• 声明服务实现

• 将实现和传递依赖打包到一个uber JAR中

参考的实现可以在alluxio-extensions找到。 本章剩余部分将介绍写一个新底层存储扩展的步骤。名为DummyUnderFileSystem的样例，使用maven作为build和依赖管理工具，并将所有操作转发到本地文件系统。

实现底层存储接口

HDFS Submodule和S3 Submodule是两个将存储系统对接Alluxio好的样例。

步骤1：实现接口UnderFileSystem

UnderFileSystem接口定义在模块org.alluxio:alluxio-core-common中。选择扩展BaseUnderFileSystem或ObjectUnderFileSystem来完成UnderFileSystem接口。 ObjectUnderFileSystem适合连接到对象存储，并将文件系统操作抽象为对象存储。

public class DummyUnderFileSystem extends BaseUnderFileSystem {
    // Implement filesystem operations
    ...
}

或是，

public class DummyUnderFileSystem extends ObjectUnderFileSystem {
    // Implement object store operations
    ...
}

步骤2：完成接口UnderFileSystemFactory

底层存储factory定义了UnderFileSystem实现支持的路径，以及如何创建UnderFileSystem实现。

public class DummyUnderFileSystemFactory implements UnderFileSystemFactory {
    ...
        @Override
        public UnderFileSystem create(String path, UnderFileSystemConfiguration conf) {
                // Create the under storage instance
        }
        @Override
    public boolean supportsPath(String path) {
        // Choose which schemes to support, e.g., dummy://
    }
}

声明该服务

在src/main/resources/META-INF/services/alluxio.underfs.UnderFileSystemFactory创建文件来告知ServiceLoader完成的UnderFileSystemFactory。

alluxio.underfs.dummy.DummyUnderFileSystemFactory

编译

使用maven-shade-plugin或maven-assembly将扩展工程的所有传递依赖包含在built jar中。 此外，为了避免冲突，指定依赖alluxio-core-common的范围为provided。maven定义像下面这样：

<dependencies>
    <!-- Core Alluxio dependencies -->
    <dependency>
      <groupId>org.alluxio</groupId>
      <artifactId>alluxio-core-common</artifactId>
      <scope>provided</scope>
    </dependency>
    ...
</dependencies>

测试

扩展AbstractUnderFileSystemContractTest来测试定义的UnderFileSystem符合Alluxio与底层存储模块的约定。 看下面的参考实现来将测试参数包含。

public final class DummyUnderFileSystemContractTest extends AbstractUnderFileSystemContractTest {
    ...
}

工作原理

服务发现

扩展JAR由Alluxio服务器在运行时动态加载，这使Alluxio能够无需重新启动就连接到新的底层存储。 Alluxio服务器使用Java ServiceLoader来发现底层存储API具体实现。提供程序包括 alluxio.underfs.UnderFileSystemFactory接口的具体实现。具体实现的发布是通过在META_INF/services中包含一个文本文件，文件中一行指向实现上述接口的类实现。

依赖关系管理

实现者需要在其扩展JAR中包括传递依赖。Alluxio会 为每个扩展JAR进行隔离的类加载，以避免Alluxio服务器与 扩展之间依赖关系冲突。

将你的底层Storage扩展贡献给Alluxio

恭喜你！你已经为Alluxio开发了新的底层存储扩展。通过向Alluxio代码库拉取请求即可让社区了解。