Skip to content

Qiniu kodo#2

Open
SunRunAway wants to merge 44 commits into
masterfrom
qiniu_kodo
Open

Qiniu kodo#2
SunRunAway wants to merge 44 commits into
masterfrom
qiniu_kodo

Conversation

@SunRunAway

Copy link
Copy Markdown
Collaborator

No description provided.

Comment thread conf/alluxio-site.properties.kodoall Outdated
@@ -0,0 +1,10 @@
alluxio.master.hostname=localhost

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个不要进 PR

import java.util.function.Supplier;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个里面的空行去掉不合理

public static final String UNDERFS_S3_UPLOAD_THREADS_MAX =
"alluxio.underfs.s3.upload.threads.max";
public static final String UNDERFS_KODO_CONNECT_TIMEOUT = "alluxio.underfs.kodo.connect.timeout";
public static final String UNDERFS_KODO_REQUESTS_MAX = "alluxio.undergs.kodo.requests.max";

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

拼写错误, undergs -> underfs

Comment thread underfs/kodo/kodo.md Outdated
@@ -0,0 +1,97 @@
---
layout: global
title: 在KODO上配置Alluxio

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

文档里面好像有些地方英文单词有空格 有些又没有?

Comment thread underfs/kodo/kodo.md Outdated

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

另外,为了在 KODO 上使用 Alluxio,需要创建一个bucket(或者使用一个已有的bucket)。还要注意在该bucket里使用的目录,可以在该bucket中新建一个目录,或者使用一个存在的目录。在该指南中,Kodo bucket的名称为KODO_BUCKET,在该 bucket 里的目录名称为 KODO_DIRECTORY。要使用七牛对象存储服务,需要提供一个可供识别指定 bucket 的域名,本向导中为 KODO_Source_Host。

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

KODO_Source_Host KODO_DIRECTORY 这个命名规则好像不一致?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

第12行,建议添加括号:七牛云对象存储(Kodo)

