You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by GitBox <gi...@apache.org> on 2020/08/18 07:38:44 UTC
[GitHub] [flink] wbgentleman opened a new pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
wbgentleman opened a new pull request #13188:
URL: https://github.com/apache/flink/pull/13188
Signed-off-by: 313773543 <31...@qq.com>
<!--
*Thank you very much for contributing to Apache Flink - we are happy that you want to help us improve Flink. To help the community review your contribution in the best possible way, please go through the checklist below, which will get the contribution into a shape in which it can be best reviewed.*
*Please understand that we do not do this to make contributions to Flink a hassle. In order to uphold a high standard of quality for code contributions, while at the same time managing a large number of contributions, we need contributors to prepare the contributions well, and give reviewers enough contextual information for the review. Please also understand that contributions that do not follow this guide will take longer to review and thus typically be picked up with lower priority by the community.*
## Contribution Checklist
- Make sure that the pull request corresponds to a [JIRA issue](https://issues.apache.org/jira/projects/FLINK/issues). Exceptions are made for typos in JavaDoc or documentation files, which need no JIRA issue.
- Name the pull request in the form "[FLINK-XXXX] [component] Title of the pull request", where *FLINK-XXXX* should be replaced by the actual issue number. Skip *component* if you are unsure about which is the best component.
Typo fixes that have no associated JIRA issue should be named following this pattern: `[hotfix] [docs] Fix typo in event time introduction` or `[hotfix] [javadocs] Expand JavaDoc for PuncuatedWatermarkGenerator`.
- Fill out the template below to describe the changes contributed by the pull request. That will give reviewers the context they need to do the review.
- Make sure that the change passes the automated tests, i.e., `mvn clean verify` passes. You can set up Azure Pipelines CI to do that following [this guide](https://cwiki.apache.org/confluence/display/FLINK/Azure+Pipelines#AzurePipelines-Tutorial:SettingupAzurePipelinesforaforkoftheFlinkrepository).
- Each pull request should address only one issue, not mix up code from multiple issues.
- Each commit in the pull request has a meaningful commit message (including the JIRA id)
- Once all items of the checklist are addressed, remove the above text and this checklist, leaving only the filled out template below.
**(The sections below can be removed for hotfixes of typos)**
-->
## What is the purpose of the change
*(For example: This pull request makes task deployment go through the blob server, rather than through RPC. That way we avoid re-transferring them on each deployment (during recovery).)*
## Brief change log
*(for example:)*
- *The TaskInfo is stored in the blob store on job creation time as a persistent artifact*
- *Deployments RPC transmits only the blob storage reference*
- *TaskManagers retrieve the TaskInfo from the blob cache*
## Verifying this change
*(Please pick either of the following options)*
This change is a trivial rework / code cleanup without any test coverage.
*(or)*
This change is already covered by existing tests, such as *(please describe tests)*.
*(or)*
This change added tests and can be verified as follows:
*(example:)*
- *Added integration tests for end-to-end deployment with large payloads (100MB)*
- *Extended integration test for recovery after master (JobManager) failure*
- *Added test that validates that TaskInfo is transferred only once across recoveries*
- *Manually verified the change by running a 4 node cluser with 2 JobManagers and 4 TaskManagers, a stateful streaming program, and killing one JobManager and two TaskManagers during the execution, verifying that recovery happens correctly.*
## Does this pull request potentially affect one of the following parts:
- Dependencies (does it add or upgrade a dependency): (yes / no)
- The public API, i.e., is any changed class annotated with `@Public(Evolving)`: (yes / no)
- The serializers: (yes / no / don't know)
- The runtime per-record code paths (performance sensitive): (yes / no / don't know)
- Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn/Mesos, ZooKeeper: (yes / no / don't know)
- The S3 file system connector: (yes / no / don't know)
## Documentation
- Does this pull request introduce a new feature? (yes / no)
- If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-678929638
Thanks for your translation @wbgentleman
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733)
* 8bbc06f7a8931c9e02130f668805a82ccc00a9e8 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
}, {
"hash" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8bbc06f7a8931c9e02130f668805a82ccc00a9e8 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738)
* 6b1888c045e829398f3f7a3af98f5ec3378ead51 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 664986884e6e9e1930d48568a4e33b2f36cefe6c Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun closed pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun closed pull request #13188:
URL: https://github.com/apache/flink/pull/13188
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 664986884e6e9e1930d48568a4e33b2f36cefe6c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663)
* 5c37469ec372c4660283677e4984a8c87f5254a9 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8bbc06f7a8931c9e02130f668805a82ccc00a9e8 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 5c37469ec372c4660283677e4984a8c87f5254a9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704)
* 43492c04af59be981162de88a0952dbfc2894ba9 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 5c37469ec372c4660283677e4984a8c87f5254a9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675794133
When will this pull request will be acceptted, or should I do some thing?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474345172
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令 （`mvn`） 首先删除 （`clean`） 所有存在的构建，然后构建一个新的 Flink 运行包 （`install`）。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果想构建一个可用于 pip 安装的 PyFlink 包，需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
-2. Python的版本为3.5, 3.6 或者 3.7.
+2. Python 的版本为 3.5, 3.6 或者 3.7.
```shell
$ python --version
# the version printed here must be 3.5, 3.6 or 3.7
```
-3. 构建PyFlink的Cython扩展模块（可选的）
+3. 构建 PyFlink 的 Cython 扩展模块（可选的）
- 为了构建PyFlink的Cython扩展模块，您需要C编译器。在不同操作系统上安装C编译器的方式略有不同：
+ 为了构建 PyFlink 的 Cython 扩展模块，需要 C 编译器。在不同操作系统上安装 C 编译器的方式略有不同：
- * **Linux** Linux操作系统通常预装有GCC。否则，您需要手动安装。例如，您可以在Ubuntu或Debian上使用命令`sudo apt-get install build-essential`安装。
+ * **Linux** Linux 操作系统通常预装有 GCC。否则，需要手动安装。例如，可以在 Ubuntu 或 Debian 上使用命令`sudo apt-get install build-essential`安装。
- * **Mac OS X** 要在Mac OS X上安装GCC，您需要下载并安装 [Xcode命令行工具](https://developer.apple.com/downloads/index.action)，该工具可在Apple的开发人员页面中找到。
+ * **Mac OS X** 要在 Mac OS X 上安装 GCC，你需要下载并安装 [Xcode 命令行工具](https://developer.apple.com/downloads/index.action
+ )，该工具可在 Apple 的开发人员页面中找到。
- 您还需要使用以下命令安装依赖项：
+ 还需要使用以下命令安装依赖项：
```shell
$ python -m pip install -r flink-python/dev/dev-requirements.txt
```
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
-## Scala Versions
+## Scala 版本
-{% info %} Users that purely use the Java APIs and libraries can *ignore* this section.
+{% info %} 只是用 Java 库和 API 的同学可以 *忽略* 这一部分。
Review comment:
@wuchong possibly all "users" we translate to "用户"?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675793798
@flinkbot approve all
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 43492c04af59be981162de88a0952dbfc2894ba9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723)
* d9e9ce1d0f0500087f60e0ebfaf78b682a146412 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727)
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
}, {
"hash" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5787",
"triggerID" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8bbc06f7a8931c9e02130f668805a82ccc00a9e8 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738)
* 6b1888c045e829398f3f7a3af98f5ec3378ead51 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5787)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473565646
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
Review comment:
Ok, Thank you very much.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 664986884e6e9e1930d48568a4e33b2f36cefe6c UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474344537
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令 （`mvn`） 首先删除 （`clean`） 所有存在的构建，然后构建一个新的 Flink 运行包 （`install`）。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果想构建一个可用于 pip 安装的 PyFlink 包，需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
-2. Python的版本为3.5, 3.6 或者 3.7.
+2. Python 的版本为 3.5, 3.6 或者 3.7.
```shell
$ python --version
# the version printed here must be 3.5, 3.6 or 3.7
```
-3. 构建PyFlink的Cython扩展模块（可选的）
+3. 构建 PyFlink 的 Cython 扩展模块（可选的）
- 为了构建PyFlink的Cython扩展模块，您需要C编译器。在不同操作系统上安装C编译器的方式略有不同：
+ 为了构建 PyFlink 的 Cython 扩展模块，需要 C 编译器。在不同操作系统上安装 C 编译器的方式略有不同：
- * **Linux** Linux操作系统通常预装有GCC。否则，您需要手动安装。例如，您可以在Ubuntu或Debian上使用命令`sudo apt-get install build-essential`安装。
+ * **Linux** Linux 操作系统通常预装有 GCC。否则，需要手动安装。例如，可以在 Ubuntu 或 Debian 上使用命令`sudo apt-get install build-essential`安装。
- * **Mac OS X** 要在Mac OS X上安装GCC，您需要下载并安装 [Xcode命令行工具](https://developer.apple.com/downloads/index.action)，该工具可在Apple的开发人员页面中找到。
+ * **Mac OS X** 要在 Mac OS X 上安装 GCC，你需要下载并安装 [Xcode 命令行工具](https://developer.apple.com/downloads/index.action
+ )，该工具可在 Apple 的开发人员页面中找到。
- 您还需要使用以下命令安装依赖项：
+ 还需要使用以下命令安装依赖项：
```shell
$ python -m pip install -r flink-python/dev/dev-requirements.txt
```
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
Review comment:
```suggestion
*注意:* 运行 `mvn --version` 以查看 Maven 的版本。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wuchong commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473563665
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
Review comment:
Usually, we should use the Chinese characters.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-676941627
@TisonKun @wuchong Please help to review again. Thank you.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474344827
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令 （`mvn`） 首先删除 （`clean`） 所有存在的构建，然后构建一个新的 Flink 运行包 （`install`）。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果想构建一个可用于 pip 安装的 PyFlink 包，需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
-2. Python的版本为3.5, 3.6 或者 3.7.
+2. Python 的版本为 3.5, 3.6 或者 3.7.
```shell
$ python --version
# the version printed here must be 3.5, 3.6 or 3.7
```
-3. 构建PyFlink的Cython扩展模块（可选的）
+3. 构建 PyFlink 的 Cython 扩展模块（可选的）
- 为了构建PyFlink的Cython扩展模块，您需要C编译器。在不同操作系统上安装C编译器的方式略有不同：
+ 为了构建 PyFlink 的 Cython 扩展模块，需要 C 编译器。在不同操作系统上安装 C 编译器的方式略有不同：
- * **Linux** Linux操作系统通常预装有GCC。否则，您需要手动安装。例如，您可以在Ubuntu或Debian上使用命令`sudo apt-get install build-essential`安装。
+ * **Linux** Linux 操作系统通常预装有 GCC。否则，需要手动安装。例如，可以在 Ubuntu 或 Debian 上使用命令`sudo apt-get install build-essential`安装。
- * **Mac OS X** 要在Mac OS X上安装GCC，您需要下载并安装 [Xcode命令行工具](https://developer.apple.com/downloads/index.action)，该工具可在Apple的开发人员页面中找到。
+ * **Mac OS X** 要在 Mac OS X 上安装 GCC，你需要下载并安装 [Xcode 命令行工具](https://developer.apple.com/downloads/index.action
+ )，该工具可在 Apple 的开发人员页面中找到。
- 您还需要使用以下命令安装依赖项：
+ 还需要使用以下命令安装依赖项：
```shell
$ python -m pip install -r flink-python/dev/dev-requirements.txt
```
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
Review comment:
```suggestion
请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html)一节中关于处理 Hadoop 的类和版本问题的方法。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d9e9ce1d0f0500087f60e0ebfaf78b682a146412 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727)
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 664986884e6e9e1930d48568a4e33b2f36cefe6c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-679029328
@TisonKun Thank you very much. Learned lots of thing from you. Thank you again.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wuchong commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473557284
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，你可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果您想构建一个可用于 pip 安装的 PyFlink 包，您需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
Review comment:
Yes. We should use "你". This has been mentioned in the translation specification: https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473560100
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
Review comment:
@wuchong And this one ? Which one should we choose?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-678649387
@TisonKun I have done all the modification. Please check. Thank you.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675836500
> Please refer to https://github.com/sparanoid/chinese-copywriting-guidelines/blob/master/README.zh-CN.md and typesetting the content.
Ok, I will do typesetting quickly. Thank you.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473554057
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，你可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果您想构建一个可用于 pip 安装的 PyFlink 包，您需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
Review comment:
@wuchong Jark please help to make a decission.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5738",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
}, {
"hash" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5787",
"triggerID" : "6b1888c045e829398f3f7a3af98f5ec3378ead51",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 6b1888c045e829398f3f7a3af98f5ec3378ead51 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5787)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675314403
Thanks a lot for your contribution to the Apache Flink project. I'm the @flinkbot. I help the community
to review your pull request. We will use this comment to track the progress of the review.
## Automated Checks
Last check on commit 664986884e6e9e1930d48568a4e33b2f36cefe6c (Tue Aug 18 07:41:30 UTC 2020)
✅no warnings
<sub>Mention the bot in a comment to re-run the automated checks.</sub>
## Review Progress
* ❓ 1. The [description] looks good.
* ❓ 2. There is [consensus] that the contribution should go into to Flink.
* ❓ 3. Needs [attention] from.
* ❓ 4. The change fits into the overall [architecture].
* ❓ 5. Overall code [quality] is good.
Please see the [Pull Request Review Guide](https://flink.apache.org/contributing/reviewing-prs.html) for a full explanation of the review process.<details>
The Bot is tracking the review progress through labels. Labels are applied according to the order of the review items. For consensus, approval by a Flink committer of PMC member is required <summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot approve description` to approve one or more aspects (aspects: `description`, `consensus`, `architecture` and `quality`)
- `@flinkbot approve all` to approve all aspects
- `@flinkbot approve-until architecture` to approve everything until `architecture`
- `@flinkbot attention @username1 [@username2 ..]` to require somebody's attention
- `@flinkbot disapprove architecture` to remove an approval you gave earlier
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-676940732
I have done all the modification accordingly. Thank you very much.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675890942
@TisonKun I have do the typesetting according the materials you offered. Please check. Thank you.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474345363
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令 （`mvn`） 首先删除 （`clean`） 所有存在的构建，然后构建一个新的 Flink 运行包 （`install`）。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果想构建一个可用于 pip 安装的 PyFlink 包，需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
-2. Python的版本为3.5, 3.6 或者 3.7.
+2. Python 的版本为 3.5, 3.6 或者 3.7.
```shell
$ python --version
# the version printed here must be 3.5, 3.6 or 3.7
```
-3. 构建PyFlink的Cython扩展模块（可选的）
+3. 构建 PyFlink 的 Cython 扩展模块（可选的）
- 为了构建PyFlink的Cython扩展模块，您需要C编译器。在不同操作系统上安装C编译器的方式略有不同：
+ 为了构建 PyFlink 的 Cython 扩展模块，需要 C 编译器。在不同操作系统上安装 C 编译器的方式略有不同：
- * **Linux** Linux操作系统通常预装有GCC。否则，您需要手动安装。例如，您可以在Ubuntu或Debian上使用命令`sudo apt-get install build-essential`安装。
+ * **Linux** Linux 操作系统通常预装有 GCC。否则，需要手动安装。例如，可以在 Ubuntu 或 Debian 上使用命令`sudo apt-get install build-essential`安装。
- * **Mac OS X** 要在Mac OS X上安装GCC，您需要下载并安装 [Xcode命令行工具](https://developer.apple.com/downloads/index.action)，该工具可在Apple的开发人员页面中找到。
+ * **Mac OS X** 要在 Mac OS X 上安装 GCC，你需要下载并安装 [Xcode 命令行工具](https://developer.apple.com/downloads/index.action
+ )，该工具可在 Apple 的开发人员页面中找到。
- 您还需要使用以下命令安装依赖项：
+ 还需要使用以下命令安装依赖项：
```shell
$ python -m pip install -r flink-python/dev/dev-requirements.txt
```
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
-## Scala Versions
+## Scala 版本
-{% info %} Users that purely use the Java APIs and libraries can *ignore* this section.
+{% info %} 只是用 Java 库和 API 的同学可以 *忽略* 这一部分。
-Flink has APIs, libraries, and runtime modules written in [Scala](http://scala-lang.org). Users of the Scala API and libraries may have to match the Scala version of Flink with the Scala version of their projects (because Scala is not strictly backwards compatible).
+Flink 有使用 [Scala](http://scala-lang.org) 来写的 API，库和运行时模块。使用 Scala API 和库的同学必须配置 Flink 的 Scala 版本和自己的 Flink 版本（因为 Scala
+并不严格的向后兼容）。
-Since version 1.7 Flink builds with Scala version 2.11 (default) and 2.12.
+从Flink 1.7版本开始，默认使用Scala 2.11（默认）和 2.12 来构建。
Review comment:
```suggestion
从 1.7 版本开始，Flink 可以使用 Scala 2.11（默认）和 2.12 来构建。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 43492c04af59be981162de88a0952dbfc2894ba9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723)
* d9e9ce1d0f0500087f60e0ebfaf78b682a146412 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675890942
@TisonKun I have done the typesetting according the materials you offered. Please check. Thank you.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
}, {
"hash" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "8bbc06f7a8931c9e02130f668805a82ccc00a9e8",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733)
* 8bbc06f7a8931c9e02130f668805a82ccc00a9e8 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 43492c04af59be981162de88a0952dbfc2894ba9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723)
* d9e9ce1d0f0500087f60e0ebfaf78b682a146412 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727)
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474344827
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令 （`mvn`） 首先删除 （`clean`） 所有存在的构建，然后构建一个新的 Flink 运行包 （`install`）。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果想构建一个可用于 pip 安装的 PyFlink 包，需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
-2. Python的版本为3.5, 3.6 或者 3.7.
+2. Python 的版本为 3.5, 3.6 或者 3.7.
```shell
$ python --version
# the version printed here must be 3.5, 3.6 or 3.7
```
-3. 构建PyFlink的Cython扩展模块（可选的）
+3. 构建 PyFlink 的 Cython 扩展模块（可选的）
- 为了构建PyFlink的Cython扩展模块，您需要C编译器。在不同操作系统上安装C编译器的方式略有不同：
+ 为了构建 PyFlink 的 Cython 扩展模块，需要 C 编译器。在不同操作系统上安装 C 编译器的方式略有不同：
- * **Linux** Linux操作系统通常预装有GCC。否则，您需要手动安装。例如，您可以在Ubuntu或Debian上使用命令`sudo apt-get install build-essential`安装。
+ * **Linux** Linux 操作系统通常预装有 GCC。否则，需要手动安装。例如，可以在 Ubuntu 或 Debian 上使用命令`sudo apt-get install build-essential`安装。
- * **Mac OS X** 要在Mac OS X上安装GCC，您需要下载并安装 [Xcode命令行工具](https://developer.apple.com/downloads/index.action)，该工具可在Apple的开发人员页面中找到。
+ * **Mac OS X** 要在 Mac OS X 上安装 GCC，你需要下载并安装 [Xcode 命令行工具](https://developer.apple.com/downloads/index.action
+ )，该工具可在 Apple 的开发人员页面中找到。
- 您还需要使用以下命令安装依赖项：
+ 还需要使用以下命令安装依赖项：
```shell
$ python -m pip install -r flink-python/dev/dev-requirements.txt
```
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
Review comment:
```suggestion
请查看 [Hadoop 集成模块一节]({{ site.baseurl }}/ops/deployment/hadoop.html)中关于处理 Hadoop 的类和版本问题的方法。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] wbgentleman commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
wbgentleman commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r473496456
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
Review comment:
Can we translate shade to "屏蔽"？ @TisonKun @wuchong
`@wbgentleman "properly" here means "正确地"` - Accept
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5727",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
}, {
"hash" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733",
"triggerID" : "8301e1e53770c95e2f903526ac93e80e039cf4f2",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8301e1e53770c95e2f903526ac93e80e039cf4f2 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5733)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-678932212
Thanks for your translation @wbgentleman
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 5c37469ec372c4660283677e4984a8c87f5254a9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704)
* 43492c04af59be981162de88a0952dbfc2894ba9 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5704",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
}, {
"hash" : "43492c04af59be981162de88a0952dbfc2894ba9",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723",
"triggerID" : "43492c04af59be981162de88a0952dbfc2894ba9",
"triggerType" : "PUSH"
}, {
"hash" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "d9e9ce1d0f0500087f60e0ebfaf78b682a146412",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 43492c04af59be981162de88a0952dbfc2894ba9 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5723)
* d9e9ce1d0f0500087f60e0ebfaf78b682a146412 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13188:
URL: https://github.com/apache/flink/pull/13188#issuecomment-675323573
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663",
"triggerID" : "664986884e6e9e1930d48568a4e33b2f36cefe6c",
"triggerType" : "PUSH"
}, {
"hash" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "5c37469ec372c4660283677e4984a8c87f5254a9",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 664986884e6e9e1930d48568a4e33b2f36cefe6c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5663)
* 5c37469ec372c4660283677e4984a8c87f5254a9 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run travis` re-run the last Travis build
- `@flinkbot run azure` re-run the last Azure build
</details>
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r472898345
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
Review comment:
```suggestion
*注意：Maven 3.3.x 可以构建 Flink，但是不能正确地 shade 指定的依赖。Maven 3.2.5 可以正确地构建库文件。
```
@wuchong how to translate "shade"?
@wbgentleman "properly" here means "正确地" IMO, because actually you cannot build Flink with Maven 3.3.x, which will bring some subtle troubles.
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
Review comment:
```suggestion
首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
```
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
Review comment:
```suggestion
还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
```
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -87,64 +88,65 @@ mvn clean install -DskipTests -Dfast
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
-## Scala Versions
+## Scala 版本
-{% info %} Users that purely use the Java APIs and libraries can *ignore* this section.
+{% info %} 只是用 Java 库和 API 的同学可以 *忽略* 这一部分。
-Flink has APIs, libraries, and runtime modules written in [Scala](http://scala-lang.org). Users of the Scala API and libraries may have to match the Scala version of Flink with the Scala version of their projects (because Scala is not strictly backwards compatible).
+Flink 有使用 [Scala](http://scala-lang.org) 来写的 API，库和运行时模块。使用 Scala API 和库的同学必须配置 Flink 的 Scala 版本和自己的 Flink 版本（因为 Scala
+并不严格的向后兼容）。
-Since version 1.7 Flink builds with Scala version 2.11 (default) and 2.12.
+从Flink 1.7版本开始，默认使用Scala 2.11（默认）和 2.12 来构建。
-To build FLink against Scala 2.12, issue the following command:
+如果使用 Scala 2.12 来进行构建，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dscala-2.12
{% endhighlight %}
{% top %}
-## Encrypted File Systems
+## 加密的文件系统
-If your home directory is encrypted you might encounter a `java.io.IOException: File name too long` exception. Some encrypted file systems, like encfs used by Ubuntu, do not allow long filenames, which is the cause of this error.
+如果你的家目录是加密的，可能遇到如下异常 `java.io.IOException: File name too long`。一些像 Ubuntu 的 enfs 的文件系统不支持长文件名，才导致了这个异常的产生。
-The workaround is to add:
+解决方法是添加如下内容
Review comment:
```suggestion
解决方法是添加如下内容到 pom.xml 文件中出现这个错误的模块的编译器配置项下。
```
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
Review comment:
```suggestion
上面的 [Maven](http://maven.apache.org) 指令 (`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建一个新的 Flink 运行包 (`install`)。
```
@wuchong which paren should be used? `()` or `（）`?
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
-To clone from git, enter:
+从 Git 克隆代码，输入：
{% highlight bash %}
git clone {{ site.github_url }}
{% endhighlight %}
-The simplest way of building Flink is by running:
+最简单的构建 Flink 的方法，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests
{% endhighlight %}
-This instructs [Maven](http://maven.apache.org) (`mvn`) to first remove all existing builds (`clean`) and then create a new Flink binary (`install`).
+上面的 [Maven](http://maven.apache.org) 指令，(`mvn`) 首先删除 (`clean`) 所有存在的构建，然后构建 (`install`) 一个新的 Flink 运行包。
-To speed up the build you can skip tests, QA plugins, and JavaDocs:
+为了加速构建，你可以跳过测试，QA 的插件和 JavaDocs 的生成，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dfast
{% endhighlight %}
-## 构建PyFlink
+## 构建 PyFlink
#### 先决条件
-1. 构建Flink
+1. 构建 Flink
- 如果您想构建一个可用于pip安装的PyFlink包，您需要先构建Flink工程，如[构建Flink](#build-flink)中所述。
+ 如果您想构建一个可用于 pip 安装的 PyFlink 包，您需要先构建 Flink 工程，如 [构建 Flink](#build-flink) 中所述。
Review comment:
@wuchong we always use "你" or "您"? IMO "你" is better.
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -87,64 +88,65 @@ mvn clean install -DskipTests -Dfast
#### 安装
-进入Flink源码根目录，并执行以下命令，构建PyFlink的源码发布包和wheel包：
+进入 Flink 源码根目录，并执行以下命令，构建 PyFlink 的源码发布包和 wheel 包：
{% highlight bash %}
cd flink-python; python setup.py sdist bdist_wheel
{% endhighlight %}
-构建好的源码发布包和wheel包位于`./flink-python/dist/`目录下。它们均可使用pip安装,比如:
+构建好的源码发布包和 wheel 包位于`./flink-python/dist/`目录下。它们均可使用 pip 安装，比如:
{% highlight bash %}
python -m pip install dist/*.tar.gz
{% endhighlight %}
-## Dependency Shading
+## 依赖屏蔽
-Flink [shades away](https://maven.apache.org/plugins/maven-shade-plugin/) some of the libraries it uses, in order to avoid version clashes with user programs that use different versions of these libraries. Among the shaded libraries are *Google Guava*, *Asm*, *Apache Curator*, *Apache HTTP Components*, *Netty*, and others.
+Flink [依赖屏蔽](https://maven.apache.org/plugins/maven-shade-plugin/) 一些它使用的包，这样做是为了避免与程序员自己引入的包的存在的可能的版本冲突。屏蔽掉的包包括 *Google Guava*,*Asm*,*Apache Curator*,*Apache HTTP Components*,*Netty* 等。
-The dependency shading mechanism was recently changed in Maven and requires users to build Flink slightly differently, depending on their Maven version:
+这种依赖屏蔽机制最近在 Maven 中有所改变。需要用户根据 Maven 的的不同版本来执行不同的命令。
-**Maven 3.1.x and 3.2.x**
-It is sufficient to call `mvn clean install -DskipTests` in the root directory of Flink code base.
+**对于Maven 3.1.x and 3.2.x**
+直接在 Flink 源码根目录执行命令 `mvn clean install -DskipTests` 就足够了。
**Maven 3.3.x**
-The build has to be done in two steps: First in the base directory, then in the distribution project:
+如下的构建需要两步走：第一步需要在基础目录下执行编译构建；第二步需要在编译后的 flink-dist 目录下执行：
{% highlight bash %}
mvn clean install -DskipTests
cd flink-dist
mvn clean install
{% endhighlight %}
-*Note:* To check your Maven version, run `mvn --version`.
+*注意:* 查看 Maven 的版本，执行 `mvn --version`.
{% top %}
-## Hadoop Versions
+## Hadoop 版本
-Please see the [Hadoop integration section]({{ site.baseurl }}/ops/deployment/hadoop.html) on how to handle Hadoop classes and versions.
+请查看 [Hadoop 集成模块]({{ site.baseurl }}/ops/deployment/hadoop.html) 来处理 Hadoop 的类和版本问题。
-## Scala Versions
+## Scala 版本
-{% info %} Users that purely use the Java APIs and libraries can *ignore* this section.
+{% info %} 只是用 Java 库和 API 的同学可以 *忽略* 这一部分。
-Flink has APIs, libraries, and runtime modules written in [Scala](http://scala-lang.org). Users of the Scala API and libraries may have to match the Scala version of Flink with the Scala version of their projects (because Scala is not strictly backwards compatible).
+Flink 有使用 [Scala](http://scala-lang.org) 来写的 API，库和运行时模块。使用 Scala API 和库的同学必须配置 Flink 的 Scala 版本和自己的 Flink 版本（因为 Scala
+并不严格的向后兼容）。
-Since version 1.7 Flink builds with Scala version 2.11 (default) and 2.12.
+从Flink 1.7版本开始，默认使用Scala 2.11（默认）和 2.12 来构建。
-To build FLink against Scala 2.12, issue the following command:
+如果使用 Scala 2.12 来进行构建，执行如下命令：
{% highlight bash %}
mvn clean install -DskipTests -Dscala-2.12
{% endhighlight %}
{% top %}
-## Encrypted File Systems
+## 加密的文件系统
-If your home directory is encrypted you might encounter a `java.io.IOException: File name too long` exception. Some encrypted file systems, like encfs used by Ubuntu, do not allow long filenames, which is the cause of this error.
+如果你的家目录是加密的，可能遇到如下异常 `java.io.IOException: File name too long`。一些像 Ubuntu 的 enfs 的文件系统不支持长文件名，才导致了这个异常的产生。
Review comment:
```suggestion
如果你的 home 目录是加密的，可能遇到如下异常 `java.io.IOException: File name too long`。一些像 Ubuntu 的 enfs 这样的加密文件系统因为不支持长文件名会产生这个异常。
```
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -153,7 +155,7 @@ The workaround is to add:
</args>
{% endhighlight %}
-in the compiler configuration of the `pom.xml` file of the module causing the error. For example, if the error appears in the `flink-yarn` module, the above code should be added under the `<configuration>` tag of `scala-maven-plugin`. See [this issue](https://issues.apache.org/jira/browse/FLINK-2003) for more information.
+到 pom.xml 文件中引起这个错误的编译器的配置项下。例如，如果错误出现在 `flink-yarn` 模块下，上述的代码需要添加到 `scala-maven-plugin` 的 `<configuration>` 项下。请查看 [这个问题](https://issues.apache.org/jira/browse/FLINK-2003) 的链接获取更多信息。
Review comment:
```suggestion
例如，如果错误出现在 `flink-yarn` 模块下，上述的代码需要添加到 `scala-maven-plugin` 的 `<configuration>` 项下。请查看[这个问题](https://issues.apache.org/jira/browse/FLINK-2003)的链接获取更多信息。
```
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
Review comment:
as below I think phrase like "依赖屏蔽" should be ok.
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
+如果运行单元，则需要 Java 8u51 以上的版本来去掉PowerMock运行器带来的单元测试失败情况。
Review comment:
```suggestion
运行单元测试需要 Java 8u51 以上的版本来避免使用 PowerMock Runner 的单元测试失败。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474344108
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,129 +22,132 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备源码。可以 [从发布版本下载源码]({{ site.download_url }})或者 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备 **Maven 3** 和 **JDK** (Java开发套件)。Flink 依赖 **Java 8** 或更新的版本来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
To build unit tests use Java 8u51 or above to prevent failures in unit tests that use the PowerMock runner.*
Review comment:
Missing removed English content?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] TisonKun commented on a change in pull request #13188: [hotfix][docs] Translate building.md to building.zh.md
Posted by GitBox <gi...@apache.org>.
TisonKun commented on a change in pull request #13188:
URL: https://github.com/apache/flink/pull/13188#discussion_r474343892
##########
File path: docs/flinkDev/building.zh.md
##########
@@ -22,62 +22,63 @@ specific language governing permissions and limitations
under the License.
-->
-This page covers how to build Flink {{ site.version }} from sources.
+本篇主题是如何从版本 {{ site.version }} 的源码构建 Flink。
* This will be replaced by the TOC
{:toc}
-## Build Flink
+## 构建 Flink
-In order to build Flink you need the source code. Either [download the source of a release]({{ site.download_url }}) or [clone the git repository]({{ site.github_url }}).
+首先需要准备一份源码。有两种方法：第一种参考 [从发布版本下载源码]({{ site.download_url }})；第二种参考 [从 Git 库克隆 Flink 源码]({{ site.github_url }})。
-In addition you need **Maven 3** and a **JDK** (Java Development Kit). Flink requires **at least Java 8** to build.
+还需要准备，**Maven 3** 和 **JDK** (Java开发套件)。Flink至少依赖 **Java 8** 来进行构建。
-*NOTE: Maven 3.3.x can build Flink, but will not properly shade away certain dependencies. Maven 3.2.5 creates the libraries properly.
+*注意：Maven 3.3.x 可以构建 Flink，但是不会去掉指定的依赖。Maven 3.2.5 可以很好地构建对应的库文件。
Review comment:
Can we translate shade to "屏蔽"？ - Good to me.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org