You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@twill.apache.org by ch...@apache.org on 2016/10/05 21:42:46 UTC
[52/52] twill git commit: Update site for 0.8.0 release
Update site for 0.8.0 release
Project: http://git-wip-us.apache.org/repos/asf/twill/repo
Commit: http://git-wip-us.apache.org/repos/asf/twill/commit/c852eb67
Tree: http://git-wip-us.apache.org/repos/asf/twill/tree/c852eb67
Diff: http://git-wip-us.apache.org/repos/asf/twill/diff/c852eb67
Branch: refs/heads/site
Commit: c852eb67b21ee279e425187f645a196e1771ef1e
Parents: 9ea6dac
Author: Terence Yim <ch...@apache.org>
Authored: Tue Oct 4 10:48:17 2016 -0700
Committer: Terence Yim <ch...@apache.org>
Committed: Wed Oct 5 14:41:45 2016 -0700
----------------------------------------------------------------------
src/site/markdown/GettingStarted.md | 14 ++--
src/site/markdown/ReleaseGuide.md | 5 +-
src/site/markdown/index.md | 4 +-
src/site/markdown/releases/0.5.0-incubating.md | 61 -----------------
src/site/markdown/releases/0.6.0-incubating.md | 74 ---------------------
src/site/markdown/releases/0.8.0.md | 63 ++++++++++++++++++
src/site/site.xml | 8 +--
7 files changed, 79 insertions(+), 150 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/GettingStarted.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/GettingStarted.md b/src/site/markdown/GettingStarted.md
index ba8d5de..00d7f1b 100644
--- a/src/site/markdown/GettingStarted.md
+++ b/src/site/markdown/GettingStarted.md
@@ -28,7 +28,7 @@ For your application module
<dependency>
<groupId>org.apache.twill</groupId>
<artifactId>twill-api</artifactId>
- <version>0.7.0-incubating</version>
+ <version>0.8.0</version>
</dependency>
```
@@ -38,7 +38,7 @@ For the your Apache Twill YARN client module
<dependency>
<groupId>org.apache.twill</groupId>
<artifactId>twill-yarn</artifactId>
- <version>0.7.0-incubating</version>
+ <version>0.8.0</version>
</dependency>
```
@@ -116,7 +116,7 @@ to create an instance of `TwillRunnerService`:
```java
TwillRunnerService runnerService = new YarnTwillRunnerService(
new YarnConfiguration(), zkConnectStr);
-runnerService.startAndWait();
+runnerService.start();
```
Now you are read to run the EchoServer on YARN, by simply preparing and starting through the `TwillRunnerService`. You
@@ -143,7 +143,7 @@ controller.addListener(new ListenerAdapter() {
You can also stop the application through the `TwillController`:
```java
-controller.stop().get();
+controller.terminate().get();
```
This will shut down the application master and all the containers.
@@ -170,7 +170,7 @@ You can run the HelloWorld application from any node of the Hadoop cluster using
(be sure to add your ZooKeeper Host and Port):
```sh
-$ export CP=twill-examples-yarn-0.7.0-incubating-SNAPSHOT.jar:`hadoop classpath`
+$ export CP=twill-examples-yarn-0.8.0.jar:`hadoop classpath`
$ java -cp $CP org.apache.twill.example.yarn.HelloWorld {zookeeper_host:port}
```
@@ -193,9 +193,9 @@ You can run the BundleJarExample application from any node of the Hadoop cluster
(be sure to add your ZooKeeper Host and Port):
```sh
-$ export CP=twill-examples-yarn-0.7.0-incubating-SNAPSHOT.jar:`hadoop classpath`
+$ export CP=twill-examples-yarn-0.8.0.jar:`hadoop classpath`
$ java -cp $CP org.apache.twill.example.yarn.BundledJarExample {zookeeper_host:port} \
- twill-examples-echo-0.7.0-incubating-SNAPSHOT.jar echo.EchoMain arg1
+ twill-examples-echo-0.8.0.jar echo.EchoMain arg1
```
Like with the HelloWorld example, you should see logs output to the terminal. Once the application is complete, check
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/ReleaseGuide.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/ReleaseGuide.md b/src/site/markdown/ReleaseGuide.md
index 86253ab..3d37c59 100644
--- a/src/site/markdown/ReleaseGuide.md
+++ b/src/site/markdown/ReleaseGuide.md
@@ -173,7 +173,10 @@ ${RELEASE_VERSION} passed with n binding +1s and no 0 or -1.
Binding +1s:
[BINDING_+1_NAMES]
-I am going to create a vote in the general@ list.
+Non-binding +1s
+[NON_BINDING_+1_NAMES]
+
+This release vote has passed. Thanks everyone for voting.
Thanks,
[YOUR_NAME]
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/index.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index fe34a8d..f1ceab4 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -43,8 +43,8 @@ Hadoop� cluster.
### Latest Release
-The latest release of Apache Twill is [0.7.0-incubating](releases/0.7.0-incubating.html).
-Please go to the [release](releases/0.7.0-incubating.html) page
+The latest release of Apache Twill is [0.8.0](releases/0.8.0.html).
+Please go to the [release](releases/0.8.0.html) page
to find out more.
### Is it Building?
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.5.0-incubating.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/releases/0.5.0-incubating.md b/src/site/markdown/releases/0.5.0-incubating.md
deleted file mode 100644
index debee40..0000000
--- a/src/site/markdown/releases/0.5.0-incubating.md
+++ /dev/null
@@ -1,61 +0,0 @@
-<!--
- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-
-<head>
- <title>Apache Twill Release 0.5.0-incubating</title>
-</head>
-
-### Release Notes - Apache Twill - 0.5.0-incubating
-
-#### New Features:
- * [TWILL-111](https://issues.apache.org/jira/browse/TWILL-111) Support MapR File System
- * [TWILL-115](https://issues.apache.org/jira/browse/TWILL-115) Add support to submit jobs to non-default YARN queue
- * [TWILL-118](https://issues.apache.org/jira/browse/TWILL-118) Added support for distributed lock
-
-#### Bug fixes:
- * [TWILL-61](https://issues.apache.org/jira/browse/TWILL-61) Second launch attempt of AM always failed
- * [TWILL-80](https://issues.apache.org/jira/browse/TWILL-80) Logs not available when the runnable failed at initialize or only runs momentarily
- * [TWILL-100](https://issues.apache.org/jira/browse/TWILL-100) Fix examples poms
- * [TWILL-108](https://issues.apache.org/jira/browse/TWILL-108) Not to fail with exception if the same jar file has been added twice during creation of bundle jar
- * [TWILL-110](https://issues.apache.org/jira/browse/TWILL-110) Deadlock when shutting down runnable container
-
-### Project dependencies
-
-#### Maven
-For your application module
-
-```xml
-<dependency>
- <groupId>org.apache.twill</groupId>
- <artifactId>twill-api</artifactId>
- <version>0.5.0-incubating</version>
-</dependency>
-```
-
-For the your Apache Twill YARN client module
-
-```xml
-<dependency>
- <groupId>org.apache.twill</groupId>
- <artifactId>twill-yarn</artifactId>
- <version>0.5.0-incubating</version>
-</dependency>
-```
-
-### Source tar-ball download
-[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.5.0-incubating/src)
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.6.0-incubating.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/releases/0.6.0-incubating.md b/src/site/markdown/releases/0.6.0-incubating.md
deleted file mode 100644
index 2e8ff6a..0000000
--- a/src/site/markdown/releases/0.6.0-incubating.md
+++ /dev/null
@@ -1,74 +0,0 @@
-<!--
- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-
-<head>
- <title>Apache Twill Release 0.6.0-incubating</title>
-</head>
-
-### Release Notes - Apache Twill - 0.6.0-incubating
-
-#### New Features:
- * [TWILL-116](https://issues.apache.org/jira/browse/TWILL-116) Support for restart instances of runnable in an application
- * [TWILL-117](https://issues.apache.org/jira/browse/TWILL-117) MapR extension
- * [TWILL-130](https://issues.apache.org/jira/browse/TWILL-130) Remove support for Java 6
-
-#### Improvements:
- * [TWILL-24](https://issues.apache.org/jira/browse/TWILL-24) log level should be settable
- * [TWILL-69](https://issues.apache.org/jira/browse/TWILL-69) Remove guava dependencies on the twill-api and twill-common modules
- * [TWILL-83](https://issues.apache.org/jira/browse/TWILL-83) distribute YarnTestUtils for easier downstream testing
- * [TWILL-112](https://issues.apache.org/jira/browse/TWILL-112) Improve ApplicationBundler performance
- * [TWILL-126](https://issues.apache.org/jira/browse/TWILL-126) Update Travis CI configuration to support caching Maven downloads
- * [TWILL-128](https://issues.apache.org/jira/browse/TWILL-128) Change the ZKBrokerService to be public so it could be used outside the package
- * [TWILL-135](https://issues.apache.org/jira/browse/TWILL-135) Update the pom.xml to get Java7 API link and update copyright year
- * [TWILL-137](https://issues.apache.org/jira/browse/TWILL-137) Be able to get log level for each runnable via TwillController.getResourceReport
-
-#### Bug fixes:
- * [TWILL-120](https://issues.apache.org/jira/browse/TWILL-120) Java 8 applications causing exceptions
- * [TWILL-121](https://issues.apache.org/jira/browse/TWILL-121) Do not know which class TwillLauncher was trying to launch
- * [TWILL-125](https://issues.apache.org/jira/browse/TWILL-125) BundledJarRunner doesn't work for classes with no zero-args constructor
- * [TWILL-127](https://issues.apache.org/jira/browse/TWILL-127) The link for API doc for 0.6 release returns 404
- * [TWILL-129](https://issues.apache.org/jira/browse/TWILL-129) Race condition in leader election if leader quitted before follower set the watch
- * [TWILL-133](https://issues.apache.org/jira/browse/TWILL-133) ZookeeperClientService may hang at startup and then cannot be stopped
- * [TWILL-136](https://issues.apache.org/jira/browse/TWILL-136) Override equals and hashCode for JvmOptions.DebugOptions to test equality
- * [TWILL-139](https://issues.apache.org/jira/browse/TWILL-139) ApplicationMaster hangs during start when ZooKeeper SASL authentication is turned on
-
-### Project dependencies
-
-#### Maven
-For your application module
-
-```xml
-<dependency>
- <groupId>org.apache.twill</groupId>
- <artifactId>twill-api</artifactId>
- <version>0.6.0-incubating</version>
-</dependency>
-```
-
-For the your Apache Twill YARN client module
-
-```xml
-<dependency>
- <groupId>org.apache.twill</groupId>
- <artifactId>twill-yarn</artifactId>
- <version>0.6.0-incubating</version>
-</dependency>
-```
-
-### Source tar-ball download
-[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.6.0-incubating/src)
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.8.0.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/releases/0.8.0.md b/src/site/markdown/releases/0.8.0.md
new file mode 100644
index 0000000..f686396
--- /dev/null
+++ b/src/site/markdown/releases/0.8.0.md
@@ -0,0 +1,63 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<head>
+ <title>Apache Twill Release 0.8.0</title>
+</head>
+
+### Release Notes - Apache Twill - 0.8.0
+
+#### Improvements:
+ * [TWILL-107](https://issues.apache.org/jira/browse/TWILL-107) Support payloads for Discoverables
+ * [TWILL-167](https://issues.apache.org/jira/browse/TWILL-167) Add toString() to FileContextLocation
+ * [TWILL-184](https://issues.apache.org/jira/browse/TWILL-184) Allow user to disable the SecureStoreUpdater in Twill
+ * [TWILL-188](https://issues.apache.org/jira/browse/TWILL-188) LocationFactory should have options to accept permission for create
+
+#### Bug fixes:
+ * [TWILL-163](https://issues.apache.org/jira/browse/TWILL-163) LocationFactory.getHomeLocation method returns home location of the user running the application instead of the user that owns the hdfs directories.
+ * [TWILL-173](https://issues.apache.org/jira/browse/TWILL-173) Application Master failed with BindException occasionally
+ * [TWILL-175](https://issues.apache.org/jira/browse/TWILL-175) Hadoop21YarnAppClient caches a YarnClient
+ * [TWILL-177](https://issues.apache.org/jira/browse/TWILL-177) ZKDiscoveryService should have a way to remove its connection watcher
+ * [TWILL-182](https://issues.apache.org/jira/browse/TWILL-182) ApplicationBundler will overwrite dependencies with identical names
+ * [TWILL-190](https://issues.apache.org/jira/browse/TWILL-190) Restart of a TwillRunnable does not wait for the runnable to stop
+
+### Project dependencies
+
+#### Maven
+For your application module
+
+```xml
+<dependency>
+ <groupId>org.apache.twill</groupId>
+ <artifactId>twill-api</artifactId>
+ <version>0.8.0</version>
+</dependency>
+```
+
+For the your Apache Twill YARN client module
+
+```xml
+<dependency>
+ <groupId>org.apache.twill</groupId>
+ <artifactId>twill-yarn</artifactId>
+ <version>0.8.0</version>
+</dependency>
+```
+
+### Source tar-ball download
+[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.8.0/src)
http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 2ac0850..0d4a86a 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -51,16 +51,14 @@
<menu name="Documentation">
<item name="Getting Started" href="./GettingStarted.html"/>
- <item name="API (0.8.0-SNAPSHOT)" href="./apidocs/index.html"/>
+ <item name="API (0.9.0-SNAPSHOT)" href="./apidocs/index.html"/>
+ <item name="API (0.8.0)" href="./apidocs-0.8.0/index.html"/>
<item name="API (0.7.0-incubating)" href="./apidocs-0.7.0-incubating/index.html"/>
- <item name="API (0.6.0-incubating)" href="./apidocs-0.6.0-incubating/index.html"/>
- <item name="API (0.5.0-incubating)" href="./apidocs-0.5.0-incubating/index.html"/>
</menu>
<menu name="Releases">
+ <item name="0.8.0" href="./releases/0.8.0.html"/>
<item name="0.7.0-incubating" href="./releases/0.7.0-incubating.html"/>
- <item name="0.6.0-incubating" href="./releases/0.6.0-incubating.html"/>
- <item name="0.5.0-incubating" href="./releases/0.5.0-incubating.html"/>
</menu>
<menu name="Get Involved">