try {
return new KodoInputStream(key, mKodoClinet, options.getOffset());
} catch (Exception e) {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

空行

final private String mprefix;
private FileListing mResult;


Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

空行冗余



private final class KodoObjectListingChunk implements ObjectListingChunk {
final int mlimit;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

命名不是驼峰?


@Override
public ObjectStatus[] getObjectStatuses() {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

空行

request.setPrefix(key);
request.setMaxKeys(getListingChunkLength());
request.setDelimiter(delimiter);

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

不要动其他厂商的代码吧

litianqi and others added 7 commits October 7, 2018 21:03
fllow maven check Style
* 'master' of github.com:litianqi1996/alluxio: (41 commits)
  Update Configuring-Alluxio-with-OBS.md
  [ALLUXIO-3333]Support cluster startup monitoring for job service (Alluxio#7915)
  fixDuplicate (Alluxio#7914)
  [ALLUXIO-3327] Initial implementation of job management service (Alluxio#7910)
  Bump released version to 1.8.1 (Alluxio#7911)
  [ALLUXIO-2231] support allow_other/allow_root Fuse mount options (Alluxio#7900)
  Use cached threadpools for masters (Alluxio#7908)
  Clean up some error messages. (Alluxio#7902)
  Improvements to invokeAll (Alluxio#7883)
  [ALLUXIO-3307] set ufs ACL on the createFile path (Alluxio#7844)
  Remove synchronize on remove user. (Alluxio#7896)
  [SMALLFIX] Add checkstyle rule for whitespace at end of block (Alluxio#7876)
  [ALLUXIO-2919] Improve javadoc for DynamicResourcePool#acquire (Alluxio#7886)
  [ALLUXIO-3323] - InstancedConfiguration.isSet should lookup keys recursively. (Alluxio#7870)
  Improve logging when failing to add concurrently created inode (Alluxio#7872)
  [SMALLFIX] Handle Zookeeper authorities in uri check (Alluxio#7871)
  Return a Pair object of nulls instead of null in getAclPair implementations. (Alluxio#7868)
  [SMALLFIX] Allow + as a uri authority address delimiter (Alluxio#7850)
  change the return value from null to a pair of nulls so that we can (Alluxio#7861)
  Avoid re-formatting journal on Mesos master executor start (Alluxio#7839)
  ...

# Conflicts:
#	core/common/src/main/java/alluxio/PropertyKey.java

@Boxie5 Boxie5 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

先到这吧 后面继续看。

Comment thread underfs/kodo/kodo-en.md Outdated
Also, in preparation for using Kodo with alluxio, create a bucket or use an existing bucket. You
should also note the directory you want to use in that bucket, either by creating a new
directory in the bucket, or using an existing one. For the purposes of this guide, the Kodo bucket
name is called `KODO_BUCKET`, and the directory in that bucket is called `KODO_DIRECTORY`. To use the seven cattle object storage service, we need to provide a domain name to identify the specified bucket,for name is called `KODO_DOWNLOAD_HOST` .Also, for

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

咦 怎么出现了 seven cattle?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

specified bucket,

后面缺少空格

`KODO_DOWNLOAD_HOST` .

这个地方也缺少空格

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for using the Qiniu Service

改成

in order to use Qiniu Kodo Service

?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

range 应该是指 zone/region 吧?

Comment thread underfs/kodo/kodo-en.md Outdated
alluxio.underfs.address=kodo://<KODO_BUCKET>/<KODO_DIRECTORY>/
```

Next you need to specify for Kodo access. In `conf/alluxio-site.properties`,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

specify for Kodo access

改为

specify following settings to access your bucket

如何?

Comment thread underfs/kodo/kodo-en.md Outdated

```

fs.kodo.AccessKey=<KODO_ACCESS_KEY>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fs.kodo.xxx 的配置里面不应该有大写的

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

下同

Comment thread underfs/kodo/kodo-en.md
@@ -0,0 +1,119 @@
---

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

看上来这个文档里面有不少地方做了强制换行,这个是 alluxio 文档里面通行的做法吗?

Comment thread underfs/kodo/kodo-en.md Outdated

```

Here `fs.kodo.AccessKey ` and `fs.kodo.SecretKey` is the Access

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

用了云对象存储的用户应该都知道 access key / secret key 是干嘛的吧,这个地方直接改成

You can get your AccessKey/SecretKey in Qiniu Console - AccessKeys

另外,如果使用原来的介绍方式的话,应该是 are **** strings,而不是 is *** string

Comment thread underfs/kodo/kodo-en.md Outdated
`fs.kodo.DownloadHost` can be found in [Qiniu Kodo](https://portal.qiniu.com/bucket)
according to this [order](https://mars-assets.qnssl.com/alluxio_host.png)

`fs.kodo.EndPoint` is the endpoint of this bucket, which can be found in the Bucket in this table

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fs.kodo.EndPoint is the endpoint of this bucket, which can be found in the Bucket in this table

改成

fs.kodo.EndPoint is the endpoint of this bucket, according to the following table

如何?

Comment thread underfs/kodo/kodo-en.md Outdated
```

After this succeeds, you can visit your Kodo directory `KODO://<KODO_BUCKET>/<KODO_DIRECTORY>` to verify the files
and directories created by Alluxio exist. For this test, you should see files named like

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

by Alluxio exist

这个是指?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

created改成mounted可能好理解一点

Comment thread underfs/kodo/kodo-en.md Outdated
--option fs.kodo.SecretKey=<KODO_SECRET_KET> \
--option fs.kodo.DownloadHost=<KODO_DOWNLOAD_HOST> \
--option fs.kodo.EndPoint=<KODO_ENDPOINT> \
kodo://<KODO_BUCKET>/<KODO_DIRECTORY>//

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

好像少了 AlluxioURI

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

大概是缺转义字符?是不是少了空格?

Comment thread underfs/kodo/kodo-zh.md Outdated

## 初始步骤

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个读起来有点像外国人翻译出来的汉语?[捂脸]

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。

这个句子读着不太像中国人写的。没必要因为其他厂家用这样蹩脚的语言,我们就也跟着用。

Comment thread underfs/kodo/kodo-zh.md Outdated
要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

另外,为了在 KODO 上使用 Alluxio,需要创建一个bucket(或者使用一个已有的bucket)。还要注意在该 bucket 里使用的目录,可以在该bucket中新建一个目录,或者使用一个存在的目录。在该指南中,Kodo bucket的名称为KODO_BUCKET,在该 bucket 里的目录名称为 KODO_DIRECTORY。要使用七牛对象存储服务,需要提供一个可供识别指定 bucket 的域名,本向导中为 KODO_DOWNLOAD_HOST。
除此之外,还需提供一个 KODO 端点,该端点指定了你的 bucket 在哪个范围,本向导中的端点名为 KODO_ENDPOINT。

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

endpoint 不用翻译吧?端点这个说法感觉并不传意

Comment thread underfs/kodo/kodo-zh.md Outdated

## 安装Kodo

Alluxio通过[统一命名空间](Unified-and-Transparent-Namespace.html)统一访问不同存储系统。 Kodo的安装位置可以在Alluxio命名空间的根目录或嵌套目录下。

@Boxie5 Boxie5 Oct 9, 2018

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

安装位置是否叫挂载点更好?

Comment thread underfs/kodo/kodo-zh.md Outdated

此处, `fs.kodo.AccessKey `和`fs.kodo.SecretKey`分别为`Access Key`字符串和`Secret Key`字符串,均受七牛云[密钥管理界面](https://portal.qiniu.com/user/key)管理;

`fs.kodo.DownloadHost` 可以在[七牛云对象存储管理平台](https://portal.qiniu.com/bucket) 中的空间概览中获取[访问测试域名](https://mars-assets.qnssl.com/alluxio_host.png)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个,标点符号好像有点乱?

Comment thread underfs/kodo/kodo-zh.md Outdated
--option fs.kodo.secretkey=<KODO_SECRET_KEY> \
--option fs.kodo.downloadhost=<KODO_DOWNLOAD_HOST> \
--option fs.kodo.endpoint=<KODO_ENDPOINT> \
/kodo /kodo://<KODO_BUCKET>/<KODO_DIRECTORY>/

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/kodo /kodo://<KODO_BUCKET>/<KODO_DIRECTORY>/ 多了一个斜杠,应该是
/kodo kodo://<KODO_BUCKET>/<KODO_DIRECTORY>/

Comment thread underfs/kodo/kodo-en.md Outdated
or [download the precompiled binaries directly](Running-Alluxio-Locally.html).

Also, in preparation for using Kodo with alluxio, create a bucket or use an existing bucket. You
should also note the directory you want to use in that bucket. For the purposes of this guide, the Kodo bucket

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You should also note the directory you want to use in that bucket. 这句好像中间少了个谓语,读上去更顺一点。You should also note the directory you want to use is existed in that bucket.

Comment thread underfs/kodo/kodo-en.md Outdated
```

After this succeeds, you can visit your Kodo directory `KODO://<KODO_BUCKET>/<KODO_DIRECTORY>` to verify the files
and directories created by Alluxio exist. For this test, you should see files named like

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

created改成mounted可能好理解一点

Comment thread underfs/kodo/kodo-en.md Outdated
[compile the binaries from Alluxio source code](Building-Alluxio-From-Source.html),
or [download the precompiled binaries directly](Running-Alluxio-Locally.html).

Also, in preparation for using Kodo with alluxio, create a bucket or use an existing bucket. You

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

句子开头的Also是不是可以考虑去掉,用来做连接的话感觉没有太大作用

Comment thread underfs/kodo/kodo-zh.md Outdated

## 初始步骤

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

第16行,建议“许多”改为“多台”;“你”改为“用户”;“【编译Alluxio】”改为“【由Alluxio源码编译二进制包】”;“【下载二进制包】”改为“【直接下载预编译过的二进制包】”;

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

可以 是比较生硬

Comment thread underfs/kodo/kodo-zh.md Outdated

另外,为了在 Kodo 上使用 Alluxio,需要创建一个 bucket(或者使用一个已有的 bucket )。在该指南中,Kodo bucket 的名称为KODO_BUCKET,在该 bucket 里的目录名称为 KODO_DIRECTORY
。要使用七牛对象存储服务,需要提供一个可供识别指定 bucket 的域名,本向导中为KODO_DOWNLOAD_HOST。
除此之外,还需提供一个 Kodo 端点域名,该端点指定了你的 bucket 所在存储区域的访问域名,本向导中的端点域名称为 KODO_ENDPOINT。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感觉endpoint不用翻译啊

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

endppoint 不翻译的话 后面出现比较突兀
如果都觉得不太好的话 我这边去掉吧

Comment thread underfs/kodo/kodo-zh.md Outdated

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

另外,为了在 Kodo 上使用 Alluxio,需要创建一个 bucket(或者使用一个已有的 bucket )。在该指南中,Kodo bucket 的名称为KODO_BUCKET,在该 bucket 里的目录名称为 KODO_DIRECTORY

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

建议在第18行第一个分句后,加上对目录的说明

Comment thread underfs/kodo/kodo-zh.md Outdated

`fs.kodo.downloadhost` 可以在[七牛云对象存储管理平台](https://portal.qiniu.com/bucket) 中的空间概览中获取[访问域名](https://mars-assets.qnssl.com/alluxio_host.png)

`fs.kodo.endpoint` 是七牛云存储源站的端点域名配置 可以根据存储空间所在存储区域进行配置

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

endpoint,同上

delete introduce endpoint
Comment thread underfs/kodo/kodo-zh.md Outdated

## 初始步骤

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。你可以自己[编译Alluxio](Building-Alluxio-From-Source.html),或者[下载二进制包](Running-Alluxio-Locally.html)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

要在许多机器上运行 Alluxio 集群,需要在这些机器上部署二进制包。

这个句子读着不太像中国人写的。没必要因为其他厂家用这样蹩脚的语言,我们就也跟着用。

Comment thread underfs/kodo/kodo-zh.md Outdated

`fs.kodo.downloadhost` 可以在[七牛云对象存储管理平台](https://portal.qiniu.com/bucket) 中的空间概览中获取[访问域名](https://mars-assets.qnssl.com/alluxio_host.png)

`fs.kodo.endpoint` 是七牛云存储源站的端点域名配置 可以根据存储空间所在存储区域进行配置

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

空格处需要逗号,结尾处需要加冒号

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants