> For the complete documentation index, see [llms.txt](https://documentation.alluxio.io/os-cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.alluxio.io/os-cn/ufs/cephobjectstorage.md). # 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](/os-cn/contributor/building-alluxio-from-source.md)，或者[下载二进制包](/os-cn/deploy/running-alluxio-locally.md) ## 配置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)获得更多信息。