# Alluxio集成Ceph Object Storage作为底层存储 该指南介绍如何配置Alluxio以使用Ceph Object Storage作为底层文件系统。Alluxio使用[Rados Gateway](http://docs.ceph.com/docs/master/radosgw/) 支持两种不同的客户端API连接[Ceph Object Storage](http://ceph.com/ceph-storage/object-storage/)： * [S3](http://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html) (推荐使用) * [Swift](http://docs.openstack.org/developer/swift/) ## 初始步骤 首先，在你的机器上必须安装Alluxio二进制包。你可以自己[编译Alluxio](https://documentation.alluxio.io/os-cn/contributor/building-alluxio-from-source)，或者[下载二进制包](https://documentation.alluxio.io/os-cn/deploy/running-alluxio-locally) ## 配置Alluxio 为了配置Alluxio以使用底层文件系统，需要修改`alluxio-site.properties`文件。如果该文件不存在，根据模板创建配置文件。 ```console $ cp conf/alluxio-site.properties.template conf/alluxio-site.properties ``` ### 方法1: S3接口 向`conf/alluxio-site.properties`文件添加以下代码： ``` alluxio.master.mount.table.root.ufs=s3:/// s3a.accessKeyId= s3a.secretKey= alluxio.underfs.s3.endpoint=http://: alluxio.underfs.s3.disable.dns.buckets=true alluxio.underfs.s3.inherit.acl= ``` 如果使用Ceph的版本，比如hammer(或者更老的版本)，指定`alluxio.underfs.s3.signer.algorithm=S3SignerType`来使用v2版本的S3签名。 为了使用v1版本的GET Bucket(列出对象)，指定`alluxio.underfs.s3.list.objects.v1=true`。 ### 方法2: Swift接口 向`conf/alluxio-env.sh`文件添加以下代码： ``` alluxio.master.mount.table.root.ufs=swift:// ``` 其中，``是一个已经存在的Swift容器。 以下的配置需要配置在`conf/alluxio-site.properties`中 ``` fs.swift.user= fs.swift.tenant= fs.swift.password= fs.swift.auth.url= fs.swift.auth.method= ``` ``可能的值为`true`，`false`。如果使用本地的Ceph RGW认证，指定``为`swiftauth`。指定 ``为`http://:8090/auth/1.0` ## 使用Ceph本地运行Alluxio 完成所有的配置之后，你可以本地运行Alluxio,观察是否一切运行正常。 ``` ./bin/alluxio format ./bin/alluxio-start.sh local ``` 该命令应当会启动一个Alluxio master和一个Alluxio worker，可以在浏览器中访问查看master Web UI。 接着，你可以运行一个简单的示例程序： ``` ./bin/alluxio runTests ``` 运行成功后，访问你的bucket/container目录，确认其中包含了由Alluxio创建的文件和目录。 如果使用S3连接器，创建的文件名称应像下面这样： ``` S3_BUCKET/S3_DIRECTORY/alluxio/data/default_tests_files/Basic_CACHE_THROUGH ``` 如果使用Swift连接器，创建的文件名称应像下面这样： ``` swift:///alluxio/data/default_tests_files/Basic_CACHE_THROUGH ``` ## 访问控制 如果Alluxio安全认证被启用，Alluxio将会遵循底层Ceph对象存储的访问权限控制，根据使用的接口，参考[S3 Access Control](https://github.com/Alluxio/documentation/blob/main/docs/cn/ufs/Configuring-Alluxio-with-S3.html#s3-access-control) 或者[Swift Access Control](https://github.com/Alluxio/documentation/blob/main/docs/cn/ufs/Configuring-Alluxio-with-Swift.html#swift-access-control)获得更多信息。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://documentation.alluxio.io/os-cn/ufs/cephobjectstorage.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.